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

验证线下事件 API 设置

验证事件是否被正确接收

导航到工具 > 事件 > 数据来源,进入线下事件组的详情页。

在概览选项卡下,可以验证是否已接收到您的事件。请刷新页面查看最新状态。 - 如果我们接收到了由事件 API 发送的事件,您将会在关联方式中看到"Server"(服务器)。 - 如果我们接收到了通过从浏览器上传文件发送的事件,您将会在关联方式中看到"Browser"(浏览器)。

测试事件

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

步骤

遵循以下步骤发送测试事件: 1. 在事件管理平台上,点击线下事件组查看配置详情。 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": "offline",
  "event_source_id": "{{Offline-Event-Set-ID}}",
  "test_event_code": "{{YOUR_TEST_CODE}}",
  "data": [
    {
      "event_id":"1616318632825_357",
      "event": "Purchase",
      "event_time": 1684574395,
      "user": {
        "email": ["848a771458438fc2ec420560d769fb9b9b86851ee338ec56517baabd79d3bb4f",
        "dd6ff77f54e2106661089bae4d40cdb600979bf7edc9eb65c0942ba55c7c2d7f"],
        "phone": ["2f9d2b4df907e5c9a7b3434351b55700167b998a83dc479b825096486ffcf4ea"]
       },
      "properties": {
        "order_id": "abc_xyz",
        "shop_id": "123abc",
        "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 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 每日平台更新简报 →