Set up TikTok For Business

Important:
Adjust has two module integrations with TikTok For Business: one works with TikTok using trackers 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 a network and Adjust module partner. Our integration lets TikTok For Business receive attribution and in-app event data through automated callbacks.

    Use our basic setup instructions to turn on Adjust’s integration and send callbacks to TikTok For Business. Then, use our advanced setup instructions to customize what information TikTok For Business receives.

    Basic setup

    To turn on Adjust’s integration with TikTok For Business, follow these steps.

    1. Find your app and select your app options caret (^).
    2. Select Partner Setup > ADD PARTNERS.
    3. Select the add (+) icon next to TikTok For Business.
    4. Turn on Enabled
    5. Optional: see advanced setup to customize your callbacks.
    6. Select Save.

    Well done! Basic setup is complete. Now you can create an Adjust tracker URL and submit it to TikTok For Business to launch your campaign.

    TikTok For Business will receive callbacks for these activities:

    • install
    • session
    • reattribution
    • event

    Create a Tracker URL

    To create an Adjust tracker URL, follow these steps.

    1. Find your app and select your app options caret (^).
    2. Select Tracker URLs > New Tracker.
    3. Enter your tracker name.
    4. Under NETWORK select "TikTok for Business" from the drop-down menu.
    5. Select Customize > Create.

    You now have two tracker URLs: one click-based and one impression-based.

    Both URLs include campaign parameters, and parameters for device IDs, IP address, user agent and more. Now, add those URLs into the TikTok For Business platform.

    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 tracker = TikTok Installs
    • Tracker 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.

    Advanced setup

    Choose which data TikTok For Business receives from Adjust by customizing your setup.

    Only forward data attributed to TikTok For Business

    Adjust sends TikTok For Business your installs and reattributions across all ad platforms.

    To stop TikTok For Business from receiving data attributed to other ad platforms, follow these steps.

    1. Find your app and select your app options caret (^).
    2. Select Partner Setup > TikTok For Business.
    3. Turn on Attributed Only.

    Now TikTok For Business will only receive data attributed to their own platform.

    Forward in-app revenue

    In-app revenue forwarding lets TikTok For Business receive revenue amounts along with your revenue event data.

    Note:
    Link at least one revenue event to TikTok For Business before turning on In-App Revenue Forwarding.

    To forward in-app revenue to TikTok For Business, follow these steps.

    1. Find your app and select your app options caret (^)
    2. Select Partner Setup > TikTok For Business
    3. Turn on In-App Revenue Forwarding

    Now TikTok For Business will receive the revenue amount for every tracked transaction.

    Forward ad revenue

    Ad revenue forwarding lets you send all of your ad revenue callbacks to TikTok For Business.

    To forward ad revenue data, follow these steps.

    1. Find your app select the app options caret (^).
    2. Select Partner Setup > TikTok For Business.
    3. Turn on Ad Revenue Forwarding.
    4. Optional: Select one or more Ad Revenue Sources.
    • If you leave this field empty, we send ad revenue data from all integrated mediation sources.
    1. Select SAVE.

    Forward sessions

    Adjust does not automatically send session callbacks due to the high volume of sessions.

    To forward in-app sessions to TikTok For Business, follow these steps.

    1. Find your app and select your app options caret (^).
    2. Select Partner Setup > TikTok For Business.
    3. Turn on Session Forwarding.

    Now TikTok For Business will receive your app’s session activity.

    Forward custom data

    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.

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

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

    1. Set up partner parameters within the Adjust SDK (instructions for iOS and Android).
    2. In the Adjust dashboard, find your app and select your app options caret (^).
    3. Select Partner Setup > TikTok For Business.
    4. Turn on Parameter Forwarding.
    5. Select Partner Parameter Mapping.
    6. In the FROM APP field, enter the name of your Adjust parameter (as written into the Adjust SDK). In the TO PARTNER field, enter your corresponding TikTok For Business name.
    7. Select Save.

    Now TikTok For Business will receive custom event details for each of your linked events.

    Note: If you set up partner parameters within the Adjust SDK without turning on Partner Parameter Mapping, Adjust forwards the parameters as named in the Adjust SDK.

    Forward in-app events

    Event linking lets TikTok For Business receive in-app event data. You can link every in-app event in Adjust to a preset TikTok For Business event.

    Adjust supports all TikTok App Event Optimization (AEO) events, such as Purchase, Registration, Add to Cart, Subscription, and Achieve Level. Find all supported in-app events.

    A screenshot of the TikTok For Business event linking process from the Adjust dashboard.

    To forward in-app events to TikTok For Business, follow these steps.

    1. Find your app and select your app options caret (^).
    2. Select Partner Setup > TikTok For Business > Event Linking.
    3. Find the Adjust-tracked event you want to link, then either use the dropdown menu to select your chosen TikTok event or enter a custom event name.
    4. When you finish linking events, select OK.
    5. Select Save.

    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.

    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 Tracking

    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 tracking impressions anytime.

    SKAdNetwork Tracking

    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