TikTok Ads campaign configuration

At a glance: TikTok Ads (bytedanceglobal_int), an Appflyer integrated partner, provides app owners with click attribution.

Bytedance platform for China traffic, Ocean Engine Ads (bytedance_int)

Setting up TikTok Ads integration

Appsflyer integration with TikTok Ads supports click attribution, cost, ad revenue and audiences.

To access TikTok Ads settings:

  1. Go to Configuration > Integrated partners
  2. Search for and select TikTok Ads.
  3. Update settings (per tab) as required. See the Setting tabs sections.

Setting tabs

Update setting tab content as required.

Integration

Configure this section if TikTok Ads provides ad network advertising services.

Activate partner

The Activate partner must be enabled for as long as you work with the partner. 

To enable integration:

  1. Enable Activate Partner.
  2. [Optional] Enable View-Through attribution. The view-through window is set using the attribution link.
  3. AppsFlyer sends postbacks to TikTok Ads following user installs. Select an option from:
    • Only events attributed to this partner for events coming only from users attributed to TikTok Ads.
    • Events attributed to any partner or organic to report all installs to TikTok Ads. Meaning that TikTok Ads have information about your entire user base.
  4. [Optional] To send in-app event postbacks to TikTok Ads:
    • Enable in-app event postbacks 
    • [Optional] Set the in-app event postback window.
    • Select the Sending Option for SDK defined events:
      • Only events attributed to this partner for events coming only from users attributed to this partner
      •  Events attributed to any partner or organic to have your entire user base available to be reported to the partner
    • Click Add Event to add an SDK Event to the list. The table that follows describes the fields you need to complete. 
  5. Click Save Integration
Parameter Name Description
SDK Event Name The name of the event, as received by AppsFlyer either from the SDK integrated in your app, or from server to server events.
Tip - If you don't see the event you want in the list, make sure to activate the event on a device with a non-organic installation and recheck.
Partner Event Identifier The unique name or ID of each event as defined on TikTok Ads' side. Select the most suitable name from the dropdown list.
Send Revenue When selected: AppsFlyer sends all the parameters of the rich in-app event to the partner, except for the revenue parameter, which is contained in the af_revenue parameter.
When not selected: AppsFlyer sends all the parameters including the revenue value (if it exists in the event).

Here is the full list of TikTok Ads' Event Identifiers:

Event Name Event Meaning (EN)
Registration User registers
Pay(Purchase) User completes a Purchase transaction
View_content User views content
Checkout User checksout
Add_to_cart User adds product to cart
2D_retention User is retained for the second day after app installation
Unlock_achievement User unlocks an acheievement (e.g. in a game, reaches a spend milestone)
Subscribe User subscribes
Start_trial User starts a trial
Spend_credits User spends points/credits earned (e.g. Loyalty points)
Search User searches for a product
Rate User rates a product
Login User logs into the app
Loan_disbursal User is disbursed the loan amount
Loan_approval User's loan application gets approved
Loan_application User applies for Loan
Achieve_level User completes a level (e.g. in a game)
Join_group User joins a group
InApp_ad_impr User views an impression
InApp_ad_click User clicks on an ad
Generate_lead User expresses interest in a product (lead generation)
Create_role User creates a role
Create_group User creates a group (e.g. group on PubG, group on WhatsApp)
Complete_tutorial User completes a turtorial
Launch_app User launches the app
Add_to_wishlist User adds product to wishlist
Add_payment_info User adds payment information

 

Attribution link 

Generate click attribution links (for use by TikTok Ads). More about link structure and parameters.

To generate an attribution link:

  1. Select a parameter from the Parameter name list and set its Value to the TikTok Ads parameters name detailed in the table that follows.
  2. Click Add parameter and repeat the preceding step to add more parameters.
  3. Set the duration of the click-through lookback windowDefault 7 days.
  4. Set the duration of the view-through lookback windowDefault 1 day.
  5. Copy the click-attribution link and send it to TikTok Ads.
    Note: AppsFlyer does not save links.
Paramater mapping

AppsFlyer 

TikTok Ads

af_siteid

__CSITE__

af_channel

__PLACEMENT__

c

__CAMPAIGN_NAME__

af_c_id

__CAMPAIGN_ID__

af_adset

__AID_NAME__

af_adset_id

__AID__

af_ad

__CID_NAME__

af_ad_id

__CID__

af_ad_type

__CTYPE__

Impressions attribution link

The impression attribution link contains similar attribution data to the click recording link (besides the different lookback window). Send it to TikTokAds to be activated when a corresponding ad is watched, usually for 1 second or more.

Cost

  • TikTok Ads provides cost data using Cost API.
  • Dimensions supported: Campaign, adset, ad, geo
  • Retroactive data: When the cost API is initially enabled, we pull active campaigns retroactive data for up to seven days. 

Prerequisite:

  • You need your TikTok Ads login credentials to set the cost API integration.

To enable the cost API:

  1. Go to the Cost tab.
  2. Enable Get Cost Data. 

  3. Click Log in to TikTok Ads.
    The TikTok Ads login window opens.

  4. Complete the following steps if prompted to do so by TikTok Ads:
    • Login to TikTok Ads. 
    • Review and accept the Platform Services Agreement.
    • When prompted, you must enable selected all.

      TikTokwindow_us-en.png

  5. Select Add a new connection
  6. Click Add Connection.
    TikTok Ads is connected to AppsFlyer.
  7. Click Save Cost.

 

To delete a connected account:

Ad revenue

TikTok ads provides aggregate level ad revenue attribution.

Before you begin

From your TokTok ads dashboard you need to get the following credentials:

  • App ID
  • Secure Key
  • Account ID

To enable ad revenue attribution for this partner:

  1. Go to the Ad revenue tab.
  2. Enable Get ad revenue data.
  3. Complete the credential fields.
  4. Select the Event Source to map to the ad revenue event. 
  5. Click Save Ad revenue.

Permissions

In this tab, you can select the permissions to grant TikTokAds, whether the partner acts as an ad network, agency or even both. Note that even if attribution is disabled for TikTokAds, the permissions tab is active and you can grant TikTokAds permissions. 

The following permissions can be used:

  • Allow to configure integration - permit the partner to setup the integration tab (except in-app event postbacks)
  • Allow to configure in-app event postbacks - permit the partner to setup in-app event postbacks mapping to itself on the integration tab
  • Allow access to your retention report - only to the partner's own retention data
  • Allow access to your aggregate loyal user data - only to the partner's own loyal user data
  • Allow access to your aggregate in-app events data - only to the partner's own in-app events data
  • Allow access to your aggregate revenue data - only to the revenue data attributed to the partner
  • Allow access to your Protect360 dashboard - only to the partner's own Protect360 data, and providing the feature is enabled for the advertiser 

Learn more about granting permissions to ad networks and their individual team members.

Configuring campaigns on TikTok Ads

Configure ads in your TikTok Ads account

To configure campaigns on TikTok Ads:

  1. Log in to TikTokAds.
  2. In the top menu, go to Library > Event > Create New App .Create_new_app_in_TT_dashboard.png
  3. Complete the following in Create New App Section:
    • Download URL Setting
    • Tracking Setting
    • App Event Setting (Install event will automatically postback to TikTok Ads) TT__.png
  4.  Create Ads
  5.  Data Reporting on TikTok Ads - Library - Event - App Page

AppsFlyer shows the lifetime value on overview dashboard, while TikTok Ads has a different method. Please find below the definitions of related metrics on TikTok Ads - Library - Event - App Page:

Event Type - The types of standard event received.

Statistics - It shows how your event are counted for each event type. “Once” means only 1 event per ad interaction within 30 days is counted.

Attributed Events - The number of events attributed to your ads, using the "Statistics" logic.

data_reporting_on_TT_dashboard.png 

 

Was this article helpful?