什么是 TikTok Events API？

🧠 什么是 TikTok Events API？

TikTok Events API（事件 API，前称 Server-to-Server API）允许企业将来自网站、APP 或 CRM 的用户行为数据直接从服务器发送到 TikTok。它是 TikTok Pixel 的补充或替代方案，特别适用于：

用户浏览器阻止了追踪（如广告拦截器或 iOS 14 隐私限制）
你需要更可靠的转化数据和归因追踪
使用多个追踪系统（如 CRM、电商后端）

Events API 能确保在浏览器限制下，你的关键广告数据不会丢失。

🚀 使用 TikTok Events API 的优势

✅ 绕过浏览器追踪限制（cookie 被禁、隐私设置等）
✅ 基于服务器追踪，更安全、更可控
✅ 提升广告归因准确率
✅ 可与 TikTok Pixel 配合使用，实现数据去重
✅ 支持追踪整个用户转化流程，包括线下行为

⚙️ 工作原理

Events API 通过服务器向 TikTok 官方接口发送结构化的 HTTP POST 请求，请求中包括：

事件类型（如：购买、页面浏览、加购）
用户身份信息（邮箱、手机号、IP、浏览器信息）
时间戳
事件 ID（用于 Pixel 去重）
来源页面等上下文信息

🛠️ TikTok Events API 设置步骤

✅ 第 1 步：创建 TikTok Pixel

虽然是服务器端追踪，仍需创建 Pixel 并获取 Pixel ID：

登录 TikTok Ads Manager
点击上方菜单：资产 > 事件
在 网页事件 中，创建新的 Pixel
记录你的 Pixel ID

✅ 第 2 步：获取 Access Token（访问令牌）

前往 TikTok 商业中心（Business Center）
点击 资产 > Events API
选择你刚刚创建的 Pixel
点击 生成 Access Token
保存该令牌，用于请求身份验证

✅ 第 3 步：编写服务端请求逻辑

TikTok 接口地址为：

https://business-api.tiktok.com/open_api/v1.3/event/track/

发送 POST 请求，示例：

请求头（Headers）：

Content-Type: application/json
Access-Token: YOUR_ACCESS_TOKEN

请求体（Body）JSON 示例：

{
  "pixel_code": "你的PixelID",
  "event": "CompletePayment",
  "timestamp": 1713115432000,
  "event_id": "ORDER12345",
  "context": {
    "ip": "192.0.2.1",
    "user_agent": "Mozilla/5.0",
    "page": {
      "url": "https://你的商城.com/thankyou"
    }
  },
  "properties": {
    "value": 129.99,
    "currency": "USD"
  },
  "user": {
    "external_id": "已哈希的邮箱或手机号"
  }
}

✅ 第 4 步：对用户数据进行哈希加密

TikTok 要求对敏感信息（如邮箱、手机号）进行 SHA256 加密：

import hashlib

email = "test@example.com".strip().lower()
hashed_email = hashlib.sha256(email.encode()).hexdigest()

将加密后的值填入 "user" > "external_id"

✅ 第 5 步：测试事件是否正常发送

TikTok 提供 测试工具：

前往 TikTok Ads Manager
打开你的 Pixel 设置
选择 测试事件（Test Events）
向 API 请求中加入 test_event_code 字段，如：

{
  ...
  "test_event_code": "TEST1234"
}

查看是否成功接收到事件

🔁 常见事件类型

事件名	含义
`PageView`	页面浏览
`AddToCart`	加入购物车
`CompletePayment`	完成购买
`Lead`	收集潜在客户
`InitiateCheckout`	开始结账流程
`Search`	网站搜索
`SignUp`	用户注册

建议：使用唯一的 event_id 追踪订单并配合 Pixel 去重。

🧪 Pixel 与 Events API 去重机制

如果你同时使用 Pixel 和 Events API，请为每个事件设置相同的 event_id：

浏览器端 Pixel 发送事件：event_id = abc123
服务端 Events API 同样发送：event_id = abc123

TikTok 会自动识别并只统计一次转化。

🔐 安全建议

妥善保管 Access Token
定期轮换令牌
服务端调用，不要暴露给前端
保证接口为 HTTPS

🧩 可集成的平台和工具

Shopify、WooCommerce（可通过插件实现 Server-to-Server）
CRM 系统（如 Salesforce）
后端语言：Node.js、Python、PHP 等
第三方平台：Zapier、Make.com

✅ 总结：是否值得使用 Events API？

如果你希望：

提升 TikTok 广告表现
准确追踪广告转化
避免浏览器端数据流失

那么，Events API 是非常必要的工具。它能帮助你适应隐私限制下的新广告环境，是 TikTok 广告追踪的核心补充方式。

什么是 TikTok Events API？