如何通过FB API获取Insights API未提供的指定营销指标?
如何通过Facebook营销API拉取指定广告指标
首先,你提到的这些指标(从附图来看包含覆盖人数、触达次数、CPM、点击量、点击率、总花费、CPP等),绝大多数都可以通过Marketing API的Insights端点获取,只是需要正确匹配API字段和请求参数,以下是具体操作指南:
1. 指标与API标准字段对应
先把你需要的指标映射到FB官方定义的字段:
- 覆盖人数 →
reach - 触达次数 →
impressions - CPM →
cpm - 点击次数 →
clicks - 点击率 →
ctr - 总花费 →
spend - CPP →
cpp
2. 构造API请求示例
使用GET请求调用Insights端点,替换占位符为你的实际信息:
GET /v18.0/{你的广告账户ID}/insights?fields=reach,impressions,cpm,clicks,ctr,spend,cpp&level=ad&time_range={'since':'2024-01-01','until':'2024-01-31'}
关键参数说明:
level:指定数据层级,可选ad(广告层级)、adset(广告组)、campaign(广告系列),按需选择time_range:设置数据的时间范围,格式为JSON字符串,替换起止日期breakdowns:如果需要按维度拆分数据(比如设备、地域、受众年龄),可以添加该参数,示例:breakdowns=age,gender
3. 权限与访问令牌要求
确保你的应用满足以下条件:
- 已申请并获得
ads_read权限(读取广告数据的核心权限) - 已完成Facebook营销API的应用审核,拿到有效的访问令牌
4. 衍生指标的计算
如果某些指标没有直接对应的API字段,可以通过基础字段计算得出:
比如部分自定义效率指标,可通过spend(花费)、reach(覆盖人数)等基础字段做算术运算得到。
关于拆分功能的中文说明
你参考的官方文档中,Insights的拆分(Breakdowns)功能允许你按不同维度拆分广告数据,比如受众特征、设备类型、投放位置等。只需在API请求中添加breakdowns参数并指定拆分维度,就能获取对应维度下的细分指标数据。
内容的提问来源于stack exchange,提问作者Ibrahim
相关产品推荐
相关产品推荐

