Admin APIMeta Marketing Insights
GET /ai/business/meta/mappings
Collab-Meta 캠페인 매핑 목록 조회
매핑 목록 조회
Collab과 Meta 캠페인의 매핑 목록을 조회합니다.
관리자는 5개 광고계정(글로우비/디웨더/리빙/Supera/건식건기식) 전체의 매핑을 조회하고, 기업 회원은 본인 Collab 의 매핑만 조회됩니다. 한 기업이 광고계정 N개를 운영하더라도 매핑은 광고계정 구분 없이 하나의 목록으로 합쳐서 반환 (기업 응답에 광고계정 정보 미노출).
1:N 지원 — 한 Collab 이 여러 Meta 캠페인에 매핑된 경우 응답에 행이 여러 줄로 나옵니다 (동일 collabNo, 다른 metaCampaignId).
HTTP 요청
GET /ai/business/meta/mappings
Authorization: Bearer {access_token}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "매핑 목록 조회 완료",
"data": [
{
"id": 1,
"collabNo": 123,
"collabTitle": "봄 시즌 뷰티 캠페인",
"metaCampaignId": "120243507818540347",
"metaCampaignName": "봄 시즌 프로모션 (개편)",
"objective": "OUTCOME_SALES",
"objectiveLabel": "판매",
"primaryMetric": {
"label": "구매 수",
"value": 152,
"unit": "건"
},
"linkedAt": "2026-04-06T10:00:00"
},
{
"id": 8,
"collabNo": 123,
"collabTitle": "봄 시즌 뷰티 캠페인",
"metaCampaignId": "120243512345678901",
"metaCampaignName": "봄 시즌 리타게팅",
"objective": "OUTCOME_TRAFFIC",
"objectiveLabel": "클릭 유도",
"primaryMetric": {
"label": "링크 클릭 수",
"value": 1840,
"unit": "건"
},
"linkedAt": "2026-05-15T18:50:00"
}
]
}응답 성능 — N건의 매핑이라도 snapshot/인사이트 lookup 각 1회 IN 쿼리로 batch 집계합니다 (attribution_window=7d_click). N+1 없음.
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
objective | String | Meta 광고목표 원본 enum (OUTCOME_SALES 등). null 가능 |
objectiveLabel | String | 한글 라벨 (판매/클릭 유도/동영상 조회/잠재고객/앱 설치/참여/인지). null 가능 |
primaryMetric | Object | 광고목표별 대표 KPI 1개. objective 가 null 이면 fallback(노출) 사용 |
광고목표 → primaryMetric 매핑은 POST /mapping 문서의 표 참고.
metaCampaignName 은 항상 최신값 — DB 매핑 테이블(TB_COLLAB_META_CAMPAIGN.meta_campaign_name) 은 매핑 생성 시점의 이름을 historical 기록으로 보존하지만, 응답 시에는 TB_META_OBJECT_SNAPSHOT 의 최신 캠페인 이름을 IN 쿼리로 batch lookup 하여 우선 반환합니다.