本指南将向您展示如何实现 Audience Network 报告 API 第 2 版 (v2) 以获取企业表现数据。
read_audience_network_insights
权限并取得成功
查询版位在 2022 年 5 月 1 日至 4 日间的展示次数和收入,以及每日细分数据。
可能变更的内容:变更后,可能会有一些数据不可用。
因展示次数不足而无法获得的收入和 CPM 数据点不会包含在 API 响应的 results
字段中。但系统会将相应条目添加到 omitted_results
字段。这些条目包括 time、metric 和 breakdowns 字段,但不包括 value 字段。请参阅本页底部的响应示例。
使用 GET ID > adnetworkanalytics 端点获取对企业、资产或应用的 Audience Network 成效分析。
GET /<ID>/adnetworkanalytics
如要获取成效分析,请向 /<ID>/adnetworkanalytics
端点发送 GET
请求,在请求中加入用逗号分隔的指标清单,您也可以加入用逗号分隔的细分条件清单,<ID>
是您的 Meta 企业编号、资产编号或应用编号。以下示例获取 24 小时内的指标,并限定每个指标获取 2 个响应。
curl -X GET https://graph.facebook.com/v19.0
/BUSINESS_ID/adnetworkanalytics
?metrics=["fb_ad_network_request","fb_ad_network_imp","fb_ad_network_click","fb_ad_network_revenue"]
&breakdowns=["placement","country"]
&since=2021-08-06
&until=2021-08-06
&limit=2
{ "data": [ { "query_id": "531234567890123456789012345683d6", "results": [ { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_imp", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AE" } ], "value": "1200" }, { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_imp", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AU" } ], "value": "35" }, { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_revenue", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AE" } ], "value": "21.212345" }, { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_request", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AD" } ], "value": "1" }, { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_request", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AE" } ], "value": "12" }, { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_click", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AE" } ], "value": "1" }, { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_click", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "CA" } ], "value": "2" } ], "omitted_results": [ { "time": "2021-08-06T07:00:00+0000", "metric": "fb_ad_network_revenue", "breakdowns": [ { "key": "placement", "value": "123456789012345" }, { "key": "country", "value": "AU" } ] } ] } ], "paging": { "cursors": { "before": "MAZDZD", "after": "MQZDZD" }, "next": "https://graph.facebook.com/v10.0/142440604406900/adnetworkanalytics?access_token=<ACCESS_TOKEN>&since=2021-08-06&until=2021-08-06&breakdowns=%5B%22placement%22%2C%22country%22%5D&limit=2&metrics=%5B%22fb_ad_network_request%22%2C%22fb_ad_network_imp%22%2C%22fb_ad_network_click%22%2C%22fb_ad_network_revenue%22%5D&after=MQZDZD" } }
参数 | 描述 | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
按 | ||||||||||||||||||
|
同步请求对可包含的细分条件数量没有限制。
| ||||||||||||||||||
|
进一步筛选响应以获取更具体的结果。
| ||||||||||||||||||
|
返回的行数。限制:同步请求的数量上限为 2,000。 | ||||||||||||||||||
| 必要。
至少需要 1 项指标,但请求中可包含的指标数量没有限制。 | ||||||||||||||||||
|
按时间或值对结果排序。如果未添加此参数,默认值为 | ||||||||||||||||||
|
如果未添加此参数,默认值为 | ||||||||||||||||||
|
查询的起始时间限制。如果未添加此参数,默认为过去 7 天。 限制:
| ||||||||||||||||||
|
查询的结束时间限制 |
指标 | 描述 |
---|---|
| 竞价响应率 |
| 竞价请求数量 |
| 竞价响应数量 |
| 竞价工具赢得竞拍的比率 |
| 点击量 |
| 有效千次展示费用 (eCPM) |
| 预估点击率 |
| 广告请求填充率 |
| 填充的广告请求数量 |
| 展示次数 |
| 未竞价主因数量 仅适用于用作单个指标 |
| 无填充主因数量 仅适用于用作单个指标 |
| 广告请求数量 |
| 预估收入 |
| 展示数除以填充请求数 |
使用访问口令调试工具 获取访问口令的详细信息,包括权限、有效期、资产访问权限以及与该口令关联的应用编号。
错误消息/问题 | 解决方案 |
---|---|
口令过期 | 如要打造最佳用户体验,请使用长期访问口令 |
“Facebook 检测到 [您的应用] 在使用 | 确保您的企业已注册变现管理工具,并且已创建至少 1 项资产。 |
“正在读取不属于查询用户或应用程序的公共主页、企业、应用、域或事件源组的成效分析。” | 检查业务设置,以确保请求的数据属于查询的企业。 |
“不支持 | 检查资产,以确保请求的是您拥有的资产数据。 |
“访问报告 API v2.0 的方式已更改。现在需要为应用使用 Facebook 登录才能访问此 API。如需查看说明,请点击此处:https://developers.facebook.com/docs/facebook-login/” | 您尝试了使用系统用户口令查询报告 API v2。通过 Facebook 登录进行查询,或还原到 v1(但日后无论如何均需设置 Facebook 登录)。 |
“参数错误:所有应用程序均应包含资产” | 确保您的企业已注册变现管理工具,并且已创建至少 1 项资产。 |
“请减少请求的数据量,然后重新尝试请求。” |
|
“每分钟最多执行 250 次查询” | 报告 API V2 允许请求使用多个参数,且允许使用分页功能。请了解尽量少用 API 请求的方式。 |