TikTok For Business Attribution Integration

Learn about Singular's integration with TikTok and how to add TikTok For Business as a partner for Singular's attribution service.

 

Integration Summary

(See Partner Integrations Glossary)

Partner TikTok For Business
Partner Type Ad Network
Creatives Supported
Publisher Not Supported
View-Through Supported
Re-engagement Supported
S2S Not Supported
Click Tag Supported
Receiving All Installs Supported
Receiving All Events Supported

Prerequisites

  1. Integrate the Singular SDK (see Getting Started with the Singular SDK/S2S).
  2. Get your TikTok App ID from your TikTok Ads Manager dashboard. If you do not have a TikTok App ID, specify "N/A" within Singular's Partner Configuration section instead. You can find more information on how to generate and retrieve your TikTok App ID in TikTok's help center
  3. If you are a new TikTok client, you will need to enable unattributed events to be sent in order for your TikTok App ID to be passed to TikTok.

Setup Instructions

1. Partner Configuration

Tip: For general instructions for setting up a partner, see the Partner Configuration FAQ

To set up TikTok For Business as a partner in Singular:

  1. 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.
  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.
    Enable Fraud Postbacks Enable Notify TikTok For Business when Singular identifies fraudulent activity. Learn more in the Fraud Postbacks FAQ.
    Send Postbacks to TikTok for all Installs Enable Notify TikTok For Business about all app installs, whether they are attributed to TikTok For Business or not.
    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 ID box, enter your TikTok App ID.
  5. Configure postbacks to notify TikTok For Business about in-app events:

    • In the 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 For Business event name.
    • If the event involves revenue, check the Send Revenue checkbox.
    • Repeat for all of your events.

Screen_Shot_2021-02-17_at_9.55.14.png

2. Tracking Link Setup

Tip: For general information about setting up tracking links, see the Singular Links FAQ.

To generate a tracking link for TikTok For Business:

  1. In your Singular account, go to Attribution > Manage Links and click Create Link.
  2. Under Source Name, select "TikTok For Business".

    mceclip0.png

  3. Configure the link by selecting the desired app site and redirect options (see the Singular Links FAQ for help).

    If you want to use the link for retargeting campaigns (re-engagement), expand the Attribution Settings section and select Enable re-engagement tracking.

    unnamed.png

  4. Click Generate.

  5. You can now see and copy the click-through and view-through link with TikTok-supported macros to use with TikTok For Business.

    mceclip2.png

Partner Data Policies

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.

As of August 31, 2021, TikTok requires MMPs to mask user-level data for view-through campaigns due to user privacy concerns. 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: "Unattributed"
  • Campaign: "Unattributed"

Was this article helpful?