Set up TikTok For Business

Important:
Adjust has two integrations with TikTok For Business: one works with TikTok using links to capture attribution information, and the other works with TikTok as a self-attributing network (SAN). This article is about setting up the non-SAN integration.

If this is the first campaign that you are running with TikTok, we recommend you also activate the SAN TikTok integration alongside the non-SAN one. This ensures you have complete measurement during the transition period in which both integrations are operating.

  • Find out how to get set up with TikTok's SAN integration.
  • TikTok For Business is an ad network integrated with Adjust. Our integration lets TikTok For Business receive attribution and in-app event data through automated callbacks.

    In this article, learn how to set up measurement with TikTok For Business for your app. This includes activating the integration, creating a campaign link, and choosing what data Adjust can share with TikTok For Business.

    Before you begin

    Requirements

    iOS / Android / Windows / Unity / React Native / Flutter / Adobe Air / Cordova / Marmalade / Xamarin / Cocos2d-x / Titanium / Corona

    Select TikTok For Business and your app in Campaign Lab

    1. Under Campaign Lab, select Partners.
    2. Select New partner > TikTok For Business. Select Next to move to the next screen.
    3. In the App selection screen, choose the app for which you want to create the link, and enable the integration to share data with TikTok For Business.
    4. Select Next.

    Enable data sharing

    Enable data sharing to activate the integration with TikTok For Business. To enable data sharing:

    1. Turn on Enabled

    Once you enable data sharing with TikTok For Business, Adjust automatically sends TikTok For Business the following data, by default:

    • install
    • session
    • reattribution
    • event

    Set your data sharing options

    If you’re working with a multi-platform app with data sharing enabled for multiple platforms, you can:

    1. Separate data sharing options at the platform-level by selecting Use platform-specific settings.
    2. Set the same data sharing settings for multiple platforms by selecting Use global settings.

    Now, under What will be shared by default?, review the activities that Adjust shares with TikTok For Business by default.

    • install
    • session
    • reattribution
    • event

    Send additional data

    Choose the amount and type of data that you want to share with TikTok For Business through callbacks. TikTok For Business may use this information to optimize performance.

    1. Under What sources of data do you want to share?, choose the attribution source of the data you are sharing with TikTok For Business:
    • Data from all attribution sources
    • Only data attributed to TikTok For Business

    In-app revenue (from in-app purchases)

    Sharing in-app revenue lets TikTok For Business receive revenue amounts along with your revenue event data. You need to map events that generate revenue to share this data.

    Sessions

    Adjust does not automatically send session callbacks due to the high volume of sessions. Sharing sessions means TikTok For Business will receive your app’s session activity.

    Map parameters

    You usually need to map parameters to share custom data with TikTok For Business.

    Map events

    Map events that you want to share to the values that TikTok For Business can receive. Data for unmapped events is not shared with TikTok For Business.

    Under Map events, follow these steps to choose the in-app events you want to directly send to TikTok For Business.

    1. Select Map event.
    2. In the Adjust event list, choose the Adjust event that you want to share with TikTok For Business.
    3. In the Partner event list, choose or enter a custom event name that you want to map the Adjust event to. You might have to map an event to several values.
    4. Select Apply.

    Now TikTok For Business will receive in-app event data for each of your linked events.

    Tip:
    Custom event names must meet these requirements:
    • Character limit: Up to 50 characters.
    • Characters: Only alphabetic letters, Arabic numerals, underscores, and dashes are accepted.
    • Format: Must start with an alphabetic letter and cannot end with a space.

    Map parameters

    Partner parameters (available in Adjust SDK version 4.0+) let Adjust collect custom data points from your app and send them to TikTok For Business. This lets TikTok For Business receive custom event details for each of your linked events.

    Before adding new partner parameters to the Adjust SDK, make sure no pre-existing partner parameters already fit your requirements.

    To share partner parameters to TikTok For Business, follow these steps.

    1. Set up partner parameters within the Adjust SDK: iOS, Android
    2. Check the Parameters data sharing checkbox.
    3. Map your events.
    Note:

    If you set up partner parameters within the Adjust SDK without setting up parameter sharing in the dashboard, Adjust forwards the parameters as named in the Adjust SDK.

    Configure your link and settings

    You have the option to set your:

    Create your link and share it with TikTok For Business

    In the Setup review screen, you can review your choices. You can also go back and make changes to:

    • Your selected app
    • Data sharing options
    • Link structure parameters
    • User destinations
    • Attribution settings

    Select Create link to create your click URL, impression URL, QR code and link token. Creating a link also enables data sharing and the integration with TikTok For Business.

    Once you’ve created your link, share it with TikTok For Business for placement in campaigns.

    EXAMPLE CLICK URL:

    https://s2s.adjust.com/xxxxxx?campaign=__CAMPAIGN_NAME__%20(__CAMPAIGN_ID__)&adgroup=__AID_NAME__%20(__AID__)&creative=__CID_NAME__%20(__CID__)&s2s=1&idfa=__IDFA__&gps_adid=__GAID__&adgroup_id=__AID__&ip_address=__IP__&user_agent=__UA__&campaign_id=__CAMPAIGN_ID__&creative_id=__CID__&tiktok_placement=__PLACEMENT__&external_tracker_ids=1&tiktok_callback_param=__callback_param__

    EXAMPLE IMPRESSION URL:

    https://s2s.adjust.com/impression/xxxxxx?campaign=__CAMPAIGN_NAME__%20(__CAMPAIGN_ID__)&adgroup=__AID_NAME__%20(__AID__)&creative=__CID_NAME__%20(__CID__)&s2s=1&idfa=__IDFA__&gps_adid=__GAID__&adgroup_id=__AID__&ip_address=__IP__&user_agent=__UA__&campaign_id=__CAMPAIGN_ID__&creative_id=__CID__&tiktok_placement=__PLACEMENT__&external_tracker_ids=1&tiktok_callback_param=__callback_param__

    Raw data exports

    TikTok's guidelines state that device IDs from view-through attribution (VTA) may only be shared at the network level. Daily aggregated VTA reporting that includes campaign metadata but no device IDs remains unaffected.

    Campaign structure reporting

    To remain compliant with these guidelines, Adjust reports TikTok view-through raw data in the following way:

    • Network-level link = TikTok Installs
    • Link token = tt_inst

    Impression parameters

    MMPs cannot share the timestamp, advertising ID, campaign structure, and other user-related data from view-through impression callbacks. The timestamp of view-through conversion callbacks (such as install, session, event, etc.) is not affected.

    Partner specific setup instructions

    TikTok App ID

    TikTok App ID is an optional field in the TikTok For Business module. After you add the TikTok App ID Adjust shares it directly with TikTok. You can find your TikTok App ID in the TikTok Ads dashboard.

    Be aware that to enter multiple TikTok App IDs you need to separate them by commas. TikTok then parses them out accordingly on their end.

    Session forwarding

    When you turn on Session Forwarding, Adjust automatically maps sessions to the Tiktok APP Launch event.

    Impression measurement

    Adjust records an impression when a user views your mobile ad. If you would like Adjust to attribute installs to impressions, turn on impression-based attribution with device matching and/or probabilistic modeling in your Adjust dashboard. You can stop measuring impressions any time.

    SKAdNetwork measurement

    You can see your aggregated SKAdNetwork data in Datascape.

    If you would like to find out more about how to leverage this integration for your use cases, read our one pager with TikTok. In case of any questions related to the information provided on the one pager, contact partners@adjust.com.

    List of all parameters forwarded to TikTok For Business

    TikTok For Business requires Adjust to send the following parameters (data points) with your callbacks:

    PlaceholderInformation
    {currency}Original ISO 4217 currency code sent from Adjust SDK
    {gps_adid}Google Play Store advertising ID
    {idfa}ID for advertisers (iOS only)
    {idfv}Uppercase iOS ID for vendors
    {ip_address}Device IP address
    {is_reattributed}1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed
    {os_name}Device operating system
    {partner_parameters}Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks
    {revenue_float}Revenue, as sent from Adjust SDK, in whole currency units
    {user_agent}Incoming raw user agent
    {app_id}Store App ID or Google Play Store
    {app_name}Name of the app
    {app_version_short}App version number (Android), release-version-number for the bundle (iOS)
    {created_at}Activity timestamp
    {impression_based}1 if impression-based engagement, 0 if not