Offline conversions

Send offline conversions (in-store, CRM, call-center) to TikTok's Offline Events API with POST /v1/ads/conversions on your tiktokads account. Web-pixel events are not sent this way.

Before you start

The connection must have granted TikTok's Offline Events permission. Connections authorized before it must reconnect.

destinationId is an Offline Event Set id. GET /v1/accounts/{accountId}/conversion-destinations lists the event sets of every advertiser on the connection.

Send a conversion event

Each event needs an email or a phone in user.

const { data } = await zernio.conversions.sendConversions({
  body: {
    accountId: '66b2e19d8c3f5a7e9d0b1c2d',
    destinationId: '7057103914977558530',
    events: [{
      eventName: 'Purchase',
      eventTime: 1804150800,
      eventId: 'order_1042',
      value: 59.9,
      currency: 'USD',
      actionSource: 'offline',
      user: { email: 'ana@example.com', phone: '+14155550123' }
    }]
  }
});

Response (200):

{
  "platform": "tiktokads",
  "eventsReceived": 1,
  "eventsFailed": 0,
  "failures": []
}

How fields map

How it behaves

• Events go to TikTok in batches of up to 1,000 against one event set.
• An event with neither email nor phone is not sent. It is listed in failures with code MISSING_IDENTITY, and the rest are still sent.
• TikTok accepts or rejects a batch as a whole. When it rejects one, every event in it is listed in failures with TikTok's code and message.

If it fails

Related

• Send conversions: the unified event shape, every field.
• List conversion destinations: the Offline Event Sets.
• Pixels: the TikTok Pixel for web events.
• Read ad analytics: spend and results per ad.