Admin APIMeta Marketing Insights
GET /ai/business/meta/campaigns/{campaignId}/insights
Meta 특정 캠페인 인사이트 조회 (기업 회원용)
캠페인 인사이트 조회
특정 캠페인의 성과 지표를 조회합니다. level=adset 또는 level=ad로 하위 단위로 집계도 가능합니다.
결과는 Redis에 1시간 캐싱됩니다.
HTTP 요청
GET /ai/business/meta/campaigns/{campaignId}/insights
Authorization: Bearer {business_access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignId | String | 예 | 캠페인 ID |
Query Parameters
| 파라미터 | 기본값 | 설명 |
|---|---|---|
level | campaign | 집계 단위: campaign | adset | ad |
datePreset | last_30d | 기간 프리셋 |
since | - | 시작일 YYYY-MM-DD |
until | - | 종료일 YYYY-MM-DD |
timeIncrement | - | 1(일별) | 7(주별) | monthly |
attributionWindows | 7d_click | 기여 기간: 1d_click | 7d_click | 28d_click | 1d_view | 7d_view |
실제 호출 예시
# 캠페인 내부 - 광고세트별 집계
GET /ai/business/meta/campaigns/120243507818540347/insights
?level=adset&datePreset=last_7d&attributionWindows=7d_click
# 캠페인 내부 - 광고별 집계
GET /ai/business/meta/campaigns/120243507818540347/insights
?level=ad&datePreset=last_7d&attributionWindows=7d_click응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "캠페인 인사이트 조회 완료",
"data": [
{
"campaignId": "120243507818540347",
"campaignName": "봄 시즌 프로모션",
"adsetId": "987654321",
"adsetName": "Female 20-35 Seoul",
"impressions": "44024",
"reach": "25111",
"clicks": "2882",
"spend": "184585",
"ctr": "6.546429",
"cpc": "64.047536",
"cpm": "4192.82664",
"frequency": "1.753176",
"actions": [
{ "actionType": "purchase", "value": "2", "value1dClick": null, "value7dClick": "2", "value28dClick": null, "value1dView": null, "value7dView": null },
{ "actionType": "link_click", "value": "821", "value1dClick": null, "value7dClick": null, "value28dClick": null, "value1dView": null, "value7dView": null },
{ "actionType": "video_view", "value": "13198", "value1dClick": null, "value7dClick": null, "value28dClick": null, "value1dView": null, "value7dView": null }
],
"costPerActionType": [
{ "actionType": "purchase", "value": "92292.5", "value1dClick": null, "value7dClick": "92292.5", "value28dClick": null, "value1dView": null, "value7dView": null },
{ "actionType": "link_click", "value": "224.829476", "value1dClick": null, "value7dClick": null, "value28dClick": null, "value1dView": null, "value7dView": null }
],
"dateStart": "2026-03-30",
"dateStop": "2026-04-05"
}
]
}