TikTok Conversions API integration

• The TikTok Conversion API integration allows you to pass conversion details from CPV Lab (opens new window) | CPV One (opens new window) to TikTok Ads and see them directly in your TikTok Ads Manager account.
• This is very important for the optimization and delivery of your ads through TikTok because it allows TikTok to see how your ads performed for specific audiences.

Pre-requirements

• CPV One or CPV Lab (version 9+) account
• A TikTok Ads Manager account
• At least one active campaign on TikTok

Setup the TikTok Conversion API integration

Below are all the steps on how to configure your CPV Lab campaign to pass conversions to TikTok Ads via Conversion API.

1. Create a TikTok campaign in CPV Lab | CPV One

To create a campaign for TikTok Ads, follow the instructions from here.

2. Create a TikTok Pixel

If you don't have already a TikTok pixel, then now you need to create one.

• Access the Tik Tok Ad Manager interface here:https://ads.tiktok.com/i18n/dashboard/ (opens new window)
• Go to the Assets -> Events menu, then Choose “Manage” for Web Events

• Select “Set Up Web Events”, then choose “Events API” to create a new pixel

• Enter a name for the Pixel, then choose “Manually Set Up Events API”.

• Choose Next from the bottom of the page and your pixel is setup.

3. Get the Pixel ID

• Check the Pixel details page for the Pixel ID. This appears after the “ID:” text.
• Save this Pixel ID as it will be needed later.

4. Generate the Access Token

• Also in the Pixel details page, look for the Settings tab, then select the “Generate Access Token” button.
• Save the Access Token value somewhere safe as this won’t be displayed again and it isn’t stored by TikTok.

4. Update your CPV Lab campaign

Go back to the campaign setup page in CPV Lab Pro to finish the TikTok Conversion API configuration.

• Go to Campaigns menu

• Click on your TikTok Ads Campaign in CPV Lab | CPV One

• Look for the new TikTok specific section in the "Tracking Pixel" area of the campaign setup page. Here is where you need to add the TikTok API details:

  • API Access Token – the access token generated above
  • Pixel ID – the ID of your TikTok Pixel created above
  • Event Name – the name of the event you want to pass to TikTok for each conversion. The default name is CompletePayment
  • Amount – the revenue that you want to pass to TikTok.
    • The default value of the {!revenue!} placeholder which will be replaced by the actual revenue.
    • You can also set a fixed numeric value:
  • Currency – the currency for your revenue (3-letter ISO code). The default option is USD.

• Save the campaign setup page and the integration with TikTok Conversion API for this campaign is complete.

Check that conversions get reported

• Once the above things are implemented, CPV Lab Pro will automatically send conversion details to TikTok each time the Postback URL gets fired from the Affiliate Network in your campaign.
• After receiving a few new conversions in your campaign, you should make sure that these were posted to TikTok by looking in 3 places:
  • 1. In the Conversions Log page from CPV Lab Pro - you will see a record starting with "type":"tiktokapi and with the details posted to TikTok for each TikTok API call and with “message”:”OK” in the ClickID column, something like in the image below
  • 2. In TikTok, in the Overview tab from the Pixel details page - you should see the number of CompletePayment events received and also the last time an event was received,like in the image below
  • 3. In the reports from your TikTok Ads Manager account - You will see conversions appearing here also; For complete details in these reports, choose the Custom Columns option and select the Page Event columns as shown below

Final Notes

• The TikTok campaigns are setup in CPV Lab Pro similar to campaigns from other traffic sources with only these changes:
  • The Traffic Source for your campaign should be “TikTok” (imported from the Catalog) and the External ID token should be configured for the “__CLICKID__” macro
  • The TikTok API configuration (Pixel ID and Access Token) needs to be performed in order to pass conversion details back to TikTok
  • Make sure that you have checked the options to capture the User Agents and IP Addresses from your visitors

WARNING

There may be a small delay (up to 15 minutes) between the moment conversions are passed from CPV Lab Pro to the TikTok Conversion API and the moment that they appear in the Pixel details page from TikTok Ads Manager. This is normal and doesn’t affect tracking.

Find more details in the video below:

Video Tutorial for setting up your TikTok campaign in CPV Lab (opens new window)

You may also find useful:

• Setup a TikTok Ads campaign with CPV Lab | CPV One
• Get TikTok Costs in CPV Lab
• Setup a campaign with Microsoft Ads
• Setup a campaign with Google Ads
• Setup a campaign with Meta Ads