廣告洞察報告 API

廣告洞察報告 API 提供 Meta 廣告的成效資料和統計資料。透過彈性的分析報告選項，您可以自訂您的要求，取得 Meta 廣告管理員提供的幾乎所有衡量指標。

開始之前

若要存取廣告洞察報告 API，您必須先備妥以下項目：

應用程式（若需詳細資訊，請參閱 Meta 應用程式開發）。
ads_read 權限（若需詳細資訊，請參閱權限和授權）。

您也應先設定廣告，以追蹤您感興趣的動作。轉換 API 或 Meta 像素等工具可協助您做到這點。

呼叫廣告洞察報告 API

廣告洞察報告 API 可經由所有廣告物件的關係連線來存取（若需瞭解 Meta 廣告階層的詳細資訊，請前往這裡查看）。

相關資源	提供項目
`/{ad-account-id}/insights`	廣告帳號洞察報告
`/{campaign-id}/insights`	廣告行銷活動洞察報告
`/{ad-set-id}/insights`	廣告組合洞察報告
`/{ad-id}/insights`	廣告洞察報告

預設情況下，GET 要求會傳回廣告物件的基本衡量指標，通常是過去 30 天的衡量指標。

要求範例

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

回應範例：

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

自訂要求

您可以利用要求中的三個主要元件取得更確切的資料：參數（用於指定時間範圍、歸因期間等等）、欄位（即衡量指標）和資料解析。例如，若要知道行銷活動過去 7 天內的點擊次數（總計）並依性別區分，您可以在要求中加入：

參數：date_preset=last_7d
欄位：clicks
資料解析：gender

要求範例

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights"

回應範例

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

瞭解詳情

廣告洞察報告 API 的功能強大，因此請務必繼續閱讀以下資料，瞭解如何精通各項功能：

參數和欄位
衡量指標
資料解析
非同步要求
限制和最佳作法
轉換分析報告、商品層級分析報告和行銷組合模型的專用指南

您也可以針對每個廣告物件的洞察報告關係連線，額外查閱自動產生的參考文件：

如果您打算在解決方案中加入廣告洞察報告 API 的資料，也請參閱 Meta《開放平台使用條款》和《行銷 API 開發人員政策》。