Channel

채널 상세 조회

채널 단건을 상세 조회한다. 채널 정보와 함께 광고 상품 목록, 오디언스 규모 지표, 집행 사례를 반환한다. 상품이 없는 채널은 products 를 빈 배열로 반환한다.

추천 목록에서 들어온 경우 그 추천의 onboardingId 를 함께 넘기면, 추천 근거가 된 온보딩 선택지(광고 목표·업종·예산)를 recommendationBasis 로 반환한다.

매체 키워드(tags)는 채널 고유의 키워드라 맞춤 여부와 무관하게 누구에게나 같은 값을 최대 2개까지 준다.

get/api/v1/channels/{id}

Request

Base URL: https://api.chaeso-zip.com
URL: https://api.chaeso-zip.com/api/v1/channels/{id}
Auth: HTTP bearer

Path parameters

idstring uuid required

채널 식별자

Query parameters

onboardingIdstring uuid

추천 목록에서 진입한 경우 그 추천의 온보딩 식별자. 생략하면 추천 근거 없이 상세만 반환한다

Response

조회 성공

successboolean required

요청 성공 여부

codestring nullable required

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

Example response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "11번가 광고",
    "tagline": "월 방문자 수 상위 오픈마켓",
    "iconUrl": "https://assets.chaeso-zip.com/channels/550e8400-e29b-41d4-a716-446655440000/icon.png",
    "primaryCategory": "SHOPPING_COMMERCE",
    "mediaType": "DISPLAY",
    "primaryGender": "FEMALE",
    "executionType": "SELF",
    "products": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "supportedObjectives": [
          "AWARENESS",
          "TRAFFIC"
        ],
        "expectedClicks": 5250,
        "pricing": [
          {
            "pricingModel": "CPM",
            "priceType": "LIST",
            "vat": "EXCLUDED",
            "currency": "KRW"
          }
        ],
        "isExecutable": true
      }
    ],
    "audienceMetrics": [
      {
        "metricName": "MAU",
        "unit": "명",
        "period": "월"
      }
    ],
    "recommendationBasis": {
      "objective": "TRAFFIC",
      "category": "SHOPPING_COMMERCE",
      "budgetMin": 1000000,
      "budgetMax": 3000000
    },
    "tags": [
      "커머스 특화",
      "구매의도 타겟"
    ]
  },
  "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.