廣告洞察報告 API
廣告洞察報告 API 可提供 Meta 廣告的成效資料和統計資料。透過靈活的分析報告選項，您可以自訂要求，取得 Meta 廣告管理員所提供的幾乎所有衡量數據。
準備工作
若要使用廣告洞察報告 API，您需要以下項目：
- 一個應用程式。（詳情請參閱 Meta 應用程式開發。）
您亦應設定廣告來追蹤您感興趣的動作。您可以使用轉換 API 或 Meta 像素等工具來追蹤此類動作。
調用廣告洞察報告 API
廣告洞察報告 API 可用作所有廣告物件的關係連線。（在此處了解更多關於 Meta 廣告層級的詳情。）
| 資源 | 提供 |
|---|---|
廣告帳戶的洞察報告 | |
廣告宣傳活動的洞察報告 | |
廣告組合的洞察報告 | |
廣告洞察報告 |
根據預設，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"
}
}
}