分析報告 API 第 2 版

本指南為您介紹透過執行 Audience Network 分析報告 API 第 2 版（v2）獲取企業成效資料的方法。

必要條件

• 以 Facebook 登入為使用案例 並擁有「read_audience_network_insights」權限的 Meta 應用程式
• 您的應用程式使用 Facebook 登入
• 對 Graph API 端點 和 read_audience_network_insights 權限的成功測試查詢
• 成功完成 Meta 應用程式審查
• 長期用戶存取憑證

建議

• 由於每次查詢都有大量資料傳回，我們建議使用游標型分頁 。如果是同步要求，分頁結果會即時傳回。這是檢索資料細節的首選方法。

限制

• 所有資料將會以格林威治標準時間時區傳回
• 收益衡量數據根據展示次數傳回

  • 如果資料無法提供，我們建議查詢總展示次數和收益
• 營利管理工具或企業管理平台產生的用戶存取憑證無法使用

彙總整理功能更新內容

每日展示次數和收益

此例子查詢 2022 年 5 月 1 日至 4 日某版位的展示次數和收益，並且取得當中的每日資料細節。

可能發生的改變：在此變更生效後，您可能無法查看某些資料。

由於 API 回應中的「results」欄位不會顯示數量太少的展示次數，因此系統不會在此處顯示收益和每千次廣告展示成本資料點，而是會在「omitted_results」欄位中加入相應條目，當中會顯示「time」、「metric」和「breakdowns」欄位，但不會顯示具體數值；詳情請參閱本頁面底部的回應範例。

要求語法

使用 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"
  }
}

參考資料

查詢參數

可用衡量數據

疑難排解

存取憑證除錯工具

使用存取憑證除錯工具 獲取存取憑證的詳細資訊，其中包括與此憑證相關的權限、有效性、資產存取權和應用程式編號。

錯誤訊息