TikTok Ads
Upload Custom Audiences to TikTok Ads for targeted advertising. Sync your warehouse segments to TikTok for precise audience targeting.
Prerequisites
- A TikTok Business Center account
- Your TikTok Ads Advertiser ID
- Access to the TikTok Marketing API
Authentication
TikTok Ads uses OAuth 2.0 via TikTok Business Center.
- Click Connect with OAuth in Zeotap
- Sign in with your TikTok Business account
- Authorize the requested permissions
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Advertiser ID | Text | Yes | Your TikTok Ads advertiser ID (numeric). Example: 7012345678901234567 |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Audience Name | Text | Yes | Name for the Custom Audience |
| Audience ID | Text | No | Existing Custom Audience ID. Leave blank to create a new audience. |
Supported Operations
Sync Modes: Upsert, Mirror
Audience Sync Modes: Add, Remove, Mirror, Upsert
Features
- Field Mapping: No
- Schema Introspection: No
Match Keys
TikTok matches Custom Audience members on hashed identifiers. Map raw columns and Zeotap normalizes and hashes them at delivery, or map pre-hashed SHA-256 hex digests directly:
| Field | Type | Description |
|---|---|---|
email | string | Raw email address — lowercased, trimmed, and SHA-256 hashed before upload |
hashed_email | string | Pre-hashed SHA-256 hex digest of the lowercase, trimmed email |
phone | string | Raw phone number — normalized to E.164 (digits with leading +) and SHA-256 hashed before upload |
hashed_phone | string | Pre-hashed SHA-256 hex digest of the E.164 phone number |
When both a raw field and its pre-hashed counterpart are mapped, the pre-hashed value wins. Values that are not valid 64-character hex digests are never uploaded — they are dropped (falling back to the raw column if mapped) and counted in the sync run logs. See Match Keys & Identifier Hashing for the full normalization contract, precedence, and validation rules.
Troubleshooting
Advertiser ID not found
Verify your Advertiser ID in TikTok Ads Manager. It is displayed in the account settings.
Audience upload failed
Ensure the data contains valid identifiers (email addresses, phone numbers, or advertising IDs). TikTok requires hashed data for audience matching.