Send PostHog conversion events to TikTok Ads

Requirements

Using this requires either PostHog Cloud with the data pipelines add-on, or a self-hosted PostHog instance running a recent version of the Docker image.

You'll also need access to the relevant TikTok Ads account.

Installation

1. In PostHog, click the Data pipeline tab in the left sidebar.

2. Click the Destinations tab.

3. Search for TikTok Ads Conversions and select the destination.

4. Visit the TikTok Events Manager.

   1. If you’ve already set up a Pixel for your website, we recommend that you use the same Pixel for your browser and server events.
      1. To create a new Pixel, click Connect data source and select Web.
      2. Skip the Add your website step.
      3. For the connection method, select Manual setup and Events API.
      4. Enter a name for your Pixel and click Create.
   2. Go to your Pixel via Data sources.
   3. Switch to the Settings tab and your Pixel ID will be listed as ID.
   4. You can create an access token by clicking Generate Access Token.

5. Back in PostHog, add the Pixel ID and Access token to the destination configuration.

6. Set up your event and property filters to remove unnecessary events. You only want to send events that are conversions. Filter out unrelated events or ones missing required data.

7. Press Create & enable, test your destination, and then watch your conversions get sent to TikTok Ads.

# Create a new destination
curl --location 'https://us.i.posthog.com/api/environments/:project_id/hog_functions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <POSTHOG_PERSONAL_API_KEY>' \
--data '{
    "type": "destination",
    "name": "TikTok Ads Conversions",
    "inputs": {
        "accessToken": {
            "value": ""
        },
        "pixelId": {
            "value": ""
        },
        "eventName": {
            "value": ""
        },
        "eventId": {
            "value": ""
        },
        "eventTimestamp": {
            "value": ""
        },
        "userProperties": {
            "value": ""
        },
        "propertyProperties": {
            "value": ""
        },
        "pageProperties": {
            "value": ""
        }
    },
    "enabled": true,
    "template_id": "template-tiktok-ads"
}'