TikTok For Business Attribution Integration


This article describes TikTok's new attribution integration with Singular, which appears as "TikTok for Business (DO NOT MODIFY)" in the Singular platform. If you are still using the older, non self-attributing integration, see TikTok Ads integration guide (non-SAN) instead.

  • Apps marketed and created in TikTok before September 25th, 2023 require a migration to use the self-attributing integration documented in this article.
  • Apps marketed and created in TikTok after September 25th, 2023 are automatically whitelisted for the newer self-attributing integration. Follow this guide to configure the integration if:
    • Your app does not have a "TikTok for Business (DO NOT MODIFY)" partner configuration
    • Your app does not have a "TikTok for Ads" partner configuration
    • The app has been enabled for the self-attributing integration in TikTok

Learn more at TikTok SAN Migration Guide FAQ. If you are unsure of which TikTok integration to configure, reach out to your TikTok account manager and Singular support.


Integration Summary

(See Partner Integrations Glossary)

Partner TikTok For Business
Partner Type Self-attributing Ad Network
Creatives Supported
Publisher Supported
View-Through Supported
Re-engagement Supported
Click Tag Optional, for reporting (Self-attributing)
Receiving All Installs Recommended (Self-attributing)
Receiving All Events Recommended (Self-attributing)


  1. Integrate the Singular SDK (see instructions).
  2. Get your TikTok App ID from your TikTok Ads Manager dashboard. If you do not have a TikTok App ID, specify "N/A" in Singular's Partner Configuration.

    Learn how to retrieve your TikTok App ID in TikTok's help center.

Setup Instructions

1. Configure TikTok for Business as a Partner in Singular

To set up TikTok For Business as a partner:

  1. In your Singular account, go to Attribution > Partner Configuration and click Add a Partner. Then start typing "TikTok" and select "TikTok for Business (DO NOT MODIFY)" from the dropdown list. Do not configure "TikTok Ads", which is the configuration for the older non self-attributing integration.
  2. In the configuration window, select the app and app site for which you want to configure TikTok For Business.
  3. Singular and TikTok For Business recommend the following settings:

    Include View-Through Attributions Enable Enable attribution based on ad impressions in addition to ad clicks.
    Send event postbacks to TikTok for all Installs Enable Notify TikTok For Business about all in-app events, whether the app install was attributed to TikTok For Business or not.
  4. In the Tiktok App ID box, enter your TikTok App ID.


2. Send Event Postbacks to TikTok (Optional)

Configure postbacks to notify TikTok For Business about in-app events:

    1. Under Event Postbacks, click "+" to add a new event.
    2. Select one of the events reported by the Singular SDK in your app, and map it to a supported TikTok For Business event name.
      1. If you want to send In-app Ad Revenue to TikTok, select the In-app (SDK) Event Name "__ADMON_USER_LEVEL_REVENUE__" and map it to the TikTok event name "ImpressionLevelAdRevenue". TikTok will use that revenue in your campaign optimization.
        1. Note: if you do not see a Singular event named "__ADMON_USER_LEVEL_REVENUE__", you are not yet sending this data to Singular. Please see our documentation here to implement it within your Singular SDK. 
    3. If the event involves revenue, check the Send Revenue checkbox.
    4. Repeat for all of your events.
TikTok event mapping best practices:

  • TikTok recommends that advertisers use TikTok supported standard event names. Best practices for setting up standard events on TikTok can be found here.
  • Selecting "(Use SDK Event Name)" allows advertisers to define their own custom events outside of the standard events TikTok currently offers. However TikTok does not support optimization for custom events. Learn more about the difference between standard and custom events in  TikTok's article on the topic.



How does Singular's reporting for TikTok work?

Once an attribution is tracked, your TikTok campaigns will appear in your Singular Reporting interface.

Singular supports reporting attributed TikTok app campaign data for click-through and view-through installs and re-engagements. Currently, the available data includes the campaign ID, campaign name, and ad group ID. This data is mapped to Singular as "Campaign ID", "Campaign Name", and "Sub Campaign ID", respectively.

Note that "Network Installs" in Singular currently reports "conversions" from TikTok's reporting API. Conversions in TikTok refers to event set up as the optimization goals for the ad groups under the campaign. See TikTok's Help Center article here.

What are "engaged views" and how are they reported?

An engaged view is a user impression of a video ad that lasted more than 6 seconds. Engaged views are counted as click-through attributions in TikTok and Singular SANs integration reporting.

In aggregate reporting, engaged view conversions are reported under "conversion type" = "click-through".

What are "engaged clicks" and how are they reported?

An engaged click is a click interaction with an ad unit (such as a like, comment, and share). Engaged clicks are counted as click-through attributions in TikTok and Singular SANs integration reporting.

In aggregate reporting, engaged view conversions are reported under "conversion type" = "click-through".

How can deep linking and deferred deep linking be enabled with TikTok Ads?

Verify your Singular SDK implementation includes deep link and deferred deep link support

Once implemented, your Singular integration with TikTok automatically enables deep linking and deferred deep linking for supported TikTok campaign objectives.

Partner Data Policies

Data Retention

As a TikTok MMP partner, Singular adheres to the TikTok For Business data retention requirement: TikTok user-level data is removed after 6 months of original attribution. After 6 months, users attributed to TikTok For Business are treated/marked as "Organic" and reflected as such in both aggregate and user-level reporting in Singular.

Data Access

As of March 22, 2022, TikTok requires MMPs to mask user-level data for view-through campaigns due to preserve user privacy. Therefore, if a conversion is attributed to a TikTok view-through (impression-based) campaign, it is displayed as follows both in your postbacks and in the logs:

  • Network: "TikTok Restricted"
  • Campaign: "TikTok Restricted"

Data Mapping

Singular Value TikTok Value Example
Source TikTok Ads "TikTok Ads"
Tracker Source Name Tiktok Ads "Tiktok Ads"
Tracker Campaign Name TikTok Campaign Name “MyCampaign”
Tracker Campaign ID TikTok Campaign ID 123123
Tracker Sub Campaign Name TikTok Ad Group Name "My Ad Group"
Tracker Sub Campaign ID TikTok Ad Group ID 123124
Tracker Creative Name TikTok Ad Name "My Ad"
Tracker Creative ID TikTok Ad ID 123125
Tracker Publisher Hashed ID TikTok Site ID (when available) 123126