Skip to main content
TikTok
Credentials OneView lets you connect your TikTok account with OAuth, and will automatically handle all token updates for you in the background. You are not required to create a TikTok Ads app.To access this integration, you’ll need a TikTok for Business account with appropriate access permissions.
TikTok for Business is configured as a Conversion API integration in OneView. OneView automatically sends conversion data to TikTok for Business's API for campaign optimization.OneView automatically handles data mapping, routing rules, and API communication with TikTok for Business. You simply need to select your Conversion Events on OneView, and OneView will take care of the rest.

​
What gets sent to TikTok for Business

​
conversion_date_time
string
required
Conversion Timestamp - The date and time when the conversion occurred.OneView automatically converts timestamps to the timezone of your TikTok for Business account for accurate cross-dashboard reporting comparisons.
​
transaction_id
string
Transaction ID - Unique identifier for idempotency and deduplication.OneView automatically uses the Idempotency-Key of your event as the Event ID, or, if absent, generates a one based on the event payload.
​
consent
object
Consent Information - Consent information for the conversion, using the Google Consent Mode framework.OneView automatically sets consent information using the Google Consent Mode framework, with ad_user_data and ad_personalization values to enforce consent compliance.

​
Conversion Details

OneView automatically processes conversions through deduplication and attribution before sending them to TikTok for Business.

​
event
string
required
Event Type - The type of conversion event being sent to TikTok for Business.
OneView automatically maps your conversion events to TikTok’s event types based on your webhook configuration.
​
event_id
string
required
Event ID - Unique identifier for idempotency and deduplication.
OneView automatically uses the Idempotency-Key of your event as the Event ID, or, if absent, generates a one based on the event payload.
​
event_time
integer
required
Event Timestamp - The Unix timestamp (in seconds) when the conversion occurred.
OneView automatically converts timestamps to Unix timestamp format (seconds) for TikTok for Business API compatibility.
​
limited_data_use
boolean
Limited Data Use - Indicates whether the event should be processed with limited data use restrictions.
OneView automatically sets this field based on your consent configuration. When ad_user_data consent is GRANTED, limited_data_use is set to false. Otherwise, it’s set to true to comply with privacy regulations.
​
page.url
string
required
Page URL - The URL of the page where the conversion occurred.
OneView automatically includes the page location from your event’s session data.
​
user
object
User Information - User identifiers and browser information for enhanced matching and attribution.
​
event_source
string
required
Event Source - The source type of the event (e.g., WEB, APP).
OneView automatically sets this based on your webhook configuration’s event source type.
​
event_source_id
string
required
Event Source ID - Your TikTok Pixel ID.
OneView automatically uses the pixel ID from your webhook configuration.

​
TikTok for Business-Specific Details

​
Enhanced Conversions

TikTok for Business supports enhanced conversions using hashed PII (email, phone, external ID) for better matching and attribution. OneView automatically includes these identifiers when:
  • PII handling mode is set to hashed
  • User consent for ad_user_data is GRANTED
  • Identifiers are available from your Identity Graph
Make sure you align your Privacy Policy to ensure regulatory compliance concerning the re-identification of users when using enhanced conversions.
OneView automatically enforces consent compliance by setting limited_data_use based on your consent configuration. When consent is not granted, TikTok for Business will process the event with limited data use restrictions.

​
Troubleshooting

Revoking access will stop OneView from sending conversions to your TikTok for Business account.
You need to revoke access to your TikTok for Business data on both ends:
  1. From OneView: Navigate to Ad Accounts settings and disconnect your TikTok for Business account.
  2. From TikTok for Business: Use your dashboard at (https://ads.tiktok.com/ac/page/authorizations) and remove OneView Platform from your account.