验证事件 API 设置
本文介绍了如何验证网站事件追踪设置,主要包括以下流程: - 验证事件是否被正确接收 - 验证事件的配置和触发是否正确 - 验证事件去重设置(当您同时从Pixel SDK和事件 API发送事件时需要进行这一操作)
验证事件是否正确接收
您可以通过 Pixel 详情页来确认我们是否已接收到您的事件。点击进入 Pixel 详情页的概览选项卡: 1. 如果我们接收到了由事件 API 发来的您的事件,您将会在关联方式中看到"服务器"。请刷新页面查看最新状态。 2. 如果您同时通过事件 API 和 Pixel SDK 发送事件,您会看到"服务器和浏览器"。
通过测试事件验证事件是否配置正确且正确触发
完成 Pixel 设置并准备好报告 Pixel 事件后,您可以发送一个测试事件,来验证一切是否正常。 切换到“生产”模式前,请确保您移除了test_event_code(测试事件代码)。
步骤
- 在事件管理平台上,点击 Pixel 查看配置详情。
- 在测试事件选项卡中,找到测试服务器事件板块第 2 步中的测试代码按钮,点击此按钮复制代码。
- 在报告事件的 API 请求 body 中,添加新的字段
test_event_code,并粘贴从第 2 步复制的代码作为该字段的值。发送 API 请求。以下是测试请求示例。您需要自行更换Access-Token、event_source_id和test_event_code的值。
(code curl http)
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-Code}}",
"test_event_code": "{{YOUR_TEST_CODE}}",
"data": [
{
"event": "Purchase",
"event_time": 1684574395,
"event_id":"1616318632825_357"
"user": {
"email": ["848a771458438fc2ec420560d769fb9b9b86851ee338ec56517baabd79d3bb4f",
"dd6ff77f54e2106661089bae4d40cdb600979bf7edc9eb65c0942ba55c7c2d7f"],
"phone": ["2f9d2b4df907e5c9a7b3434351b55700167b998a83dc479b825096486ffcf4ea"],
"ttp":"94e2a4j9-h3j5-k2h5-98cc-c84a745mk098",
"ttclid": "E.C.P.v3fQ2RHacdksKfofPmlyuStIIHJ4Af1tKYxF9zz2c2PLx1Oaw15oHpcfl5AH",
"ip": "139.177.225.245",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15"
},
"page": {
"url": "http://www.example.com/purchase?q=hello",
"referrer": "http://demo.mywebsite.com"
},
"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)
- 前往 事件管理平台的 Pixel 测试事件选项卡,在事件活动板块找到测试事件。平台将显示有效负载的所有问题,以便帮助您解决问题。
验证事件是否正确去重
为了达到最佳的广告效果,我们建议广告主同时设置 TikTok Pixel SDK 和事件 API,以确保最全面的数据覆盖。在这种情况下,广告主需要进行事件去重,以免同一事件被报告两次。有关事件去重的详细介绍,请参阅事件去重。