ChannelComparison

채널 비교 결과 저장

요청할 때마다 스냅샷 형태로 새로 저장 된다. 이후 채널 단가/상품이 바뀌어도 저장된 값은 그대로 유지된다.

온보딩 O: 적합도순 정렬로 저장, 본인 온보딩만 사용 가능 온보딩 X: 요청 순서 그대로 저장, serviceName 필수

로그인한 사용자만 저장할 수 있다.

post/api/v1/channel-comparisons

Request

Base URL: https://api.chaeso-zip.com
URL: https://api.chaeso-zip.com/api/v1/channel-comparisons
Auth: HTTP bearer

Request body

channelIdsstring[] required

비교할 채널 식별자 목록. 2개 이상 3개 이하

onboardingIdstring uuid nullable

저장 근거가 된 온보딩 응답 식별자(선택)

serviceNamestring nullable

onboardingId 없을 때만 쓰는 서비스명

Example request

{
  "channelIds": [
    "550e8400-e29b-41d4-a716-446655440000",
    "9c1e8c2a-3f4d-4a5b-9c6d-7e8f9a0b1c2e"
  ],
  "onboardingId": "550e8400-e29b-41d4-a716-446655440000",
  "serviceName": "채소집"
}

Response

저장 성공

successboolean required

요청 성공 여부

codestring nullable required

성공 안내 코드. 안내할 것이 없으면 null

Example response

{
  "success": true,
  "data": {
    "comparisonId": "550e8400-e29b-41d4-a716-446655440000",
    "items": [
      {
        "channelId": "550e8400-e29b-41d4-a716-446655440000",
        "channelName": "11번가 광고",
        "iconUrl": "https://assets.chaeso-zip.com/channels/550e8400-e29b-41d4-a716-446655440000/icon.png",
        "tags": [
          "커머스 특화",
          "구매 전환"
        ],
        "matchRate": 78,
        "estImpressions": {
          "min": 170000,
          "max": 230000
        },
        "estClicks": {
          "min": 170000,
          "max": 230000
        }
      }
    ]
  },
  "error": {
    "code": "C-001",
    "message": "입력값이 올바르지 않습니다.",
    "fieldErrors": [
      {
        "field": "name",
        "reason": "이름은 필수입니다."
      }
    ]
  },
  "code": "GOOGLE_ACCOUNT_LINKED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.