Skip to content
sandadocs
Console Start free trial

TikTok Marketing

Connect TikTok Marketing to sanda: what to prepare, the fields the connection form asks for, and how its data lands in your warehouse.

View as Markdown

Connect TikTok Marketing

  1. Open the catalogue. In the console, go to Data · Connections and press New connection.
  2. Choose TikTok Marketing. It is listed under marketing and analytics; you can also search for it by name.
  3. Fill in the form. Enter the fields below. Credentials go straight to sanda’s sync engine and are never stored in sanda’s database.
  4. Choose what to sync. Pick the streams you want, and a sync mode for each. See choose what to sync.
  5. Run the first sync. sanda tests the connection, then lands each stream as a table in your warehouse.

Configuration fields

What the connection form asks for. Required fields are marked; the rest are optional.

Field Type Required Description
Authentication Method one of 2 options No
Replication Start Date string No The Start Date in format: YYYY-MM-DD. Any data before this date will not be replicated. If this parameter is not set, all data will be replicated. Default 2016-09-01.
End Date string No The date until which you'd like to replicate data for all incremental streams, in the format YYYY-MM-DD. All data generated between start_date and this date will be replicated. Not setting this option will result in always syncing the data till the current date.
Attribution Window integer No The attribution window in days. Default 3.
Daily Reports Date Step integer No The number of days per API request for daily report streams. Use the default 30 for most accounts. If syncs fail with TikTok API error 40067 ("query too large"), reduce this value (e.g., 7 or 1). Smaller values make more API requests but avoid query size limits for accounts with many ads. Default 30.
Include Deleted Data in Reports and Ads, Ad Groups and Campaign streams. boolean No Set to active if you want to include deleted data in report based streams and Ads, Ad Groups and Campaign streams. Default false.

Authentication Method

Choose one of the following. Each asks for its own fields.

OAuth2.0

Field Type Required Description
Access Token string, secret Yes Long-term Authorized Access Token.
Advertiser ID string No The Advertiser ID to filter reports and streams. Let this empty to retrieve all.
App ID string, secret Yes The Developer Application App ID.
Secret string, secret Yes The Developer Application Secret.

Sandbox Access Token

Field Type Required Description
Access Token string, secret Yes The long-term authorized access token.
Advertiser ID string Yes The Advertiser ID which generated for the developer's Sandbox application.

Something unclear or out of date? Tell us, and we will fix the page.