报告 API 第 2 版

本指南将向您展示如何实现 Audience Network 报告 API 第 2 版 (v2) 以获取企业表现数据。

前提条件

• 具备 Facebook 登录用例 以及“read_audience_network_insights”权限的 Meta 应用
• 在您应用中实现了 Facebook 登录
• 测试查询图谱 API 端点 以及 read_audience_network_insights 权限并取得成功
• 成功完成 Meta 应用审核
• 长期用户访问口令

建议

• 鉴于每次查询都会返回大量数据，建议使用基于光标的分页 。针对同步请求，系统会立即返回分页结果。对结果分页也是检索细分数据时的首选方法。

限制

• 所有数据的返回时间均按格林威治标准时间 (GMT) 时区计算
• 系统基于展示次数返回收入指标

  • 如果数据不可用，我们建议查询总展示次数和收入
• 变现管理工具或商务管理平台中生成的用户访问口令无法使用

汇总更新

单日展示次数和收入

查询版位在 2022 年 5 月 1 日至 4 日间的展示次数和收入，以及每日细分数据。

可能变更的内容：变更后，可能会有一些数据不可用。

因展示次数不足而无法获得的收入和 CPM 数据点不会包含在 API 响应的 results 字段中。但系统会将相应条目添加到 omitted_results 字段。这些条目包括 time、metric 和 breakdowns 字段，但不包括 value 字段。请参阅本页底部的响应示例。

请求语法

使用 GET ID > adnetworkanalytics 端点获取对企业、资产或应用的 Audience Network 成效分析。

GET /<ID>/adnetworkanalytics

GET 请求示例

如要获取成效分析，请向 /<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"
  }
}

参考文档

查询参数

可用指标

疑难解决

访问口令调试工具

使用访问口令调试工具 获取访问口令的详细信息，包括权限、有效期、资产访问权限以及与该口令关联的应用编号。

错误消息