Business Help Center
Create an Ad
English
Third Party Tracking
If your campaign objective is App Install and you would like to track the performance of your ads, a measurement partner is recommended to monitor ad performance. 

Note: You have to use one of the TikTok Ads Measurement Partner services in order to track app installs and further in-app events.

The third-party tracking partners supported by TikTok Ads are: Appsflyer, Adjust, Kochava, Tune, F.O.X, Party, Singular, Tenjin, Branch, AppMetrica, Adbrix, myTracker. 

If you're not using any of these partner services, we recommend that you choose 'Traffic' as your campaign objective and track clicks to monitor your ad performance. 

If you're using a third-party tracking partner service that is not yet supported by us, please shoot an email to tracking.support@bytedance.com, we will try to integrate with the third-party tracking partner. 

Instructions to Configure Tracking Links

Appsflyer

Tracking Link Acquisition Process

Go to the Appsflyer platform, search for "TikTok Ads (Bytedance Global)" channel in the "media platform configuration" module to obtain the "Click-through tracking link" and "View-through tracking link’.

Example links

  • Click-Through Attribution:
https://app.appsflyer.com/id0000000000?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__&pid=bytedanceglobal_int&af_click_lookback=7d&clickid=__CALLBACK_PARAM__&android_id=__ANDROIDID1__&advertising_id=__GAID__&idfa=__IDFA__&os=__OS__&af_ip=__IP__&af_ua=__UA1__&af_lang=__SL__&redirect=false&af_channel=__PLACEMENT__

  • View-Through Attribution:
https://impression.appsflyer.com/id0000000000?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__&pid=bytedanceglobal_int&c=__CAMPAIGN_NAME__&af_viewthrough_lookback=1d&clickid=__CALLBACK_PARAM__&android_id=__ANDROIDID1__&advertising_id=__GAID__&idfa=__IDFA__&os=__OS__&af_ip=__IP__&af_ua=__UA1__&af_lang=__SL__&redirect=falseaf_channel=__PLACEMENT__

Required Parameters for Attribution and Callback

GAID/IDFA/ IP / UA1/  SL, clickid=__CALLBACK_PARAM__

Campaign, Ad sets, Ad Related Name and ID Required Parameters

c=__CAMPAIGN_NAME__&af_c_id=__CAMPAIGN_ID__&af_adset=__AID_NAME__&af_adset_id=__AID__&af_ad=__CID_NAME__&af_ad_id=__CID__
  • If you are an agency and want to see ad data in your Appsflyer reseller account, the ad link needs to include: "af_prt= Advertiser's Appsflyer Agency Name"( af_prt=*** ).
  • If you encounter other setup issues, please contact your Appsflyer Account Manager.

Adjust

Tracking Link Acquisition Process

You can create an acquisition channel named ‘TikTok Ads’ in the tracking link of Adjust and select the necessary parameters. The initial link should at least include the "tracker" ‘s2s = 1’ (In the example, the tracker reflects the Adjust account information of the advertiser and the channel information of TikTok Ads) .

Example Links

  • Click-Through Attribution
https://s2s.adjust.com/sample?campaign=__CAMPAIGN_NAME__&__CAMPAIGN_ID__&adgroup=__AID_NAME__&__AID-PLACEMENT__&creative=__CID_NAME__&__CID__&s2s=1&idfa=__IDFA__&label=__callback_param__&ip_address=__IP__&user_agent=__UA__&install_callback=__CALLBACK_URL__
  • View-Through Attribution
https://s2s.adjust.com/impression/sample?campaign=__CAMPAIGN_NAME__&__CAMPAIGN_ID__&adgroup=__AID_NAME__&__AID-PLACEMENT__&creative=__CID_NAME__&__CID__&s2s=1&idfa=__IDFA__&label=__callback_param__&ip_address=__IP__&user_agent=__UA__&install_callback=__CALLBACK_URL__

Required Parameters for Attribution and Callback

gps_adid=__GAID__/idfa=__IDFA_/ip_address=__IP__&user_agent=__UA__ ,install_callback=__CALLBACK_URL__

Campaign, Ad sets, Ad Related Name and ID Required Parameters

campaign=__CAMPAIGN_NAME__&__CAMPAIGN_ID__&adgroup=__AID_NAME__&__AID__&creative=__CID_NAME__&__CID__

  • If the advertiser needs to test and install multiple times on the same device, you are able to clear the device ID in the system. The Adjust server will then record your device as a new device and the test will be counted as a new click and install. Adjust has a test console on their Backstage that allows the advertiser to input the device ID to be cleared. See this link for more information: https://docs.adjust.com/en/testing-console/#how-to-validate-your-device-activity-using-the-testing-console.
  • If you encounter other setup issues, please contact your Adjust Account Manager.

Kochava

Tracking Link Acquisition Process

You can access the channel named "ByteDance Global Android" or  "ByteDance Global iOS" in Kochava and select the necessary parameters. Please note the distinction between Android and iOS:
  • The initial Android link contains at least ‘campaign_id= campaign information from your Kochava backstage’ and ‘network_id=7117’
  • The iOS initial link contains at least ‘campaign_id= campaign information from your Kochava backstage’, ‘network_id=7116’

Required Parameters for Attribution and Callback

IDFA/GAID/UA  /IP, Callback Param
  • If you need to track data by ad group name/ad creative name, please add a parameter to the tracking link: &sub_ad=__CID_NAME__&sub_group=__AID_NAME__
  • If you encounter other setup issues, please contact your Kochava account manager.

Tune

Tracking Link Acquisition Process

You can get the Partner's promotion link for TopBuzz on your Tune (MAT) platform.

Required Parameters for Attribution and Callback

IDFA / GAID, Callback Param
  • If you need to track data by ad group name/ad creative name, please replace the parameter to the tracking link: &sub_ad=__CID_NAME__&sub_group=__AID_NAME__
  • If you encounter other setup issues, please contact your account manager at Tune.

F.O.X

Tracking Link Acquisition Process

You can access the promotion link named TikTok in the backstage of F.O.X.

Example Links Only Click-through Attribution

  • iOS
https://c1.app-adforce.jp/ad/p/r?_site=sample&_article=sample&_link=sample&_nored=1&suid=__CALLBACK_PARAM__&adid=__IDFA__
  • Android
https://c1.app-adforce.jp/ad/p/r?_site=sample&_article=sample&_link=sample&_nored=1&suid=__CALLBACK_PARAM__&adid=__GAID__
Required Parameters for Attribution and Callback
IDFA/GAID, Callback_Param
  • If you encounter other setup issues, please contact your account manager at F.O.X

Party

Tracking Link Acquisition Process

You can access the promotion link for the Topbuzz network in your Party backstage.

Example Links Click-through Attribution

https://click.adzcore.com/sample?adid=__AID__&adid_name=__AID_NAME__&cid=__CID__&cid_name=__CID_NAME__&idfa=__IDFA__&gaid=__GAID__&callback=__CALLBACK_PARAM__&campaign_id=__CAMPAIGN_ID__&campaign_name=__CAMPAIGN_NAME__&direct=1&redirection=0

Required Parameters for Attribution and Callback

idfa=__IDFA__/gaid=__GAID__ , callback=__CALLBACK_PARAM__ , direct=1&redirection=0.
  • If you need to track data by ad group name/ad creative name, please replace the parameter to the tracking link: adid=__AID__&adid_name=__AID_NAME__&cid=__CID__&cid_name=__CID_NAME__&campaign_id=__CAMPAIGN_ID__&campaign_name=__CAMPAIGN_NAME__
  • If you encounter other setup issues, please contact your account manager at Party. 

Singular

Tracking Link Acquisition Process

You can get Network's promotion link for TikTok Ads Network in your Singular backstage.

Example Links

  • Click-through Attribution(The legacy tracking link):
https://c.singular.net/api/v1/ad?st=sample&andi=__ANDROIDID1__&aifa=__GAID__&idfa=__IDFA__&pscid=__AID__&pscn=__AID_NAME__&cr=__CID__&pcrid=__CID__&pcrn=__CID_NAME__&pcn=__CAMPAIGN_NAME__&pc=__CAMPAIGN_ID__&pcid=__CAMPAIGN_ID__&cl=__CALLBACK_PARAM__&redirect=false&h=sample&ip=__IP__
  • Click-through Attribution(The singular link):
https://singularassist.sng.link/D59c0/c84n?idfa=__IDFA__&andi=__ANDROIDID1__&aifa=__GAID__&redirect=false&pscid=__AID__&cl=__CALLBACK_PARAM__&ip=__IP__&pcrn=__CID_NAME__&pcid=__CAMPAIGN_ID__&pc=__CAMPAIGN_ID__&pcn=__CAMPAIGN_NAME__&pcrid=__CID__&cr=__CID__&pscn=__AID_NAME__
  • View-through Attribution(The legacy tracking link):
https://i.singular.net/api/v1/imp?st=sample&andi=__ANDROIDID1__&aifa=__GAID__&idfa=__IDFA__&pscid=__AID__&pscn=__AID_NAME__&cr=__CID__&pcrid=__CID__&pcrn=__CID_NAME__&pcn=__CAMPAIGN_NAME__&pc=__CAMPAIGN_ID__&pcid=__CAMPAIGN_ID__&cl=__CALLBACK_PARAM__&redirect=false&h=sample&ip=__IP__
  • View-through Attribution(The singular link):
https://i.sng.link/D59c0/c84n?idfa=__IDFA__&andi=__ANDROIDID1__&aifa=__GAID__&redirect=false&pscid=__AID__&cl=__CALLBACK_PARAM__&ip=__IP__&pcrn=__CID_NAME__&pcid=__CAMPAIGN_ID__&pc=__CAMPAIGN_ID__&pcn=__CAMPAIGN_NAME__&pcrid=__CID__&cr=__CID__&pscn=__AID_NAME__

Required Parameters for Attribution and Callback

andi=__ANDROIDID1__&aifa=__GAID__&idfa=__IDFA__cl=__CALLBACK_PARAM__&redirect=false
  • If you need to track data by ad group name/ad creative name, please replace the parameter to the tracking link: pscid=__AID__&pscn=__AID_NAME__&cr=__CID__&pcrid=__CID__&pcrn=__CID_NAME__&pcn=__CAMPAIGN_NAME__&pc=__CAMPAIGN_ID__&pcid=__CAMPAIGN_ID__&cl=__CALLBACK_PARAM__
  • If you encounter other setup issues, please contact your account manager at Singular.

Tenjin

Tracking Link Acquisition Process

 You can get the promotion link for TikTok Ads Network in your Tenjin backstage.

Example Links

  • Click-through attribution:
https://track.tenjin.io/v0/top_buzz/sample?bundle_id=sample&platform=ios&click_id=__CALLBACK_PARAM__&advertising_id=__IDFA__&campaign_id=__AID__&campaign_name=__AID_NAME__&creative_name=__CID_NAME__  
  • View-through attribution:
https://track.tenjin.io/v0/top_buzz/sample?bundle_id=sample&platform=ios&click_id=__CALLBACK_PARAM__&advertising_id=__IDFA__&campaign_id=__AID__&campaign_name=__AID_NAME__&creative_name=__CID_NAME__&impression=true (Impression =true is required to show attribution links )

Required Parameters for Attribution and Callback

click_id=__CALLBACK_PARAM__&advertising_id=__IDFA__ (if it is android ,advertising_id=__GAID__ )
  • If you need to track data by ad group name/ad creative name, please replace the parameter to the tracking link: campaign_id=__AID__&campaign_name=__AID_NAME__&creative_name=__CID_NAME__
  • If you encounter other setup issues, please contact your account manager at Tenjin.

Branch

Tracking Link Acquisition Process

You can get the promotion link for TikTok Ads Network in your Branch backstage.

Example Links

  • Click-through Attribution:
https://branchster.app.link/m3Jx1VZsr7?%243p=a_tiktok_ads&%24idfa=__IDFA__&%24s2s=true&~ad_set_id=__AID__&~ad_set_name=__AID_NAME__&~campaign=__CAMPAIGN_NAME__&device_ip=__IP__&~campaign_id=__CAMPAIGN_ID__&~click_id=__callback_param__&~creative_id=__CID__&~creative_name=__CID_NAME__&~placement=__PLACEMENT__
Android: 
https://branchster.app.link/IO6WOQwqr7?%243p=a_tiktok_ads&%24aaid=__GAID__&%24s2s=true&~ad_set_id=__AID__&~ad_set_name=__AID_NAME__&~campaign=__CAMPAIGN_NAME__&device_ip=__IP__&~campaign_id=__CAMPAIGN_ID__&~click_id=__callback_param__&~creative_id=__CID__&~creative_name=__CID_NAME__&~placement=__PLACEMENT__
  • View-through Attribution:
iOS:
https://impression.link/impression?branch_key=key_live_hkDytPACtipny3N9XmnbZlapBDdj4WIL&%243p=a_tiktok_ads&%24idfa=__IDFA__&%24s2s=true&~ad_set_id=__AID__&~ad_set_name=__AID_NAME__&~branch_ad_format=App%20Only&~campaign=__CAMPAIGN_NAME__&device_ip=__IP__&~campaign_id=__CAMPAIGN_ID__&~channel=TikTok%20Ads&~click_id=__callback_param__&~creative_id=__CID__&~creative_name=__CID_NAME__&~feature=paid%20advertising&~placement=__PLACEMENT__
Android:
https://impression.link/impression?branch_key=key_live_hkDytPACtipny3N9XmnbZlapBDdj4WIL&%243p=a_tiktok_ads&%24aaid=__GAID__&%24s2s=true&~ad_set_id=__AID__&~ad_set_name=__AID_NAME__&~branch_ad_format=App%20Only&~campaign=__CAMPAIGN_NAME__&device_ip=__IP__&~campaign_id=__CAMPAIGN_ID__&~channel=TikTok%20Ads&~click_id=__callback_param__&~creative_id=__CID__&~creative_name=__CID_NAME__&~feature=paid%20advertising&~placement=__PLACEMENT__

Required Parameters for Attribution and Callback

$aaid=__GAID__&$idfa=__IDFA__&~click_id=__callback_param__
  • If you need to track data by ad group name/ad creative name, please replace the parameter to the tracking link: ad_set_id=__AID__&~ad_set_name=__AID_NAME__&~campaign=__CAMPAIGN_NAME__&~campaign_id=__CAMPAIGN_ID__&~creative_id=__CID__&~creative_name=__CID_NAME__
  • If you encounter other setup issues, please contact your account manager at Branch

AppMetrica

Tracking Link Acquisition Process

You can get the promotion link for TikTok Ads Network in your AppMetrica backstage.

Example Links

  • Click-through Attribution:
https://redirect.appmetrica.yandex.com/serve/0000000000000000?device_ip={IP}&c={CAMPAIGN_ID}&click_timestamp={TS}&click_id={CALLBACK_PARAM}&device_ua={UA1}&site_id={PLACEMENT}&ios_ifa={IDFA}&creative_id={CID} &ad_group_id={AID} 
Required Parameters for Attribution and Callback
 &click_id={CALLBACK_PARAM}&ios_ifa={IDFA}&google_aid={GAID}
  • If you encounter other setup issues, please contact your account manager at AppMetrica.

Adbrix

Tracking Link Acquisition Process

You can get the promotion link for TikTok Ads Network in your Adbrix backstage.

myTracker

Tracking Link Acquisition Process

You can get the promotion link for TikTok Ads Network in your myTracker backstage.

Reference

Tracking link instructions

Third-party Tracking Company Splicing Activation & Click Related Macros

  • IDFA:__IDFA__
  • GAID:__GAID__
  • andi: __ANDROIDID__/__ANDROIDID1__
  • IP:  __IP__
  • SL: __SL__
  • UA: __UA__/ __UA1__

TikTok Statistical Conversion Related Macros

__CALLBACK_PARAM__ or __CALLBACK_URL__

TikTok Ad Level Related Name and ID Related Macros

Campaign Name:__CAMPAIGN_NAME__
Campaign ID:__CAMPAIGN_ID__
Ad set Name:__AID_NAME__
Ad set ID:__AID__
Ad Name:__CID_NAME__
Ad ID:__CID__

Note: TikTok macros are all double-underlined at the beginning and end, and the middle is single underlined: ‘__xxx_xxx__’.