Description:

TikTok Offline Events API enables businesses to securely send offline event data—such as in-store purchases, phone orders, or CRM interactions—directly to TikTok. By connecting this offline data with TikTok ad campaigns, advertisers can better measure the full impact of their ads, improve conversion attribution, and optimize campaign performance across both online and offline touchpoints. This server-to-server integration ensures data privacy and integrity without depending on browser-based tracking or the TikTok Pixel.

Pre-Requisites:

• TikTok Ads account
• A website/Marketing Data System
• TikTok Business Manager account
• Server-side API permission

Getting Started:

• Log in to your Datahash account on https://studio.datahash.com/login
• Navigate to the TikTok category under the Destination list in the left section.
• Click on the “Offline Events API” connector tile

The process to setup the TikTok Events API is detailed below. The Setup process is the same for both types of connection modes.

It is a fairly simple process and can be done in 2 ways – either use Login with TikTok to automatically fetch set-up details or provide the set-up details manually from TikTok Ads Manager.

Single Sign on:

• Click on the “Continue with TikTok” button. This will open a new window prompting you to log in to your TikTok account.

• Log in to your TikTok for Business account.

• Select the necessary permissions and click “Confirm”.

• You will be redirected back to the Datahash dashboard.

• Choose the specific TikTok Advertiser ID you want to proceed with. Select the associated Event Set ID.

• Opt-in for limited data usage: It is a feature to give businesses more control over how their event data is used in TikTok’s systems. In order to help facilitate advertiser’s compliance with the right to opt out of sale and sharing of personal data under certain U.S. state privacy laws. The feature will be available in California, Virginia, Colorado, Connecticut, and Utah.

• Select “Yes” to opt in and “No” to opt out

• Click Finish to complete the set-up.

Manual Process:

• Provide the Event Set ID and the Access token of the business account with which you would like to integrate.
  • Event Set ID :- The Event Set ID is a unique identifier assigned to each TikTok Pixel created by a business within the TikTok Ads Manager.
  • Access Token :- An Access Token is a unique identifier that allows businesses to connect their TikTok ad account with third-party tools such as the TikTok Offline Events API.

• Once done, click on Finish to complete the setup.

• The setup has been done & the data will start to flow from the source to the destination.

Components:

To better understand the setup, here are some technical details about the components involved:

Finding the Event Set ID and Access Token:

• Log in to your TikTok Ads Manager account at https://ads.tiktok.com/

• Choose the relevant Ad Account that includes the pixel that you wish to integrate.

• Click on the “ Tools” menu located on the top navigation panel and navigate to the “Events” section.

• Select the type of events which you would like to manage. For offline Events API implementation, select “Manage” for Offline events.

• The Pixel ID is available under the Pixel name written in blue, as shown in the image.

• To retrieve the Access token, click on the Pixel ID name written in blue above the Pixel ID, then click on Settings tab.

• Scroll down to the Events API section and click on “Generate Access Token”.

• Once clicked, an Access token will be available. Copy and save this access token.

• Enter the Event Set ID and access token in the Datahash dashboard.