목차
| Table of Contents | ||||
|---|---|---|---|---|
|
...
필드 | 유형 | 설명 | ||||||
|---|---|---|---|---|---|---|---|---|
app_id | Integer | 매체 앱 아이디 | ||||||
unit_id | Integer | 매체 지면 아이디 | ||||||
ifa | String | 유저 개인 식별 정보. 어뷰징 필터링 및 CS 처리를 위해 필요합니다. 예제) ab4ade35-1c8a-4405-acda-10ca1ad1abe1 | ||||||
user_id | String | 유저의 매체 아이디 | ||||||
client_ip | String | 클라이언트 아이피. 어뷰징 필터링을 위해 사용됩니다. 예제) 123.123.123.123 | ||||||
birthday | String | 유저의 생년월일 생년월일 정보가 없을 경우 일부 광고가 할당에서 제외됩니다. 예제) 1993-01-09 | ||||||
gender | String | 성별 타게팅을 위한 정보. 성별 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.
| ||||||
carrier | String | 통신사 정보. 통신사 정보가 없을 경우 일부 광고가 할당에서 제외됩니다.
| ||||||
device_name | String | 디바이스 모델명 디바이스 모델명이 없을 경우 일부 광고가 할당에서 제외됩니다. 예제) SHV-E250S,SHV-E275K,SM-G928L | ||||||
latitude | Float | 위도 와 경도. 지역별 광고 타게팅에 사용됩니다. 정보가 없을 경우 일부 광고가 할당에서 제외됩니다. | ||||||
longitude | Float | |||||||
user_agent | String | User Agent. 정보가 없을 경우 일부 광고가 할당에서 제외됩니다. |
...
필드 | 유형 | 설명 |
|---|---|---|
| Integer | 광고 아이디 |
| String | 광고 설명 |
| List<String> | 사용자에게 광고를 노출시 호출되는 URL |
| Integer | 광고참여시 광고 참여 시 적립되는 포인트 금액 |
| String | 광고 타입.
|
| Object | 광고 소재.
|
...
creative세부 항목 (Response Fields - ads - creative)
필드 | 유형 | 설명 |
|---|---|---|
| String | 광고 소재 타이틀제목 |
| String | 광고 소재 광고에 대한 상세 설명 |
| String | 광고 클릭시 클릭 시 호출되는 URL |
| String광고 | CTA 문구광고의 참여를 유도하는 CTA 버튼의 UI 텍스트 예제) 참여하기 |
| Integer | 광고 소재의 가로 길이. 값은 1200으로 고정 |
| Integer | 광고 소재의 세로 길이. 값은 627으로 고정 |
| String | 광고 광고주 아이콘 이미지 |
| String | URL 형태로 전달받는 광고 이미지 파일 URL |
| Boolean | 리다이렉팅된 최종 URL의 Deeplink 여부 |
Response Parameter로 구현하기
다음은 API를 호출한 결과로 얻는 Response parameter를 사용하여 광고 소재를 구성하고 사용자의 광고 참여 단계별로 필요한 구현을 하는 예시입니다.
1. Response parameter로 전달받은 필드를 사용하여 광고 레이아웃을 구성하세요.
필드 | 유형 | 설명 | 비고 | ||||||
|---|---|---|---|---|---|---|---|---|---|
title | String | 광고 소재 제목 |
| ||||||
image_url | String | URL 형태로 전달받는 광고 이미지 |
| ||||||
description | String | 광고에 대한 상세 설명 |
| ||||||
icon_url | String | 광고주 아이콘 이미지 |
| ||||||
call_to_action | String | 광고의 참여를 유도하는 CTA 버튼의 UI 텍스트 |
| ||||||
reward | Integer | 광고 참여 시 적립되는 포인트 금액 |
2. 사용자에게 광고가 노출되면 impression_urls로 전달한 URL을 호출합니다.
3. 사용자가 광고를 클릭하면 click_urls로 전달한 URL을 호출합니다.
4. 사용자가 정상적으로 광고 참여를 완료하면, 버즈빌 서버에서 매체사의 포스트백 URL으로 포인트 적립 요청을 시도합니다. 자세한 내용은 매체사 포인트 적립 포스트백 API 연동 가이드를 참고하세요.
사용자가 액션형 광고에 정상적으로 참여했는지 확인하려면
conversion_check_url로 전달한 URL을 호출하세요.true: 사용자의 광고 참여가 정상적으로 완료되었습니다.false: 사용자가 광고 참여를 완료하지 않았거나 광고 참여에 실패했습니다.
3) Status code
아래 상태코드는 http status와 별개로, response Response parameter 안에 code 라는 필드를 통해 내려갑니다.
...