Facebook Insights API v18无法获取Ads Manager展示指标的技术问询

一、对应指标的API映射与获取方案 #

Ads Manager里的部分指标是聚合或别名，Insights API用不同字段或需要计算得到，以下是对应方案：

• Results & Cost per results
  这两个是广告目标相关的聚合指标，API没有直接同名字段，需根据你的广告目标匹配细分指标：

  • Results对应conversions字段，需指定具体action_type（比如电商转化用offsite_conversion.fb_pixel_purchase，表单提交用lead）；
  • Cost per results通过spend / conversions计算。
    调用示例：

  GET /act_<AD_ACCOUNT_ID>/insights?fields=spend,conversions&action_type=offsite_conversion.fb_pixel_purchase&level=ad
  

• Delivery
  对应API的delivery_info字段，返回投放状态（如delivery_status）、预估投放时间等数据。如果需要投放覆盖比例，需结合reach和targeting_estimate端点获取的潜在受众数计算。

• Post comments
  若要获取广告关联帖子的评论，可在Insights API请求中加入post_comments字段，注意将level设为ad或adset；也可通过/<AD_ID>/creative拿到关联帖子ID，再调用/<POST_ID>/comments获取完整评论列表。

• New messaging contacts & Cost per new messaging contacts

  • new_messaging_contacts是API直接支持的字段，请求时加入即可；
  • Cost per new messaging contacts通过spend / new_messaging_contacts计算。
    注：该指标仅对Messenger目标广告生效。

• 3-second video plays
  对应API的video_3_sec_watched_actions字段，请求时加入该字段即可获取，示例：

  GET /act_<AD_ACCOUNT_ID>/insights?fields=video_3_sec_watched_actions&level=ad
  

二、非API替代方案 #

如果API调用仍有障碍，可使用以下方式获取数据：

• Ads Manager自定义报表导出：在Ads Manager中创建包含目标指标的自定义报表，支持一键导出CSV/Excel，还可设置定时自动导出，适合非实时数据需求。
• Ads Manager批量操作：通过Ads Manager的批量编辑工具，导出包含所需指标的广告数据。

三、关键注意事项 #

• 权限验证：确保API令牌拥有ads_read、pages_read_engagement等必要权限，尤其是访问帖子评论、Messenger数据时；
• 指标适用范围：部分指标仅在特定广告类型（如视频广告、Messenger广告）或层级（ad/adset/campaign）下可用，需匹配对应维度请求；
• 字段别名差异：Ads Manager的指标名称多为用户友好的别名，需对照官方文档映射到API实际字段。

内容的提问来源于stack exchange，提问作者Tien Pham Van