멀티 미션 광고 S2S API 연동 가이드 (네이버 웹툰)

요청 방향

매체사 → BuzzAd

HTTP Request method

GET

HTTP Request URL

https://ad.buzzvil.com/api/v1/list

HTTP Request parameters

Field 설명

• unit_id (Integer) : 매체사 식별을 위한 아이디

Response

• JSON 형식으로 반환

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

ads

list

광고 목록

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

code

String

처리 결과 코드

• 200인 경우에만 정상

msg

String

처리 결과 메세지

id

Integer

광고 아이디 (식별값)

title

String

광고 제목

description

String

광고 설명

action_description

String

광고 적립방법 설명

icon

String

아이콘 이미지 주소

revenue

Decimal

매체사 단가

revenue_type

String

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

• cpi: 앱 설치형

• cpe: 앱 실행형 또는 앱 실행후 액션형

• cpa: 액션형

• cpl: 페이스북 좋아요

• cpinsta: 인스타그램 팔로우

• cps: 쇼핑 적립형 광고

• cpyoutube: 유튜브 광고

• cpq: 퀴즈형

• cpk: 카카오톡 채널 참여하기

• cpylike: 유튜브 구독 + 영상 좋아요 광고

• cptiktok: 틱톡 팔로우

• cpnstore : 네이버 스마트스토어 찜

• cpqlite : 퀴즈형

• cpcquiz : 퀴즈 적립 컨텐츠

예제) “cpc”

package_name

String

안드로이드 package_name

url_scheme

String

아이폰 url scheme

platform

String

광고가 지원되는 플랫폼

• A: 안드로이드

• I: 아이폰

• W: 안드로이드/아이폰 둘 다 지원

age_from

Integer

나이 하한 타게팅. 타게팅이 없는 경우 null

age_to

Integer

나이 상한 타게팅. 타게팅이 없는 경우 null

age_ranges

JSON

다 구간 나이 타게팅. age_ranges를 사용하는 경우 age_from, age_to 값은 무시해도 된다.

• 타게팅이 없는 경우

[]

• 타게팅이 있는 경우

[{"from":10, "to":20}, {"from":30, "to":40}]

sex

String

성별 타게팅. 타게팅이 없는 경우 null

• M: 남자

• F: 여자

relationship

String

결혼 유무 타게팅. 타게팅이 없는 경우 null

• S: 미혼

• M: 기혼

carrier

String

통신사 타게팅. 타게팅이 없는 경우 null

• kt: KT 통신사

• skt: SKT 통신사

• lgt: LGT 통신사

udid_required

Bool

• true: 광고 참여/참여완료 요청시 udid 파라미터 필수

• false: 광고 참여/참여완료 요청시 udid 파라미터 필수 아님

device_name

String

디바이스 모델 타게팅

• 콤마(,)로 구분된 디바이스 모델명

• OR 조건

• ex) SHV-E250S,SHV-E275K,SM-G928L → SHV-E250S 또는 SHV-E275K 또는 SM-G928L 인 유저에게 타게팅

target_app

String

앱 타게팅 (안드로이드만 지원)

• 콤마(,)로 구분된 패키지 네임으로, 해당 앱이 설치된 유저에게 타게팅

• 패키지 네임 앞에 ‘-’ 기호가 있는 경우 설치되지 않은 유저에게 타게팅

• OR 조건

• ex1) Pl.idreams.skyforcehd,com.imangi.templerun2 → Pl.idreams.skyforcehd 또는 com.imangi.templerun2 가 설치된 유저에게 타게팅

• ex2) com.thinkreals.couponmoa,-com.supercell.clashofclans → com.thinkreals.couponmoa가 설치되어 있거나 com.supercell.clashofclans가 설치되어 있지 않은 유저에게 타게팅

region

String

지역 타게팅

• 콤마로 구분된 지역: 도/시 단위로 타게팅 가능

• OR 조건

• ex) 서울특별시 강남구,경상남도 → 서울특별시 강남구 또는 경상남도에 거주중인 유저에게 타게팅

creative

list

creative 목록

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

is_multi_mission신규(25.02~)

Bool

멀티 미션 포함 여부

(True: 멀티 미션 광고 / False: 일반 CPA 광고)

missions신규(25.02~)

list

missions 목록

ID

Integer

creative ID

short_action_description

String

짧은 참여방법/주의사항 기재

height

integer

native creative 가 세팅 되어 있는 경우 627 (고정값), 없는 경우 0

width

integer

native creative 가 세팅 되어 있는 경우 1200 (고정값), 없는 경우 0

action_description

String

참여방법 및 주의사항이 기재
22자 권장, 최대 40자

call_to_action

String

ex) 팔로워 누르러 가기

image_url

String

Native creative가 세팅되어 있을 경우에만 native 타입의 이미지 파일 url이 담김

icon

String

오퍼월 리스트내에 볼수 있는 아이콘 이미지

mission_id

Integer

멀티 미션 광고 식별값(ID)

mission_type

String

멀티 미션 광고유형

"multi_event"
"screenshot"
"quiz"

title

String

멀티 미션 광고명

description

String

멀티 미션 광고 설명

revenue

Decimal

멀티 미션 광고 당 지급되는 매체 수수료