Data/Steps Needed Before Beginning Process:
- TikTok App ID
- Follow the instructions within the Create a TikTok Campaign below.
- Copy the Click and Impression URLs.
- When creating a new app witin TikTok’s Ads Manager, paste the Click and Impression URLs.
- Event Type (Provided by TikTok)
- Content Type Metadata Key (Provided by TikTok)
NOTE: In order for third-party tracking to be verified with TikTok, you must apply your TikTok App ID on the postbacks for Install and/or any Post-install events you are running campaigns with. For more information on locating the TikTok App ID, refer to their support documentation.
This section provides the steps for a first time creation of a TikTok App ID.
At this point, TikTok will generate an App ID, which will be used within the Postback Configuration.
TikTok for Business Enriched Self-Attributing Network (SAN)
TikTok is a Self-Attributing Network (SAN) and one of Kochava’s network partners. As a SAN, TikTok claims its own installs, except for mobile web inventory or any inventory without access to a device ID.
However, because of this setup, conversions claimed by TikTok might later be attributed by Kochava to other networks. This can lead to a difference in the number of installs reported by TikTok and Kochava, with Kochava often showing fewer installs.
To ensure advertisers see consistent performance across platforms, Kochava has introduced support for modeled attribution on TikTok for Business SAN campaigns through a new integration type called Enriched SAN.
Unlike other SAN partners, TikTok uses independent mobile measurement partners (MMPs) to power its modeled attribution. The Enriched SAN label will be applied to any SAN partner that uses Kochava’s attribution technology for this purpose.
NOTE: While Kochava’s lookback windows do not impact TikTok’s claims, they do affect Kochava’s reporting and analytics.
Enriched SAN Settings:
- Select Apps & Assets > Partner Configuration.
- Search for TikTok For Business – SAN.
- Select Partner Configuration Tools (⋮) > Reconciliation.
- Select the desired Click Reconciliation settings. For more information, refer to our Partner Reconciliation Settings support documentation.
NOTE: The Reconciliation Settings are for reporting “true wins” only. Self-attributing networks will still claim attribution using their own lookback settings. Some levels of the waterfall are not available to all SANs for “true win” reporting. Select the desired Impression Reconciliation settings. For more information, refer to our Partner Reconciliation Settings support documentation.
The following settings can be selected, modified or disabled for modeled attribution.
Enabling Modeled Attribution —
- Select the desired Impression Reconciliation > Modeled Lookback timeframe.
- Select the desired Click Reconciliation > Modeled Lookback timeframe.
- Select Additional Settings > Modeled Attribution > Enabled.
- Click Save.
Disabling Modeled Attribution —
- Select Additional Settings > Modeled Attribution > Standard.
- Click Save.
The following settings can be selected, modified or disabled for modeled attribution.
Enabling Modeled Attribution —
- Select the desired Impression Reconciliation > Modeled Lookback timeframe.
- Select the desired Click Reconciliation > Modeled Lookback timeframe.
- Click Save.
Disabling Modeled Attribution —
- Select Impression Reconciliation > Modeled Lookback > Disabled.
- Select Click Reconciliation > Modeled Lookback > Disabled.
- Click Save.
Create an Install Campaign:
- Log in to Free App Analytics.
- Select the desired Account and App.
- Select Links > Campaign Manager.
- Click Add a Tracker or Select Segment Tools (⋮) > Add a Tracker.
- Select the Campaign.
- Select the Segment.
- Enter a unique Tracker Name.
- Select the Tracker Type > Acquisition
NOTE: By default the Tracker Type is set to Acquisition.
- Select Media Partner:
- TikTok for Business – SAN
- Select a Agency Partner. (optional)
- Add a Custom Parameter. (optional)
- Click Add a Parameter.
- Enter the Custom Parameter.
- Add additional Custom Parameters. (optional)
- Click Save. (If no further trackers need to be created)
- Click Save & Add Another Tracker. (If additional trackers need to be created)
- Click Save & Create Postback. (To navigate directly to the Partner Configuration page).
NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document. support documentation.
NOTE: The Share With Publisher setting allows the associated publisher to view the settings for this tracker. By unchecking this box, the associated publisher will not be able to view the settings for the tracker.
NOTE: At the Campaign Level, advertisers can utilize the Custom Parameter fields to track any custom aspect of their campaigns that they define. You can use cp_0 through cp_9 and they will be populated within their own columns in reporting. For assistance with Custom Parameters, contact your Client Success Managers.
NOTE: In order to remove a custom parameter, Click the “X” associated with the specific parameter.
Create a Reengagement Campaign:
The information within this section provides the steps necessary to establish a reengagment campaign. If a reengagment campaign does not need to be created, the information in this section may be disregarded.
NOTE: An install tracker must be created in order for postback information to be sent.
- Click Add a Tracker or Select Segment Tools (⋮) > Add a Tracker.
- Select the Campaign.
- Select the Segment.
- Enter a Tracker Name.
- Select Tracker Type > Reengagement.
- Select Media Partner:
- TikTok for Business – SAN
- Select an Agency Partner. (optional)
- Enter a Deep Link. (optional)
- Add a Custom Parameter. (optional)
- Select the Event.
- Click Save (If no further trackers need to be created).
- Click Save & Add Another Tracker If additional events need to be created).
- Click Save & Create Postback. (To navigate directly to the Partner Configuration page).
Postback Configurations:
Install Postback Configuration —
NOTE: According to TikTok for Business, leaving the “Modeled Attribution” setting as “Standard” in your TikTok reconciliation settings may result in underreported campaign events and limit improvements to future campaign performance on TikTok .
- Select Apps & Assets > Partner Configuration.
- Click Add a Configuration.
- Select Network Partner > TikTok:
- TikTok for Business – SAN
- Click Go.
- Click Install > Postback Tools (⋮) > Edit.
- Enter the App ID:
- iTunes App ID (iOS)
- Package Name (Android)
- Check the Respect Data Controlled Flag (optional). This setting informs Kochava what transactional app data can be transmitted to TikTok SAN. For more information contact your Client Success Management team.
- Enter the TikTok App ID.
- Enter the TikTok Query.
- Enter the TikTok Description.
- Click Save.
Post-Install Postback Configuration —
- Select Apps & Assets > Partner Configuration.
- Locate the desired event and Click Edit Postback.
- Enter the App ID:
- iTunes App ID (iOS)
- Package Name (Android)
- Check the Respect Data Controlled Flag (optional). This setting informs Kochava what transactional app data can be transmitted to TikTok SAN. For more information contact your Client Success Management team.
- Select the Event Type:
- AchieveLevel
- AddPaymentInfo
- AddToCart
- AddToWishlist
- Checkout
- CompleteTutorial
- CreateGroup
- CreateRole
- GenerateLead
- InAppADClick
- InAppAdImpr
- InstallApp
- JoinGroup
- LaunchAPP
- LoanApplication
- LoanApproval
- LoanDisbursal
- Login
- Purchase
- Rate
- Registration
- Search
- SpendCredits
- StartTrial
- Subscribe
- UnlockAchievement
- ViewConten
- Enter the TikTok App ID.
- Enter the TikTok Query.
- Enter the TikTok Description.
- Select the Delivery Method.
- Click Save.
NOTE: TikTok recommends that advertisers use standard events when they start to buy ads. Best practices for setting up standard events on TikTok can be found here and you can learn more about the In-App Events that Kochava supports for TikTok here. Custom events are events that advertisers / partners can define themselves, outside of the standard events TikTok currently offers. Please note that TikTok does not support optimization for custom events. You can learn more about the difference between standard and custom events on this TikTok Help Center page.
Create a TikTok Campaign (Legacy)
NOTE: The following procedures are only completed within the Kochava UI.
- Log in to Free App Analytics.
- Select the desired Account and App.
- Select Links > Campaign Manager.
- Click Add a Tracker or Select Segment Tools (⋮) > Add a Tracker.
- Select the Campaign.
- Select the Segment.
- Enter a unique Tracker Name.
- Select the Tracker Type > Acquisition
NOTE: By default the Tracker Type is set to Aquisition.
- Select Media Partner:
- TikTok for Business – iOS
- TikTok for Business – Android
- TikTok for Business – Web
- Select a Agency Partner. (optional)
- Select the Destination URL Type:
- Custom
- Google Referrer (Android Only)
- Landing Page
- Enter the Install Destination URL.
- Enter a Deep Link. (optional)
- Add a Custom Parameter. (optional)
- Click Add a Parameter.
- Enter the Custom Parameter.
- Add additional Custom Parameters. (optional)
- Enter Pricing Type and Target Pricing. (optional)
- Click Save. (If no further trackers need to be created)
- Click Save & Add Another Tracker. (If additional trackers need to be created)
- Click Save & Create Postback. (To navigate directly to the Partner Configuration page).
NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document. support documentation.
NOTE: The Share With Publisher setting allows the associated publisher to view the settings for this tracker. By unchecking this box, the associated publisher will not be able to view the settings for the tracker.
NOTE: For more information on creating and using Landing Pages, refer to our Landing Page Creation and Maintenance support documentation.
NOTE: Google Referrer is set as the default destination type for Android apps. For the majority of Android install campaigns, Google Referrer is used for optimal conversion tracking. Google Referrer will only appear for Android based apps. If the Google Referrer Install URL needs to be updated, refer to our Update Google Referrer Install URL support documentation.
NOTE: For more information about deep links, refer to our Deep Linking support documentation.
NOTE: At the Campaign Level, advertisers can utilize the Custom Parameter fields to track any custom aspect of their campaigns that they define. You can use cp_0 through cp_9 and they will be populated within their own columns in reporting. For assistance with Custom Parameters, contact your Client Success Managers.
NOTE: When a custom parameter is created, it is inserted automatically into the Click URL.
NOTE: In order to remove a custom parameter, Click the “X” associated with the specific parameter.
NOTE: Depending on the selected destination URL type, default and optional settings will vary.
B. Custom Settings.
Reengagement Configuration (Legacy)
The information within this section provides the steps necessary to establish a reengagment campaign. If a reengagment campaign does not need to be created, the information in this section may be disregarded.
NOTE: An install tracker must be created in order for postback information to be sent.
Create a Reengagement Segment:
- Locate the desired Campaign.
- Select Campaign Tools (⋮) > Add a Segment.
- Enter a Segment Name.
- Enter a Segment Description. (optional)
- Click Submit.
Create a Reengagement Tracker:
- Click Add a Tracker or Select Segment Tools (⋮) > Add a Tracker.
- Select the Campaign.
- Select the Segment.
- Enter a Tracker Name.
- Select Tracker Type > Reengagement.
- Select Media Partner:
- TikTok for Business – iOS
- TikTok for Business – Android
- TikTok for Business – Web
- Select an Agency Partner. (optional)
- Select the Destination URL Type:
- Custom
- Google Referrer (Android Only)
- Landing Page
- Enter the Install Destination URL.
- Enter a Deep Link. (optional)
- Add a Custom Parameter. (optional)
- Enter Pricing Type and Target Pricing. (optional)
- Select the Line Event.
- Click Save (If no further trackers need to be created).
- Click Save & Add Another Tracker If additional events need to be created).
- Click Save & Create Postback. (To navigate directly to the Partner Configuration page).
Postback Configuration (Legacy)
- Select Apps & Assets > Partner Configuration.
- Click Add a Configuration.
- Select Network Partner:
- TikTok for Business
- TikTok for Business – Android
- TikTok for Business – iOS
- TikTok for Business – Web
- Click Go.
Install Configuration:
- Enter the App ID.
- Enter the TikTok App ID.
- Enter the Content Type Metadata Key.
- Enter the Content ID Metadata Key.
- Enter the Quantity Metadata Key.
- Enter the Description Metadata Key.
- Enter the Query Metadata Key.
- Enter the Price Metadata Key.
- Select the Delivery Delay.
- Select the number of Retry Attempts.
- Select the Delivery Method.
NOTE: For more information on locating the TikTok App ID, refer to their support documentation.
Post-Install Configuration:
- Enter the App ID.
- Enter the TikTok App ID.
- Enter the Content Type Metadata Key.
- Enter the Content ID Metadata Key.
- Enter the Quantity Metadata Key.
- Enter the Description Metadata Key.
- Enter the Query Metadata Key.
- Enter the Price Metadata Key.
- Select the Event Type.
- Select the Delivery Delay.
- Select the number of Retry Attempts.
- Select the Delivery Method.
NOTE: For more information on locating the TikTok App ID, refer to their support documentation.
SKAdNetwork Details
- Update your MMP SDK to the latest version that supports SKAdNetwork API.
- Get familiar with changes in performance and measurement based on SKAdNetwork API.
- Review the new iOS 14 dedicated campaign creation flow in Ads Manager.
- Complete the conversion event configuration in the MMP interface.
- Map your events to TikTok’s event naming by configuring postbacks for each event to TikTok.
- Develop a consolidation strategy to operate with the 15 campaigns, 5 ad group limit per app for SKAN 4.0.
- SKAdNetwork reports can be pulled from the dashboard.
NOTE: For more information on SKAdNetwork reports, refer to our support documentation.
Attribute | Format | Description |
---|---|---|
version | string | Version of install validation postback. Will be 1.0 if source app uses pre-iOS14 SDK and 2.0 for all apps running iOS14. |
ad-network-id | string | Network ID registered with Apple. |
campaign-id | string | Can be a value from 1 – 100. |
transaction-id | string | Unique ID used for deduplication tied to a conversion. |
app-id | string | ID for the advertised app. |
attribution-signature | string | TikTok-generated signature tied to an ad interaction, used to verify conversion using Apple’s public key. This will not be passed for TikTok Audience Network conversions. Please see below table for more details. |
redownload | boolean | Flag for a reinstall. |
source-app-id | string | ID of app where ad was served. |
conversion-value | string | 0-63, must be sent in incremental values by the advertised app. This will be null for v1 postbacks or v2 postbacks without a conversion value due to Apple’s privacy minimum threshold. |
skad_ip | string | The header ip of the device where the attribution postback was generated from. |
skad_ts | integer | The timestamp denoting when the media partner received the postback. |
partner_campaign_name | string | TikTok’s campaign name. |
partner_campaign_id | string | TikTok’s campaign ID. |
sub_campaign_name | string | TikTok’s adgroup name. |
sub_campaign_id | string | TikTok’s adgroup ID. |