Ingest Data

Send product events and identity updates to Altertable with SDKs or direct HTTP requests. The same payload model writes to the built-in product_analytics catalog, so client, server, mobile, and batch sources can be analyzed together.

SDK quick start

Product Analytics SDKs follow the same mental model across languages:

1. Initialize a client with your API key.
2. Track events with event properties.
3. Identify users and attach traits.
4. Optionally alias related identities.

SDK examples

Use these examples as the starting point for your application code:

TypeScriptReactPythonRubySwiftKotlin

Copy

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

import { altertable } from '@altertable/altertable-js';

// Initialize with your API key
altertable.init('YOUR_API_KEY', {
  environment: 'production',
});

// Track a user event
altertable.track('checkout_completed', {
  revenue: 49.99,
  plan: 'pro',
  currency: 'USD',
});

// Identify a user
altertable.identify('user_abc123', {
  email: '[email protected]',
  plan: 'pro',
});

Client-side vs server-side SDKs

SDKs fall into two categories with different capabilities:

Page, screen, and consent helpers

Client-side SDKs can automatically capture page views or screen views:

TypeScriptSwiftKotlin

Copy

1

2

3

4

5

// Disable auto-capture if you need manual control
altertable.init('YOUR_API_KEY', { autoCapture: false });

// Then track page views manually
altertable.page('https://example.com/products');

They also include built-in consent management for privacy compliance:

TypeScriptSwiftKotlin

Copy

1

2

3

4

5

// JavaScript — initialize with consent pending
altertable.init('YOUR_API_KEY', { trackingConsent: 'pending' });

// Later, when the user grants consent
altertable.configure({ trackingConsent: 'granted' });