事件去重

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

如果广告主同时使用 TikTok Pixel SDK 和事件 API 发送同一事件，则有必要删除重复事件。例如，如果您同时通过 TikTok Pixel SDK 和事件 API 发送同一事件，则需要通过event_id或第一方 Cookie（_ttp）设置事件去重。这样做可以使 TikTok 删除同一事件的重复数据，从而优化事件报告和推广系列的表现。若想了解事件去重的详细介绍，请参考此处。

`event_id`（推荐）

TikTok 根据event_source_id、event（例如Purchase或AddToCart）和event_id对事件进行去重。广告主应为每个事件选择一个唯一的字符串作为event_id。订单号或交易 ID 可以作为event_id使用。如果广告主没有现成的 ID 可用，可使用一个随机数，但需要确保这个数字在 Pixel SDK 事件和事件 API 中保持一致，以保证去重顺利进行。

如果收到具有相同event_source_id、event和event_id的多个事件，则保留第一个事件，丢弃在第一个事件之后的48小时内收到的任何后续事件。如果在第一个事件之后的5分钟内收到后续事件，则会尝试将其数据合并到第一个事件中。例如，如果第一个事件不包含user.email，但稍后（在5分钟内收到）的重复事件包含此信息，则会将电子邮件地址数据合并到第一个事件中。

以下是将event_id添加到TikTok Pixel SDK 事件和事件 API 事件的示例：

Pixel SDK 示例

(code)
// Javascript code
ttq.track('AddToCart',{
    content_type: 'product',
    value: 9.2,
    currency: 'USD'
    }, 
    {
    <span style="background-color: green;">event_id:'abcde12345'</span>
    }
)
(/code)

事件 API 示例（使用 curl ）

(code)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/event/track/' \
--header 'Access-Token: {{ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event_source": "web",
    "event_source_id": "{{PIXEL_ID}}"
    "data": [
        {
            "event": "AddToCart",
            "event_time": 1687758765,
            <span style="background-color: green;">"event_id": "abcde12345",</span>
            "properties": {
                "content_type": "product",
                "value": 9.2,
                "currency": "USD"
            }
        }
    ]
}'
(/code)

若您通过事件 API 发送 TikTok Cookie（_ttp），而未发送 event_id，我们将根据 _ttp 的 Cookie 值对浏览器事件或服务器事件进行去重。

若想使用基于 Cookie 的去重，您需要在您的 Pixel 设置中启用第一方 Cookie，随后浏览器 Pixel 将自动在第一方Cookie（_ttp）中存储唯一的标识符。通过事件 API 报告事件时，您需在 API 的有效负载中的user.ttp字段传入_ttp Cookie 的值。详情请查看发送 TikTok Cookie（_ttp）。

Cookie 去重使用[pixelCode, event, _ttp] 的组合作为去重键，去重窗口期为 5 分钟。这意味着在我们接收到第一个唯一事件后，我们将检测并丢弃在接下来的5分钟内具有相同[pixelCode, event, _ttp] 的事件。

这种去重方法的限制如下： - Cookie 去重仅会丢弃通过事件 API 发送的事件，尤其当在接收到服务器事件之前的 5 分钟内收到了具有相同的[pixelCode, event, _ttp] 的浏览器 Pixel 事件时。 Cookie 去重不会丢弃浏览器 Pixel 发送的事件。 - Cookie 去重仅当事件 API 有效负载中未设置 event_id 时丢弃通过事件 API 发送的事件。因此，如果要使用基于 Cookie 的去重，不要在事件 API 的有效负载中发送 event_id。

验证去重设置

如需验证去除是否成功以及已删除的重复事件的数量，访问 Pixel 详情页。 1. “浏览器”数据指标仅展示 Pixel SDK 发送的不同事件。 2. “服务器”数据指标仅展示事件 API 发送的不同事件。 3. “服务器与浏览器”数据指标展示的是通过事件 API 和 Pixel SDK 同时发送且删除重复事件后的不同事件（从事件 API 和 Pixel SDK 同时发送的事件视作一个事件）。如果数据指标过低，请检查设置事件去重时的配置，确保 Pixel SDK 和事件 API 的event_id完全相同。 - 选择连接方式为“服务器与浏览器”的事件，点击“事件状况”，将打开显示匹配和去重情况的“事件状况”页面。

事件去重

event_id（推荐）

Pixel SDK 示例

事件 API 示例 （使用 curl ）

Cookie

验证去重设置

`event_id`（推荐）

事件 API 示例（使用 curl ）