목차
Table of Contents | ||||
---|---|---|---|---|
|
...
필드 | 유형 | 설명 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
app_id | Integer | 매체 앱 아이디 | ||||||||
unit_id | Integer | 매체 지면 아이디 | ||||||||
ifa | String | 사용자의 광고식별자. 광고 타게팅 및 어뷰징 필터링, CS 처리를 위해 필요합니다. 광고식별자 수집이 불가능할 경우 uuid 포맷을 모두 0으로 채워 요청해야 합니다. 예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 광고식별자 수집이 불가능할 경우 전달 값) 00000000-0000-0000-0000-000000000000 | ||||||||
user_id | String | 사용자 고유 식별자입니다. 서비스 도중 변하지 않는 고정 값이며, 광고 할당을 위한 필수 정보입니다.
| ||||||||
client_ip | String | 광고에 참여한 유저의 ip 실제 유저의 ip 값을 전달해 주어야 합니다. 그러지 않을 경우 CPE, CPA 유형의 광고 송출이 불가합니다. 예제) 123.123.123.123 | ||||||||
ifv | string | iOS 앱 벤더식별자(IDFV). iOS에서 유저가 앱 추적 허용을 하지 않아 광고식별자 수집이 불가능할 경우엔 필수로 전달해주어야 하는 값입니다. 사용자 식별을 위한 대체식별자로 사용됩니다. 예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 | ||||||||
birthday | String | 유저의 생년월일 생년월일 정보가 없을 경우 일부 광고가 할당에서 제외됩니다. 예제) 1993-01-09 ( O )19930109 ( X ) | ||||||||
gender | String | 성별 타게팅을 위한 정보. 성별 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.
| ||||||||
revenue_types | String | 할당 받을 광고 상품 타입. 값이 비어있을 경우, 노출형 광고(cpm, cpc)만 할당됩니다. 할당을 원하지 않는 상품타입이 있다면, 상품타입값 앞에 음수기호(-)를 추가하면 됩니다. 예제) ‘[“cpc”, “cpm”, “cpq”, “cpinsta”, “cpa”, “cpk”, “cpl”, “cpcquiz”]’ 인코딩 주의 %5B%22cpm%22%2C%22cpa%22%2C%22cpq%22%2C%22cpinsta%22%2C%22cpk%22%2C%22cpl%22%2C%22cpc%22%5D 액션형 광고만 할당받는 예제) [“-cpc”, “-cpm”] | ||||||||
platform | String | 기기의 OS 정보
| ||||||||
country | String | 요청 IP의 국가 정보. 현재는 국내 광고만 송출되고 있기 때문에 | ||||||||
carrier | String | 통신사 정보. 통신사 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.
| ||||||||
device_name | String | 디바이스 모델명 디바이스 모델명이 없을 경우 일부 광고가 할당에서 제외됩니다.
| ||||||||
latitude | Float | 위도 와 경도. 지역별 광고 타게팅에 사용됩니다. 정보가 없을 경우 일부 광고가 할당에서 제외됩니다. | ||||||||
longitude | Float | |||||||||
user_agent | String | User Agent. 정보가 없을 경우 일부 광고가 할당에서 제외됩니다. | ||||||||
target_fill | Int | 할당받을 광고갯수. 한번에 할당 가능한 최대 target_fill은 20 입니다. | ||||||||
cursor | String (MAX 3000) | 할당에서 제외할 광고 데이터 할당 요청에 대한 예제) EvTIfLfbEUk7O_ylo5_rVBaEmt0jvIZvbI4o47azTNLDwGwbz2OoO522T4-9AzrlDwxo4ucwZ7pFg6LD-ReBNI8Yi9TKxWurSDIPvAhkqWuzY07jI_ej4Lngk_YeehlipFFV0ZfL8dnAY00xs6ydXTllkP_g_UOhHoyxxgyr3Qldp53TLXwTiv-7asYPa5H8 |
2) Response parameter
필드 | 유형 | 설명 |
---|---|---|
code | Integer | 처리결과 코드
|
msg | String | 처리결과 메세지 |
ads | List<Object> | 광고 목록 : 가변 길이입니다. 아래의 Ads 필드 값에 따라 결정됩니다. |
cursor | String | 할당받은 광고 데이터 |
...
ads
세부 항목 (Response Fields - ads)
필드 | 유형 | 설명 |
---|---|---|
| Integer | 광고 아이디 예제) 10075328 |
| String | 광고 설명 예제) "11번가 신선밥상" |
| List<String> | 사용자에게 광고를 노출시 호출되는 URL 예제) https://ad-staging.buzzvil.com/api/impression?data=ReOJjkH6mus-sxbys_1F2Bg9EHwkoGAAfb86yWB |
| Integer | 광고 참여 시 적립되는 포인트 금액 예제) 100 |
| String | 리워드 지급을 위한 조건
예제) 노출형 광고상품: “click” 액션형 광고상품: “action” 노출형 광고상품이지만 특정 액션을 수행해야 적립되는 광고: “action” |
| String |
예제) reward_condition이 "click"일 때: "" reward_condition이 "action"일 때: “https://ad.buzzvil.com/api/check_conversion?data=ReOJjkH6mus" |
| String | 광고 타입 노출형 상품
액션형 상품
예제) “cpc” |
| Object | 광고 소재
|
| String | 액션형 광고 참여시 필요한 콜백 파라미터를 인코딩한 문자열 노출형 광고 예제) ““ 액션형 광고 예제) “zh8qPfFDUycs3d_p_4kIv_8P1Q8etYu1xDtf4VDmTYyxzwqSdiPGXPXeVQGPD" |
creative
세부 항목 (Response Fields - ads - creative)
필드 | 유형 | 설명 |
---|---|---|
| String | 광고 소재 제목 예제) “LG전자 베스트샵 카카오톡 채널추가” |
| String | 광고에 대한 상세 설명 예제) “LG전자 베스트샵 이벤트, 풍성한 혜택 정보까지! 가장 먼저 만나보세요!” |
| String | 광고 클릭 시 호출되는 URL. cpc, cpm 광고만 값이 채워짐. 노출형 광고 예제) “https://screen.buzzvil.com/api/s2s/click_redirect/?payload=eytY9sky7fy45qys84KAzTqBAQeSDSKtvTolx1-Zy9Y8ND9t1hE1Mn” 액션형 광고 예제) ““ |
| String | 광고의 참여를 유도하는 CTA 버튼의 UI 텍스트 예제) 참여하기 |
| Integer | 광고 소재의 가로 길이. 값은 1200으로 고정 예제) 1200 |
| Integer | 광고 소재의 세로 길이. 값은 627으로 고정 예제) 627 |
| String | 광고주 아이콘 이미지 URL 예제) https://d3aulf22blzf9p.cloudfront.net/uploads/1662458645-S98R6.png |
| String | 광고소재 이미지 URL 예제) https://d3aulf22blzf9p.cloudfront.net/uploads/1677571904-JZ8YB.jpg |
| Boolean | 리다이렉트 될 최종 URL의 Deeplink 여부 예제) true |
Response Parameter로 구현하기
다음은 API를 호출한 결과로 얻는 Response parameter를 사용하여 광고 소재를 구성하고 사용자의 광고 참여 단계별로 필요한 구현을 하는 예시입니다.
...
Field | Type | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
unit_id | Integer | 매체 아이디 | ||||||||
campaign_id | Integer | 광고 아이디 | ||||||||
ifa | String |
예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 광고식별자 수집이 불가능할 경우 예제) 00000000-0000-0000-0000-000000000000 | ||||||||
custom | String | 사용자 고유 식별자입니다. 서비스 도중 변하지 않는 고정 값이며, 광고 할당을 위한 필수 정보입니다.
| ||||||||
client_ip | String | 광고에 참여한 유저의 ip 실제 유저의 ip 값을 전달해 주어야 합니다. 그러지 않을 경우 CPE, CPA 유형의 광고 송출이 불가합니다. 예제) 123.123.123.123 | ||||||||
payload | String | 광고 할당 시 응답받았던 payload 예제) “zh8qPfFDUycs3d_p_4kIv_8P1Q8etYu1xDtf4VDmTYyxzwqSdiPGXPXeVQGPD" | ||||||||
ifv | String | iOS 앱 벤더식별자(IDFV). iOS에서 유저가 앱 추적 허용을 하지 않아 광고식별자 수집이 불가능할 경우엔 필수로 전달해주어야 하는 값입니다. 사용자 식별을 위한 대체식별자로 사용됩니다. 예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 | ||||||||
user_id | String | 사용자 고유 식별자 | ||||||||
device_name | String | 디바이스 모델 이름 | ||||||||
carrier | String | 해당하는 통신사 예제) kt , skt, lgt | ||||||||
| String | 매체사에서 지정하는 커스텀 파라미터
| ||||||||
| String | 매체사에서 지정하는 커스텀 파라미터
| ||||||||
| String | 매체사에서 지정하는 파라미터
|
...
Field | Type | Description |
---|---|---|
| Integer | 처리결과 코드
|
| String | 처리결과 메세지 |
| String | 액션형 광고 참여 안내 및 주의사항 문구 예제) "[참여방법]\n- '채널 추가' 후 대화창에 전송된 환영메시지를 복사해 입력해주세요.\n\n[주의사항]\n- 이미 추가한 카카오톡 채널은 포인트가 지급되지 않습니다.\n- 카카오톡 채널의 환영메시지를 정확히 입력 후 '환영메시지 제출하기' 버튼을 눌러야 포인트가 지급됩니다.\n- 동일인이 부정한 방법으로 여러번 참여를 시도할 경우, 포인트 지급 및 추후 광고 참여에 제재가 가해집니다.\n- 30일 이내 채널을 차단한 경우, 이후 캠페인 참여시 불이익을 받을수 있습니다." |
| String | 광고주 페이지 랜딩 URL |
...
Field | Type | Description |
---|---|---|
| Boolean | 사용자의 캠페인 참여 여부 예제) true |
문의하기 페이지
사용자가 문의를 등록할 수 있도록 버즈빌이 제공하는 CS 페이지 접근 API입니다. url 호출시 외부 브라우저로 이동하게 구현해야 합니다.
Note |
---|
인앱 브라우저로 구현하는 경우, 첨부파일(스크린샷) 업로드 및 문의 접수가 불가합니다. |
항목 | 내용 | |
---|---|---|
1 | 요청 방향 | 매체사 → Buzzvil |
2 | HTTP Request method | GET |
3 | HTTP Request URL | https://ad.buzzvil.com/offerwall/inquiry |
4 | HTTP Request parameters | 아래 '1) HTTP Request parameters' 참고 |
5 | Response | HTML |
...
Field | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
app_id | Integer | 버즈빌 매니저로부터 발급받은 App ID | ||||||
ifa | String |
예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 광고식별자 수집이 불가능할 경우 예제) 00000000-0000-0000-0000-000000000000 | ||||||
user_id | String | 사용자 고유 식별자 | ||||||
platform | String | 플랫폼 구분을 위해 필요한 Enum 구분값.
iOS 예제) I Android 예제) A | ||||||
ifv | String | iOS 앱 벤더식별자(IDFV). iOS에서 유저가 앱 추적 허용을 하지 않아 광고식별자 수집이 불가능할 경우엔 필수로 전달해주어야 하는 값입니다. 사용자 식별을 위한 대체식별자로 사용됩니다. 예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 |
Meta API
호출 시 유저가 최대로 적립 가능한 금액과 유저의 IFA 변경 여부를 확인할 수 있는 API입니다. HTTP Request Parameters는 할당 요청 API와 동일한 파라미터를 사용합니다.
...
Field | Type | Description |
---|---|---|
| Integer | 최대로 적립 받을 수 있는 리워드입니다. 예제) “total_reward”: 97215 |
| Boolean | ifa 변경 여부를 확인합니다.
|
...