Collab-Meta 캠페인 매핑 생성/수정

Glowb의 Collab(캠페인)과 Meta 광고 캠페인을 연결합니다.

1:N 지원 — 한 Collab 에 여러 Meta 캠페인을 매핑할 수 있습니다. 같은 (collabNo, metaCampaignId) 쌍이 이미 있으면 캠페인명만 갱신(upsert), 새로운 쌍이면 신규 행으로 추가됩니다. 여러 건 일괄 매핑은 POST /mapping/bulk 또는 POST /mapping/bulk-pairs 사용.

관리자(ADMIN) 전용 엔드포인트입니다.

HTTP 요청

POST /ai/business/meta/mapping
Authorization: Bearer {admin_access_token}
Content-Type: application/json

Request Body

{
  "collabNo": 123,
  "metaCampaignId": "120243507818540347"
}

필드	타입	필수	설명
`collabNo`	`Integer`	예	Glowb Collab 번호
`metaCampaignId`	`String`	예	Meta 캠페인 ID

응답

성공 응답 (201 Created)

{
  "status": 201,
  "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`	`Long`	매핑 행 surrogate ID
`collabNo`	`Integer`	Glowb Collab 번호
`collabTitle`	`String`	Collab 제목
`metaCampaignId`	`String`	Meta 캠페인 ID
`metaCampaignName`	`String`	Meta 캠페인 최신명 (snapshot 기준)
`objective`	`String`	Meta 광고목표 원본 enum (예: `OUTCOME_SALES`)
`objectiveLabel`	`String`	광고목표 한글 라벨 (판매/클릭 유도/동영상 조회/잠재고객/앱 설치/참여/인지)
`primaryMetric`	`Object`	광고목표별 대표 KPI 1개 (아래)
`primaryMetric.label`	`String`	지표 한글 라벨
`primaryMetric.value`	`Long`	전체 누적 값
`primaryMetric.unit`	`String`	단위 (건/회/명)
`linkedAt`	`DateTime`	매핑 생성 시각

광고목표 → primaryMetric 매핑

objective (Meta enum 키워드)	한글 라벨	primaryMetric.label	데이터 소스
`OUTCOME_SALES` / `CONVERSIONS`	판매	구매 수	`actions[purchase]` 합계
`OUTCOME_TRAFFIC` / `LINK_CLICKS`	클릭 유도	링크 클릭 수	`actions[link_click]` 합계
`OUTCOME_VIDEO_VIEWS` / `VIDEO_VIEWS`	동영상 조회	3초 동영상 조회	`actions[video_view]` 합계
`OUTCOME_LEADS` / `LEAD_GENERATION`	잠재고객	잠재고객 수	`actions[lead*]` 합계
`OUTCOME_APP_PROMOTION` / `APP_INSTALLS`	앱 설치	앱 설치 수	`actions[mobile_app_install]` 합계
`OUTCOME_ENGAGEMENT` / `POST_ENGAGEMENT`	참여	참여 수	`actions[post_engagement]` 합계
`OUTCOME_AWARENESS` / `REACH`	인지	도달	`reach` 합계
(그 외 / null)	-	노출	`impressions` 합계

집계 기간은 매핑 캠페인의 적재된 daily 인사이트 전체(attribution_window=7d_click 기준).

에러 응답

상태 코드	설명
`403`	관리자가 아닌 경우
`404`	존재하지 않는 collabNo

POST /ai/business/meta/mapping