← 返回目录
📁 Marketing API › Ad Measurement › Guides › Events API 1.0 › Events API : Web

设置高级匹配

本指南旨在介绍使用TikTok事件API进行高级匹配。关于高级匹配的详细介绍,请参见此处。

最佳实践

我们建议您为所有访客事件同时发送电子邮件和电话号码。此外,建议您在漏斗的早期获取访客的电子邮件和电话号码以获得最佳效果。这将增加高级匹配成功的概率。

步骤

  1. 导航至您想实施高级匹配的事件(或事件代码)。
  2. 在context.user对象中,向TikTok发送有效载荷时传入已有的PII(电话号码和电子邮件)。

示例

下面是一个“开始下单”事件的curl请求示例,有效负载中添加了散列处理的电话号码和电子邮件参数。

(code)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/pixel/track/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "pixel_code": "BU35TSQHT2A1QT375GMG",
  "event": "InitiateCheckout",
  "event_id":"1616318632825_357",
  "timestamp": "2020-09-17T19:49:27Z",
  "context": {
    "ad": {
      "callback": "123ATXSfe"
    },
    "page": {
      "url": "http://demo.mywebsite.com/purchase",
      "referrer": "http://demo.mywebsite.com"
    },
    "user": {
      "external_id": "f0e388f53921a51f0bb0fc8a2944109ec188b59172935d8f23020b1614cc44bc",
      "phone_number": "2f9d2b4df907e5c9a7b3434351b55700167b998a83dc479b825096486ffcf4ea",
      "email": "dd6ff77f54e2106661089bae4d40cdb600979bf7edc9eb65c0942ba55c7c2d7f",
      "ttp":"94e2a4j9-h3j5-k2h5-98cc-c84a745mk098"
    },
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.109 Safari/537.36",
    "ip": "13.57.97.131"
  },
  "properties": {
    "contents": [
     {
        "price": 8,
        "quantity": 2,
        "content_id": "1077218",
        "content_name": "running shoes",
        "content_category": "Shoes > Sneakers > running shoes",
        "brand": "your_brand_name"
      },
      {
        "price": 30,
        "quantity": 1,
        "content_id": "1197218",
        "content_name": "running shoes",
        "content_category": "Shoes > Sneakers > running shoes",
        "brand": "your_brand_name"
      }
    ],
    "content_type": "product",
    "currency": "USD",
    "value": 46.00
  }
}
'
(/code)
  1. 如果您添加了其他参数,请使用测试事件功能来检查 PII (个人信息)是否已成功发送。

收到这些个人信息后,TikTok会使用这些信息与 TikTok 用户进行匹配。

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →