Skip to main content
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 Details

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

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.
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.
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.
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.
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.
object
User Information - User identifiers and browser information for enhanced matching and attribution.
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.
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