On October 9th, 2024, TikTok Ads became an Advanced self-attributing network. As an Advanced SAN, Singular's attribution measurement for TikTok Ads app campaigns will utilize existing self-attributing signals with touchpoints reported directly from TikTok, to augment Singular MMP reporting in Singular. Read more about Advanced SAN.
Integration Summary
(See Partner Integrations Glossary)
| Partner | TikTok Ads |
| Partner Type | Advanced Self-attributing Ad Network |
| Creatives | Supported |
| Publisher | Supported |
| View-Through | Supported |
| Re-engagement | Supported |
| S2S | N/A |
| Click Tag | Automatically configured (Advanced SAN) |
| Receiving All Installs | Required (Self-attributing) |
| Receiving All Events | Required (Self-attributing) |
Prerequisites
- Integrate the Singular SDK (see instructions).
-
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.
The TikTok App ID is a unique code that's generated in TikTok Ads Manager. This is how TikTok advertisers confirm ownership of their apps which unlocks advertising features and ensures advertiser control over their data.
Once you have generated the unique code, you will just need to paste it in your Mobile Measurement Partner (MMP) dashboard to complete the process.
Verification using TikTok App ID is required for some self-serve ad accounts, and recommended for managed ad accounts. Please see this TikTok help center article for more information.
Setup Instructions
1. Configure TikTok Ads as a Partner in Singular
To set up TikTok Ads as a partner:
- In your Singular account, go to Attribution > Partner Configuration and click Add a Partner. Then start typing "TikTok" and select "TikTok Ads" from the dropdown list. Do not configure "TikTok Ads", which is the configuration for the older non self-attributing integration.
- In the configuration window, select the app and app site for which you want to configure TikTok Ads
-
Singular and TikTok Ads 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 Ads about all in-app events, whether the app install was attributed to TikTok Ads or not. -
In the Tiktok App ID box, enter your TikTok App ID.
-
If you have multiple TikTok App IDs to enter, place a comma after entering the first TikTok App ID and add the second TikTok App ID.
Notes:
-
For new self-serve TikTok accounts, you need to complete the TikTok App ID. Although it's not required, it will unlock additional integration benefits, such as being able to run iOS14 campaigns.
To verify your app and the TikTok App ID, please ensure that unattributed events are turned on in Singular's Partner Configuration. Once TikTok receives the first event, your app will be verified and you can start running campaigns. If you'd like, you can then stop sending unattributed events (although TikTok recommends to continue to send unattributed events). See more instructions from TikTok here.
2. Send Event Postbacks to TikTok (Optional)
Configure postbacks to notify TikTok Ads about in-app events:
- Under Event Postbacks, click "+" to add a new event.
- Select one of the events reported by the Singular SDK in your app, and map it to a supported TikTok Ads event name.
- 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.
- 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.
- 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.
- If the event involves revenue, check the Send Revenue checkbox.
- Repeat for all of your events.
- 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.
FAQ
TikTok’s Advanced SAN leverages touchpoints reported directly from TikTok to Singular, to augment Singular’s SAN attribution to TikTok mobile app campaigns.
- Advanced SAN is automatically enabled for both iOS and Android app campaign measurement and is a privacy-preserving option to attribute opt-in and opt-out users from your TikTok campaigns.
- Advanced SAN prioritizes SAN attribution, and falls back to non-SAN (Advanced) signals to attribute when there is no SAN attribution.
- Both SAN and non-SAN attributions are reported under source "TikTok Ads". Segmentation between SAN and non-SAN attributions can be distinguished through the tracker source name dimension as "Tiktok Ads" and "Tiktok Ads - Advanced", respectively. See Data Mapping
- Singular Links do not need to be created for Advanced SAN. TikTok and Singular maintain a direct click and impression reporting integration to facilitate Advanced SAN attributions.
TikTok Advanced Dedicated Campaigns (ADC) is an iOS campaign type that aims to improve TikTok reporting and delivery features. ADC campaigns are available to Singular advertisers leveraging TikTok Advanced SAN on iOS.
For more information, see TikTok's article on Advanced Dedicated Campaigns.
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.
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".
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".
TikTok requires verifying your app in your TikTok Ads Manager (TTAM) account before you can turn on dedicated campaigns for iOS apps. This requires TikTok to first receive a conversion event from the MMP for any newly integrated apps.
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 Ads data retention requirement: TikTok user-level data is removed after 6 months of original attribution. After 6 months, users attributed to TikTok Ads 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 - Advanced |
"Tiktok Ads" (SAN attributions) "Tiktok Ads - Advanced" (Advanced/non-SAN attributions) |
| 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 |