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

验证事件设置

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

验证事件是否被正确接收

您可以通过 Pixel 详情页来确认我们是否已接收到您的事件。点击进入 Pixel 详情页的概览标签:

  1. 如果我们接收到了由事件 API 发来的您的事件,您将会在关联方式中看到"服务器"。请刷新页面查看最新状态。
  2. 如果您同时通过事件 API 和 Pixel SDK 发送事件,您会看到"服务器&浏览器"。

测试事件

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

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

  1. 在报告事件的 API 请求(/pixel/track/) body 中,添加新的字段test_event_code,并粘贴从第 2 步复制的代码作为该字段的值。发送 API 请求。以下是测试请求示例。您需要自行更换 Access-Token、pixel_code和test_event_code的值。
(code http http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/pixel/track/' \
--header 'Access-Token: YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "pixel_code": "YOUR_PIXEL_CODE",
  "event": "Purchase",
  "event_id": "123asdios_1234",
  "timestamp": "2020-12-14T09:49:27Z",
  "test_event_code": "YOUR_TEST_CODE",
  "context": {
    "ad": {
      "callback": "123ATXSfe"
    },
    "page": {
      "url": "http://demo.mywebsite.com/purchase",
      "referrer": "http://demo.mywebsite.com"
    },
    "user": {
      "email": "a4ef46e711c986ea534c9c3d2a1fde303505b539ef5a7ec2a63f23a536d575d1"
    },
    "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. 前往 TikTok 广告管理平台的 Pixel 测试事件选项卡,在事件活动板块找到测试事件。平台将显示有效负载的所有问题,以便帮助您解决问题。

验证事件去重设置

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

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

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