事件去重

为获得理想的广告投放效果，我们建议广告主同时设置 Tiktok Pixel SDK 和事件 API，以确保数据覆盖达到最大化。

获取事件去重的详细介绍，请参考此处。如果广告主同时使用 TikTok Pixel SDK 和事件 API 发送同一事件，则有必要删除重复事件。例如，如果您同时通过 TikTok Pixel SDK 和事件 API 发送Purchase事件，则需要正确设置删除重复事件功能。如果您正通过 TikTok Pixel SDK 和事件 API 发送非重叠事件，则无需删除重复事件。例如，如果您通过 TikTok Pixel SDK 发送ViewContent，而通过事件 API 发送Purchase事件，则无需删除重复事件。

如果同时通过事件 API 和 Pixel SDK 发送的事件具有相同的event_id、event和pixel_code参数，则需要删除重复事件。两个事件的事件名称（例如Purchase或AddToCart）和event_id都完全相同，才能顺利删除重复事件。

event_id是由广告主选择的独特字符串。广告主可能已经有了非常适合用于删除重复事件的订单号或交易 ID。如果广告主没有现成的 ID 可用，可随机选择一个数字，但需要确保这个数字在 Pixel SDK 事件和事件 API 中保持一致，以便删除重复事件顺利进行。

相隔 5 分钟以内接收到的重复事件将首先进行合并：若较晚接收的事件包含较早接收的事件中未包含的数据字段，则较晚接收的事件的这些数据字段将并入较早接收的事件。若相隔 48 小时以内接收到完全相同的重复事件，则较晚接收的事件不计入。

Pixel SDK 代码示例

(code Example JavaScript)
ttq.track('AddToCart', {
    contents: [
    {
      content_id: '301',
      content_name: 'running shoes',
      content_category: 'Shoes > Sneakers > running shoes',
      brand: 'your brand name',
      quantity: 1,
      price: 8,
    }],
    content_type: 'product',
    value: 9.2,
    currency: 'USD',  
},
{event_id:'1239485'});
(/code);

事件 API 示例

(code Example http)
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": "AddToCart",
  "event_id":"1239485",
  "timestamp": "2020-09-17T19:49:27Z",
  "context": {
    "ad": {
      "callback": "123ATXSfe"
    },
    "user": {
      "external_id": "f0e388f53921a51f0bb0fc8a2944109ec188b59172935d8f23020b1614cc44bc",
      "phone_number": "2f9d2b4df907e5c9a7b3434351b55700167b998a83dc479b825096486ffcf4ea",
      "email": "dd6ff77f54e2106661089bae4d40cdb600979bf7edc9eb65c0942ba55c7c2d7f"
    },
    "user_agent": "Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion",
    "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"
      }
    ],
    "content_type": "product",
    "currency": "USD",
    "value": 46.00
  }
}
(/code);

验证去重设置

如需查看重复事件是否成功删除以及成功删除了多少个事件，请访问 Pixel 详情页。 1. “浏览器”数据指标仅展示 Pixel SDK 发送的不同事件。 2. “服务器”数据指标仅展示事件 API 发送的不同事件。 3. “服务器与浏览器”数据指标展示的是通过事件 API 和 Pixel SDK 同时发送且删除重复事件后的不同事件（从事件 API 和 Pixel SDK 同时发送的事件视作一个事件）。如果数据指标过低，请检查设置事件去重时的配置，确保 Pixel SDK 和事件 API 的event_id完全相同。