转化 API

转化 API 网关：非网站服务器事件 API 支持

从 v1.6.0 起，转化 API 网关已开始支持特定 API 端点，广告主可通过此端点从他们的服务器将非网站事件发送至转化 API 网关。这与转化 API 直接方法相似。主要区别在于：通过此端点，事件将流经转化 API 网关，而不是直接发送至 Meta 图谱 API。

发送请求

如要发送新事件，请通过以下路径向此 API 的 /events 连线发出 POST 请求：https://<capig.instance.url>/capi/{PIXEL_ID}/events。

向此连线发出该请求时，Meta 即会新建服务器事件。

curl -i -X POST \
  -d '{
  "accessKey": "<ACCESS_KEY_VIA_CAPIG_UI>",
  "data": [
    {
      "event_name": "Purchase",
      "event_time": <Unix timestamp in seconds, must be within the last seven days>,
      "user_data": {
        "em": [
          "973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b"
        ],
        "ph": [
          "ce3a598687c8d2e5aa6bedad20e059b4a78cca0adad7e563b07998d5cd226b8c"
        ],
        "client_ip_address": "123.123.123.123",
        "client_user_agent": "CLIENT_USER_AGENT",
        "fbc": "fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
        "fbp": "fb.1.1558571054389.1098115397"
      },
      "contents": [
        {
          "id": "product123",
          "quantity": 1,
          "delivery_category": "home_delivery"
        }
      ],
      "custom_data": {
        "currency": "usd",
        "value": 123.45
      },
      "event_source_url": "http://test.com/product/123",
      "action_source": "website"
    }
  ]
}' \
https://<capig.instance.url>/capi/<PIXEL_ID>/events

生成访问密钥

可通过转化 API 网关的管理员控制台生成一个访问密钥，该密钥用于将 API 请求发送至转化 API 网关。

  • 登录转化 API 网关的管理员用户界面
  • 前往概览版块
  • 在希望生成访问密钥的“已绑定的 Meta Pixel 像素代码”行中，点击“...”
  • 点击生成访问口令

“转化 API 直接集成法”的访问口令不能用于向转化 API 网关端点发出服务器请求。

另请参阅