调用广告成效分析 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"
}
}
}