How to postback signals through Events API

Sending back events data to TikTok can help to yield higher-quality leads that are more likely to convert. Learn more about signal postback for lead quality optimization.

Before you begin

You will need to have admin access to your TikTok Ads Manager account.

How to postback signals through Events API

Step 1: Create a CRM event set

1. Log in to TikTok Ads Manager.

2. Hover over Tools, then select Events to enter Events Manager.

3. Click on Connect data source.

4. Select CRM as the data source.

5. Create a name for the CRM event.

6. Take note of your Event Set ID on the top left corner of the screen. You will need this ID to complete the postback process.

7. Once the event set is created successfully, you will be redirected to the setting tab. Click on the Connect button.

8. Choose Manual setup as your setup method, then click Next.

Step 2: Generate an access token

1. Click on Generate access token to get the access token.

2. This is the sample payload that you can copy and modify for your needs.

Step 3: Send data using the Events API

1. Retrieve CRM Event Sets within your ad account by calling /crm/list/.

2. Send back your CRM events data by calling /event/track/. Set event_source to crm and set event_source_id to one of the CRM Event Set IDs obtained.

Step 4: Map your CRM events to TikTok standard events

1. In TikTok Ads Manager, hover over the Tools tab and select Events.

2. Click on Data sources in the left navigation.

3. Click on the CRM event you just created. Note: It can take up to 4 hours to show the data postback.

4. You need to map the Custom Events to the Standard Events on the right.

If you don’t find the matched Standard Events on the right column, it can mean:

• Your event is already mapped to Standard Events.

• There’s no suitable Standard Events to map to.

We recommend to postback Standard Events because only Standard Events can be used to optimize conversion, and can be tracked and used in measurement reporting.

Step 5: Validate the postback setup

1. In TikTok Ads Manager, hover over the Tools tab and select Events.

2. Click on Data sources in the left navigation.

3. Click the CRM event set that you just created.

4. Observe if the data has flowed into attributed events. It might take 10 minutes for data to sync. If the matched events number is greater than 0, then the postback data has started to come into TikTok, and the configuration is complete.