跳到主要内容

TikTok 广告投放指南

关于线下事件API

本文整理「关于线下事件API」的操作要点,主要涵盖Before you begin、Offline File Data Stru、How to upload offline等内容。另附1 张对照表与1 张操作示意图。内容依据平台公开资料整理,便于按步骤查阅核对。

操作文档 3,903 字 约 10 分钟 第 4 级
本文要点

快速了解这一页

  • 本文整理「关于线下事件API」的操作要点,主要涵盖Before you begin、Offline File Data Stru、How to upload offline等内容。另附1 张对照表与1 张操作示意图。内容依据平台公开资料整理,便于按步骤查阅核对。
  • Before you begin
  • Offline File Data Structure
  • How to upload offline events data into Tiktok

本页「关于线下事件API」属于 TKTOC跨境导航「TikTok 广告投放指南」知识大纲中「设置线下度量」下的第 4 级条目。

本页目录 3 节
  1. Before you begin
  2. Offline File Data Structure
  3. How to upload offline events data into Tiktok

Offline conversions help you measure how TikTok ads result in offline customer actions, like in-store purchases, offline subscriptions, purchases and more. There are three ways to upload your offline events data into TikTok. You can automate sending offline events through our Events API directly or through a partner integration. Note: If you don't have resources to implement API or leverage an integration partner, you can manually upload offline events through TikTok's Events Manager. Create an Offline Event set in TikTok Event’s Manager. This helps you share, track and measure offline activity from people on TikTok that see or interact with your ads. Throughout your ad campaigns, we’ll match the offline events data that you upload to the offline event set. Please ensure you have an administrator or operate role in Events Manager to create an offline event set and upload events to an offline events set. When you create an offline event set, please enableAuto-Tracking Onusing the toggle. As a result, all future campaigns from this ad account will use this offline event set for ad tracking and attribution

Before you begin

  1. Create a CSV (comma-delimited) data file with your offline events data. Try to provide as much information as possible so that your reporting is accurate. Include correct timestamps, order IDs and item numbers if possible so that we can eliminate duplicate events.
  2. The first row of the .csv file is the standard header and it needs to include column names that correspond to offline events (see next page).
  3. We only support email or phone based PII.
  4. Maximum size of the file is 50 MB.
  5. Follow the format of the offline events example.

Example:

关于线下事件API-第1张图片
关于线下事件API-第1张图片

Offline File Data Structure

Column HeaderRequiredDescriptionExample Column Value
event_typeYesSupported offline event typesOne of the following values needs to be present:
Complete Payment(for In-store purchase, console purchase)
Contact(for Call-center events, over-the-chat events)
Subscribe(for In-store subscription, console subscription)
SubmitForm(for leads without TikTok Lead ID)
Add Payment Info
Add to Cart
Add to Wishlist
Click Button
Complete Registration
Download
Initiate Checkout
Place an Order
Search
View Content
emailYes if no phoneEmail (Plain text OR hashed with SHA-256)johndoe@mycompany.com
phoneYes if no emailPhone number (Plain text OR hashed with SHA-256)+12133734253 (or) 12133734253
timestampYesCorresponds to the date/time of transaction.2022-10-22T19:11:01.152Z(ISO-8601 timestamp format)
priceOptionalTotal amount spent in the transaction10
currencyOptionalThe currency the transaction was paid in (i.e., “USD” or “CAD”).USD
transaction_categoryOptionalField for tracking transaction by conversion goalsin-store
order_idOptionalA unique ID that corresponds to the order that a particular line item belongs toabc123
quantityOptionalThe number of products purchased. Typically, this value is 1 for basket-level transaction data1
product_idOptionalAn alphanumeric value delineating a unique item in an order, such as a SKU or UPC123456
product_categoryOptionalTop-level category of the productfurniture
store_idOptionalCode allocated to a physical store3456

How to upload offline events data into Tiktok

  1. Login toAds Manager.
  2. ClickTools.
  3. SelectEvents.
  4. SelectConnect Data Source.
  5. SelectOffline.
  6. Name youroffline event set.
  7. SelectCreate.
  8. SelectUpload events.
  9. Follow the format of the Offline Event File.Note: The first row of the file should include valid column headers. We only support email or phone based PII. The supported file format is .csv only, and the maximum size of the file is 10MB.
  10. ClickUploadto upload your CSV file.File upload error messagesWrong file extension (other than .csv)File size too large (greater than 10 MB)Illegal characters in the fileMissing required fieldsInaccurate timestampsData formatting issuesCheck the upload results.Note: The results may take a couple of hours to appear.

关于本页的常见问题

关于线下事件API属于哪个知识树?

属于 TKTOC跨境导航「TikTok 广告投放指南」知识大纲,页面顶部面包屑展示完整目录层级。

打开TikTok 广告投放指南

在哪里查看TikTok 广告投放指南的完整目录?

进入该知识树首页可看到一级目录总览,左侧折叠树包含全部层级节点,可逐级展开。

查看完整目录
内容说明

本页依据平台公开资料整理,供操作查阅;平台规则、功能口径与操作路径请以官方最新说明为准。 目录每日比对、正文按内容指纹每周轮巡,有变更才更新。