Admin APIMeta Marketing Insights
GET /ai/business/meta/business-mappings
Business ↔ Meta 캠페인 직접 매핑 전체 목록 조회 (ADMIN 전용)
Business-Meta 캠페인 매핑 목록
ADMIN 이 만든 모든 Business 직접 매핑(X 매핑) 목록을 반환합니다. Collab 매핑(O) 목록은 GET /mappings 를 참고하세요.
내부적으로는 TB_COLLAB_META_CAMPAIGN 의 collab_no IS NULL row 를 반환합니다.
metaCampaignName 은 TB_META_OBJECT_SNAPSHOT 의 최신 캠페인 이름을 IN 쿼리 batch lookup 으로 우선 반환합니다 (snapshot 미스 시 매핑 생성 시점 stale 값으로 fallback). Meta 측 캠페인명 변경 시 다음 :10 active batch 사이클에 자동 갱신됩니다.
HTTP 요청
GET /ai/business/meta/business-mappings
Authorization: Bearer {admin_access_token}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "Business 매핑 목록 조회 완료",
"data": [
{
"id": 7,
"businessId": "biz_member_id",
"metaCampaignId": "120244131245240347",
"metaCampaignName": "봄 시즌 프로모션",
"objective": "OUTCOME_SALES",
"objectiveLabel": "판매",
"primaryMetric": {
"label": "구매 수",
"value": 152,
"unit": "건"
},
"linkedAt": "2026-05-14T11:30:00"
}
]
}응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
id | Long | 매핑 row ID |
businessId | String | 기업 멤버 ID (TB_MEMBER.id) |
metaCampaignId | String | Meta 캠페인 ID |
metaCampaignName | String? | 캠페인 이름 (snapshot 최신값 우선, 미스 시 매핑 시점 stale) |
objective | String? | Meta 광고목표 원본 enum |
objectiveLabel | String? | 광고목표 한글 라벨 |
primaryMetric | Object? | 광고목표별 대표 KPI 1개 — 매핑 표·메인 화면 노출용. 자세한 매핑 표는 POST /mapping 참고 |
linkedAt | String | 매핑 생성 시각 |
에러 응답
| 상태 코드 | 설명 |
|---|---|
403 | ADMIN 권한 없음 |