Skip to main content

​
TikTok Events API

Send conversion events to TikTok Ads for tracking and audience building.
Make sure to check the partner’s website and API documentation for the most up-to-date information and configurations.
For optimal tracking performance and first-party data collection, consider using the TikTok Events API Gateway with custom domain support instead of this template.

​
Setup

1

Add Destination

Go to Hardal dashboard → Marketing Destinations → “Add Custom Destination” → Select “TikTok Events API” template
2

Configure Endpoint

{
  "endpoint_url": "https://business-api.tiktok.com/open_api/v1.2/pixel/track/",
  "request_method": "POST",
  "content_type": "application/json"
}
3

Set Event Format

{
  "pixel_code": "YOUR_PIXEL_ID",
  "event": "##event_name##",
  "timestamp": "##created_at##",
  "properties": {
    "currency": "##properties.currency##",
    "value": "##properties.value##",
    "contents": "##properties.contents##"
  }
}

​
Supported Events

  • Purchase - Completed purchase
  • AddToCart - Item added to cart
  • ViewContent - Product page view
  • CompleteRegistration - Account registration
  • InitiateCheckout - Checkout started

​
Event Properties

  • currency - Transaction currency (ISO 4217)
  • value - Transaction value
  • contents - Array of products