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

验证事件 API 设置

本文介绍了如何验证应用数据连接设置,主要包括以下流程: - 验证事件是否被正确接收 - 验证事件的配置和触发是否正确

验证事件是否正确接收

您可以通过应用详情页来确认我们是否已接收到您的事件。点击进入应用详情页的概览选项卡,滚动到报告部分: 1. 确保数据源设置为 TikTok 应用事件 API。 2. 检查事件总数。请注意,此计数可能会有轻微延迟。

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

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

步骤

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

Test event

  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": "app",
  "event_source_id": "{{TIKTOK_APP_ID}",
  "test_event_code": "{{YOUR_TEST_CODE}}",
  "data": [
    {
      "event": "InstallApp",
      "event_time": 1684574395,
      "user": {
        "phone": "{{HASHED_PHONE}}",
        "email": "{{HASHED_EMAIL}}",
        "idfa": "{{IDFA}}",
        "idfv": "{{IDFV}}",
        "gaid": "{{GAID}}",
        "att_status": "AUTHORIZED"
        "locale": "en-US"
      },
      "app": {
        "app_id": "com.test.flyingsneakers"
        "app_name": "Flying Sneakers"
        "app_version": "3.0.2"
      },
      "ad": {
        "attributed": true,
        "callback": "{{CALLBACK}}",
        "campaign_id": "1700817380525057",
        "ad_id": "1700817380806706",
        "creative_id": "1700817378256945"
        "is_retargeting": false,
        "attribution_type": "click_through"
      },
      "properties": {
        "contents": [
          {
            "currency": "USD",
            "value": 200.0
            "content_type": "product",
          {
            "price": 100.0,
            "quantity": 2,
            "content_id": "12345",
            "content_name": "Fancy-AirMax2.0 Black",
            "content_category": "Shoes - running shoes",
            "brand": "Fancy Sneakers"
          }
        ]
      }
    }
  ]
}'
(/code)
  1. 前往 事件管理平台的 Pixel 测试事件选项卡,在事件活动板块找到测试事件。平台将显示有效负载的所有问题,以便帮助您解决问题。

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