광고주를 위한 API 세팅 가이드 for CPS

요청 방향

BuzzAd → 광고주

HTTP Request method

GET

HTTP Request URL

광고주의 상품 리스트

HTTP Request parameters

Field 설명

• channel_id (Integer): optional 매체사 식별을 위한 아이디. 버즈빌이 광고를 받아 오는 것을 확인하기 위한 ID 를 담는 파라미터

Response

• JSON 형식으로 반환

• Field 설명은 아래 ‘5) Response Fields' 표 참고

list

list

상품 목록

• 자세한 아이템은 아래 'list 세부 항목' 표 참고

code

String

처리 결과 코드

• 200인 경우에만 정상

msg

String

처리 결과 메세지

id

Integer

필수 상품 아이디 (식별값)

title

String

필수 상품명

description

String

필수 상품 설명

icon

String

필수 상품 아이콘 이미지 url

landing_url

String

필수 상품 랜딩페이지 url

unit_price

Integer

필수 상품 판매당 버즈빌에 지급되는 수수료. 해당 수수료에는 매체비, 유저 리워드가 포함됩니다.

full_price

Integer

필수 상품의 정가
discounted_price를 주지 않는 경우, full_price가 실제 유저가 결제하는 금액이 됩니다.

discounted_price

Integer

optional (할인이 들어간 경우) 실제 유저가 지불하는 금액

category

Integer

필수 해당 상품의 카테고리
상품 카테고리명 각각에 대해 id값을 정하여 integer 형태로 전달이 필요합니다. 연동 커뮤니케이션 진행시 카테고리가 어떻게 구분되어지는지 정리된 목록 공유 부탁드립니다.

revenue_type

String

필수 광고 타입. 추후 새로운 타입이 추가될 수 있으므로 연동시 이를 고려해야 합니다.

• cps: 쇼핑 적립형 광고

images

list

필수 image 목록

• 자세한 아이템은 아래 'images 세부 항목' 표 참고

type

Integer

images type

• 1: native (height: 627 px, width: 1200 px)

• 2: lock (height: 2340 px, width: 1080 px)

image_url

String

상품 이미지를 받아올 수 있는 url