← 返回目录
📁 Marketing API › Ad Measurement › Guides › Events API 2.0 › Events API for Web

验证事件 API 设置

本文介绍了如何验证网站事件追踪设置,主要包括以下流程: - 验证事件是否被正确接收 - 验证事件的配置和触发是否正确 - 验证事件去重设置(当您同时从Pixel SDK和事件 API发送事件时需要进行这一操作)

验证事件是否正确接收

您可以通过 Pixel 详情页来确认我们是否已接收到您的事件。点击进入 Pixel 详情页的概览选项卡: 1. 如果我们接收到了由事件 API 发来的您的事件,您将会在关联方式中看到"服务器"。请刷新页面查看最新状态。 2. 如果您同时通过事件 API 和 Pixel SDK 发送事件,您会看到"服务器和浏览器"。

通过测试事件验证事件是否配置正确且正确触发

完成 Pixel 设置并准备好报告 Pixel 事件后,您可以发送一个测试事件,来验证一切是否正常。 切换到“生产”模式前,请确保您移除了test_event_code(测试事件代码)。

步骤

  1. 在事件管理平台上,点击 Pixel 查看配置详情。
  2. 在测试事件选项卡中,找到测试服务器事件板块第 2 步中的测试代码按钮,点击此按钮复制代码。

  1. 在报告事件的 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)
  1. 前往 事件管理平台的 Pixel 测试事件选项卡,在事件活动板块找到测试事件。平台将显示有效负载的所有问题,以便帮助您解决问题。

验证事件是否正确去重

为了达到最佳的广告效果,我们建议广告主同时设置 TikTok Pixel SDK 和事件 API,以确保最全面的数据覆盖。在这种情况下,广告主需要进行事件去重,以免同一事件被报告两次。有关事件去重的详细介绍,请参阅事件去重。

内容来源: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 每日平台更新简报 →