Recommendation

온보딩 기반 채널 추천

온보딩 응답을 업종·광고 목적·타깃 연령대로 매칭해 적합한 채널을 적합도 순으로 반환한다.

적합도가 같으면 집행 가능한 채널을 먼저, 그다음 매체명 순으로 정렬한다.

매체별로 단가가 가장 싼 상품을 대표로 삼고, 온보딩 예산의 상한(budgetMax)과 집행 기간을 적용한다. 예산이 최소 단가에 못 미치는 채널도 적합도가 있으면 추천에 넣되, 노출·클릭은 최소 단가로 집행했을 때를 기준으로 채우고 부족액(shortfallWon)을 함께 준다.

get/api/v1/recommendations

Request

Base URL: https://api.chaeso-zip.com
URL: https://api.chaeso-zip.com/api/v1/recommendations
Auth: none declared

Query parameters

onboardingIdstring uuid required

온보딩 응답 식별자

Response

추천 성공. 맞는 채널이 없으면 빈 배열

successboolean required

요청 성공 여부

codestring nullable required

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

Example response

{
  "success": true,
  "data": [
    {
      "channelId": "550e8400-e29b-41d4-a716-446655440000",
      "channelName": "11번가 광고",
      "wordmarkUrl": "https://assets.chaeso-zip.com/channels/550e8400-e29b-41d4-a716-446655440000/wordmark.png",
      "matchRate": 78,
      "recommendationReason": "쇼핑·커머스 업종, 설정한 광고 목적에 적합하고 예산 내 집행이 가능해요",
      "primaryTarget": "20~40대 여성",
      "cpcWon": 150,
      "pricingModel": "CPM",
      "minBudgetWon": 3000000,
      "estImpressions": {
        "min": 170000,
        "max": 230000
      },
      "estClicks": {
        "min": 170000,
        "max": 230000
      },
      "shortfallWon": 500000
    }
  ],
  "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.