Recommendation

저장된 채널 추천 상세

저장된 추천 1건을 매체별 항목까지 재계산 없이 그대로 반환한다.

적합도·추천 근거·단가·노출/클릭 추정·부족액은 모두 저장 시점 값이라, 이후 채널의 단가나 상품이 바뀌어도 달라지지 않는다. 매체명만 채널을 알아볼 수 있게 지금 이름으로 준다.

get/api/v1/recommendations/{recommendationId}

Request

  • Base URL: https://api.chaeso-zip.com
  • URL: https://api.chaeso-zip.com/api/v1/recommendations/{recommendationId}
  • Auth: HTTP bearer

Path parameters

recommendationIdstring uuid required

저장할 때 발급된 추천 id

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.