Integration Summary

(See Partner Integrations Glossary)

Prerequisites

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.

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