如何通过Facebook Graph API获取自定义事件并设置自定义转化event参数

1. 获取账户内的自定义事件 #

要获取广告账户下的所有自定义事件，调用Graph API的广告账户自定义事件端点，请求方式为GET：

请求示例 #

curl -G \
  -d "access_token=<你的访问令牌>" \
  "https://graph.facebook.com/v17.0/act_{你的广告账户ID}/custom_events"

返回说明 #

响应结果会包含账户内所有自定义事件的详细信息，其中name字段就是后续创建自定义转化时需要的事件名称，可从中筛选出目标事件。

2. 基于选中的自定义事件创建自定义转化 #

调用自定义转化创建端点，指定从第一步筛选出的事件名称作为event_name参数，同时配置转化规则：

单个事件匹配请求示例 #

curl -X POST \
  -d "access_token=<你的访问令牌>" \
  -d "name=我的自定义转化" \
  -d "event_name=选中的自定义事件名" \
  -d "rule={\"event\":\"选中的自定义事件名\"}" \
  "https://graph.facebook.com/v17.0/act_{你的广告账户ID}/custom_conversions"

多个事件匹配请求示例 #

如果需要匹配多个自定义事件，可在rule参数中使用or逻辑组合：

curl -X POST \
  -d "access_token=<你的访问令牌>" \
  -d "name=多事件自定义转化" \
  -d "event_name=主要事件名" \
  -d "rule={\"or\":[{\"event\":\"事件A\"},{\"event\":\"事件B\"}]}" \
  "https://graph.facebook.com/v17.0/act_{你的广告账户ID}/custom_conversions"

注意事项 #

• 确保访问令牌拥有ads_management、business_management等必要权限；
• 使用与文档一致的API版本（示例为v17.0）；
• rule参数需为合法的JSON格式，注意转义特殊字符。

内容的提问来源于stack exchange，提问作者Mateus Alves de Oliveira