(Update - September, 2024) The TikTok SAN migration for all Singular advertisers has been concluded and the information in this article is no longer relevant.
With the conclusion of the migration legacy non-SAN partner configurations in the UI have been deprecated:
- Non-SAN and SAN partner configurations will be consolidated into a single “TikTok Ads” partner configuration, which will manage the TikTok SAN integration for your app(s).
- Singular Links for the legacy non-SAN integration will be archived and removed from the Manage Links page.
- Reporting will not be impacted. Historical attributions for non-SAN measured campaigns have been preserved and will continue to be reported as source “TikTok Ads”, alongside SAN attributions. For further information refer to our documentation.
Migration Overview
TikTok's migration is considered individually by app, and consists of a pre-migration and migration step. The managed migration does not require campaigns to be paused, nor require any action from advertisers in most circumstances.
Pre-Migration
During pre-migration, each app's campaigns are still being attributed through the non-self attributing integration, but undergo the following steps.
- For all apps that have a non-SAN a partner configuration (TikTok Ads), Singular has auto-created a matching SAN partner configuration (TikTok for Business) mirroring the same configuration at the time of creation
- At this point, the SAN integration is configured but inactive with no attribution claims from TikTok
- TikTok compares app event signals from both non-SAN and SAN integrations for validation
Note:
- As of November 2023, all app that were using the non-SAN integration have been pre-migrated in Singular. If you believe your app has not been pre-migrated, or are not sure if it has been pre-migrated, see "My app has not been pre-migrated, what can I do?".
- As of September 25, 2023, all new apps created and marketed in TikTok are eligible for the SAN integration. See "I'm launching a new app with TikTok, what do I do?"
Migration
After an app has been migrated, each app's campaigns will be attributed through the self-attributing integration. The migration for each app undergo the following steps:
- TikTok finishes validation and schedules the app for migration
- TikTok enables the migration for the app
- When an app begins migration, TikTok stops reporting touchpoints through Singular tracking links for attribution
- At the same time, TikTok's SAN integration begins self-attributing attributions
- Attributions via SAN will gradually increase, while attributions to non-SAN will gradually decrease, up until your Singular tracking links attribution windows have elapsed. See "How do I know if my app has been migrated to TikTok’s self-attributing integration?"
Note:
- TikTok manages the validation and scheduling of each app for migration provided the app has been pre-migrated. If your app has been pre-migrated but not yet migrated, reach out to your TikTok account manager to inquire if and when your app has been scheduled for migration
General Migration FAQ
In aggregated reports, both TikTok non-SAN and SAN integrations report attributions under the source name "TikTok Ads". This is done to ensure seemless transition of reporting for both tracker and network data (See "How does the migration affect my TikTok reporting data?").
However, in order to determine if Singular is attributing "TikTok Ads" attributions through non-SAN vs SAN, you can select the "Tracker Source Name" dimension in your reporting to see the breakdown:
- "tiktok" is populated for non-SAN attributions
- "Tiktok Ads" is populated for SAN attributions
Note: Due to how the migration is performed, it is expected to see both non-SAN and SAN attributions, up until the attribution window for your Singular tracking links has elapsed.
After an app has been migrated:
- It is expected to continue to see the non-SAN ("TikTok Ads") partner configuration. Do not remove the non-SAN partner configuration as non-SAN attributions may still be occurring. Singular will auto-remove non-SAN partner configurations at a future date.
- You may manage and update the SAN ("TikTok for Business") partner configuration as you see fit.
To ensure a seemless transition of reporting, both the non-SAN and SAN integrations report attribution under source name "TikTok Ads". The only difference in tracker reporting is in the tracker source name:
- "tiktok" is populated for non-SAN attributions
- "Tiktok Ads" is populated for SAN attributions
Your existing TikTok data connector integration is not changing and continues to report as source "TikTok Ads" as well, therefore combining persists during and after the migration.
There is no impact to your TikTok iOS SKAN reporting in Singular, during and after the migration process. Campaigns measured through TikTok's SKAN integration with Singular continue to be reported as "TikTok Ads".
TikTok's reporting on decoded SKAN conversion models are also not impacted as TikTok's managed migration includes migrating from using the non-SAN to SAN configurations to map conversion model events to TikTok's Events.
If you would like to make changes to your non-SAN partner configuration, such as adding or removing event postbacks to TikTok for an app that has been pre-migrated:
- Make the change (add/remove event) in the non-SAN configuration "TikTok Ads"
- Manually replicate the change (add/remove event) in the SAN configuration "TikTok Ads for Business"
Important:
- Replicating and keeping the non-SAN and SAN event configurations synchronized is important for TikTok's pre-migration validation and eligibility of the app for migration
- Singular does not auto-replicate any changes between the non-SAN and SAN partner configurations, so manual replication of changes is necessary
- Apps marketed and created after September 25th, 2023
- New apps in TikTok are automatically whitelisted for the new self-attributing integration
- Configure the SAN integration for the app by following the TikTok for Business Attribution Integration Guide
- Apps marketed and created after September 25th, 2023
- New apps in TikTok are automatically whitelisted for the new self-attributing integration.
- You can run advertiser campaigns from your agency business manager by creating an ad account dedicated to the advertiser. The advertiser will have to verify the ad account to use their app's Store Link.
- Configure the SAN integration for the app by following the TikTok for Business Attribution Integration Guide
In the above does not apply to your app, please contact your TikTok account manager for more information.
Migration Issues FAQ
Your app may not have been migrated to the SAN integration for a number of reasons:
| Scenario | Resolution |
|
The app has not been pre-migrated |
|
|
It has been pre-migrated, but not yet migrated. |
TikTok schedules app migrations in batches. Reach out to your TikTok account manager to inquire if and when your app has been scheduled for migration.
|
|
The app has been pre-migrated, but you are seeing an error in TikTok |
Your pre-migrated app may have mismatching non-SAN and SAN configurations that are causing TikTok to fail migration validation. Ensure that your non-SAN and SAN partner configurations are passing the same events to TikTok. See "My app is not yet migrated, can I make changes to my partner configurations?" |
|
The app is being migrated from another MMP |
You can create a separate TikTok advertiser account with Singular, and start transitioning by closing out old ads under old account with the other MMP, and creating new ads under new advertiser account to be used with Singular. |
Singular periodically checks for apps that have not be pre-migrated, to create a SAN partner configuration to pre-migrate the app (see "Pre-Migration") .
Your app may have been onboarded to Singular since the last periodic check, or the periodic check may have failed for other reasons.
In these cases, you may manually create the SAN partner configuration yourself. To do so, you can follow the "TikTok for Business Attribution Integration Guide" to configure.
Important:
- When configuring the "TikTok for Business" partner configuration, ensure that you have configured the same events for "TikTok for Business", as you have configured in the non-SAN "TikTok Ads" partner configuration.
- Replicating and keeping the non-SAN and SAN event configurations synchronized is important for TikTok's pre-migration validation and eligibility of the app for migration
- Singular does not auto-replicate any changes between the non-SAN and SAN partner configurations, so manual replication of changes is necessary
If you are seeing an error in your TikTok dashboard for an app that is not yet migrated, it may be because your app has not been pre-migrated. See "My app has not been pre-migrated, what do I do?"
If you app has been pre-migrated properly but am still seeing an error, contact your TikTok account manager for more information.