Mobile Measurement Partner (MMP) Tracking
Last updated, June 2023

If you're an App Marketer, we recommend tracking the performance of your ads by using a Mobile Measurement Partner (MMP). The third-party tracking partners supported by TikTok Ads are:

  • ​Adjust

  • ​Airbridge

  • ​AppsFlyer

  • ​Branch

  • ​DFINERY (Adbrix)

  • ​Kochava

  • ​Singular

  • ​Tenjin

  • ​Tune


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 let your TikTok representative know and we will explore the integration with our team.


Instructions to configure tracking links

For all MMPs, make sure you go to your MMP dashboard to find the latest tracking links. Below are the Help Center Articles that are currently developed for TikTok Ads:


If your partner is not mentioned above, please reach out to them directly on how to configure tracking links for TikTok Ads.


You'll find the following examples below to reference by MMP:


Adjust

Adjust Help Center for TikTok Ads

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).


Also, the module has to be enabled under TikTok For Business in the Adjust dashboard. Go to Settings, select Partner Setup, and click Add Partners. Once the module is enabled, Adjust will start forwarding the traffic to TikTok; refer to the Adjust Help Center for TikTok Ads link above and follow the steps.


Example links

Right-click the hyperlinks and copy the link address

iOS & Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

gps_adid=__GAID__,idfa=__IDFA__ ,

ip_address=__IP__&user_agent=__UA__ ,

tiktok_callback_param=__callback_param__


If you need 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 its dashboard that allows you 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 or support@adjust.com.


Airbridge

Airbridge Help Center for TikTok Ads

Tracking link acquisition process

You can get Network's promotion link for TikTok Ads Network in your Airbridge dashboard.


Example links


Right-click the hyperlinks and copy the link address

iOS & Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

click_id=__CALLBACK_PARAM__&gaid_raw=__GAID__&ifa_raw=__IDFA__


AppsFlyer

AppsFlyer Help Center for TikTok Ads

Tracking link acquisition process

Go to the AppsFlyer platform and search for the "TikTok For Business" channel in the "media platform configuration" module.

You'll find the "Click-through tracking link" and "View-through tracking link".


Example links

Right-click the hyperlinks and copy the link address

iOS
Click-Through Attribution
View-Through Attribution

Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

GAID/IDFA / IP / UA / 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__


  • ​Essential and conditional parameters for measurement

  • ​All parameters included in the AppsFlyer attribution link templates for this integration serve a purpose and should be included to ensure proper measurement and reporting. Removing any parameters can impact the ability to report performance metrics, such as cost. If you have any questions or concerns, don't hesitate to contact your AppsFlyer account team.

  • ​When running a retargeting campaign, the parameter "&is_retargeting=true" should be present on your attribution links. This will be included automatically when enabling the retargeting campaign toggle in the AppsFlyer UI for this integration.

  • ​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=***)


​Testing

  • ​When testing the integration, AppsFlyer best practice is to register your testing device.

  • If you need to test multiple installs on the same device, AppsFlyer allows for registering any device as a test device.

  • ​When a user clicks an ad on TikTok, AppsFlyer does not handle the redirection to the store.

    • To account for this, the AppsFlyer attribution links include the parameter &redirect=false.

    • When testing an AppsFlyer attribution link for this integration in a browser, remove the parameter &redirect=false to allow for redirection to the app stores.


​If you encounter other setup issues, please contact your Appsflyer Account Manager.


Branch

Branch Help Center for TikTok Ads

Tracking link acquisition process

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


Example links

Right-click the hyperlinks and copy the link address

iOS
Click-Through Attribution
View-Through Attribution
Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

GAID/IDFA / IP / UA / SL: clickid=__CALLBACK_PARAM__


If you need to track data by ad group name/ad creative name, please replace the parameter with the following 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.


DFINERY (Adbrix)

DFINERY (Adbrix) Help Center for TikTok Ads

Tracking link acquisition process

You can get the URLs in the DFINERY (Adbrix) platform.

Also, please reach out to your DFINERY (Adbrix) representative for more information.


Example links

Right-click the hyperlinks and copy the link address

iOS & Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

m_idfa=__IDFA__&m_gaid=__GAID__&cb_5=__CALLBACK_PARAM__


Kochava

Kochava Help Center for TikTok Ads

Tracking link acquisition process

You can select Media Partner "TikTok For Business – Android" or "TikTok For Business – 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 dashboard" and "network_id=7117"

  • ​The iOS initial link contains at least "campaign_id= campaign information from your Kochava dashboard", "network_id=7116"


Example links

Right-click the hyperlinks and copy the link address

iOS
Click-Through Attribution
View-Through Attribution

Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

__IDFA__/__GAID__, __UA__, __IP__, __CALLBACK_PARAM__


If you encounter other setup issues, please contact your Kochava account manager.


Singular

Singular Help Center for TikTok Ads

Tracking link acquisition process

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


Example links

Right-click the hyperlinks and copy the link address

iOS
Click-Through Attribution
View-Through Attribution

Android
Click-Through Attribution
View-Through Attribution

Required parameters for attribution and callback

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__


Check the Send Revenue Box for Purchase events.


If you encounter other setup issues, please contact your account manager at Singular.


Tenjin

Tenjin Help Center for TikTok Ads

Tracking link acquisition process

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


Example links

Right-click the hyperlinks and copy the link address

iOS
Click-Through Attribution
View-Through Attribution

Android
Click-Through Attribution
View-Through Attribution


Note: "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 encounter other setup issues, please contact your account manager at Tenjin.


Tune (acquired by Branch)

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 Branch.


Supported macros

Macros are pieces of code that are implemented in the ad tag to allow mobile measurement partners to track various attributes of your advertising. The following is a list of TikTok's supported macros:

  • ​IDFA: __IDFA__

  • ​GAID: __GAID__

  • ​IP: __IP__

  • ​SL: __SL__

  • ​UA: __UA__

  • ​PLACEMENT (i.e. TikTok, HELO, etc.): __PLACEMENT__


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, while the middle is single-underlined: "__xxx_xxx__".


Content