...
Field | Type | Description |
|---|
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 | 오퍼월 리스트내에 볼수 있는 아이콘 이미지 |
| Info |
|---|
광고 목록 조회 요청 시, Native creative 소재만을 할당 받을 수 있습니다. Request parameters 내 아래의 key & value를 포함해주시기 바랍니다. Key: types Value: {"NATIVE":[]}
|
2. 광고 참여 요청
광고에 참여하기 위해서는 참여 요청 API를 호출하여 참여 가능 여부를 확인해야 합니다.
...
| Expand |
|---|
| title | 타게팅 값이 있는 광고를 받고 싶습니다. |
|---|
|
타게팅 값이 있는 광고를 받는 절차 버즈빌 BD 매니저에게 아래의 타게팅 항목 중 지원 가능한 항목에 대해 전달합니다. 연령 성별 통신사 설치된 앱 패키지명 지역 (형식 참고문서) 결혼 여부 기종
버즈빌 서버에 해당 정보 등록 후 BD 매니저를 통해 매체사에 안내합니다.
|
| Expand |
|---|
| title | iOS14 버전에서 IDFA 수집 정책이 변경되었는데 이에 대한 대응 방인이 있을까요? |
|---|
|
iOS14 버전에서 IDFA 수집에 대한 정책 변경으로 인해 사용자의 IDFA 값을 얻기 위해서는 먼저 사용자에게 App Tracking Transparency 팝업을 노출하여 권한을 획득해야 합니다. 이로인해 ifa 파라미터 값이 없을 경우 발생하는 9022 에러가 많은 유저에게서 발생할 수 있습니다. 기존에도 유저가 opt-out 할 경우 ifa 파라미터 값이 없어서 동일한 에러코드를 리턴했을텐데 iOS14 이후 버전을 사용하는 유저들의 경우 opt-in을 하지 않으면 모두 이 에러가 발생하며 액션형 광고 참여가 불가능한 상황이라 좀 더 적극적인 opt-in 안내를 할 필요가 있습니다. 아래 문구는 버즈빌 허니스크린에서 해당 에러에 대해 유저에게 안내하고 있는 문구입니다. 아래 안내문구를 참고하여 9022 에러가 리턴되었을때 유저에게 보여줄 안내 메세지 적용 작업이 필요합니다. | Info |
|---|
광고 참여 확인을 위해 설정 변경이 필요합니다. |
|
...
| Expand |
|---|
|
버전 | 변경일자 | 변경내용 | 담당자 |
|---|
0
| 2014/11/03 | | 서주은 |
|---|
1
| 2014/11/10 | list api, complete api 추가 | 서주은 |
|---|
2
| 2014/11/13 | list api 응답에 platform, age_from, age_to, sex, relationship, carrier 필드 추가 | 서주은 |
|---|
3
| 2014/12/29 | buzzad.io 로 도메인 변경 | 서주은 |
|---|
4
| 2015/03/17 | 앱 설치 트래킹 부록 추가 | 서주은 |
|---|
5
| 2015/03/23 | custom parameter max-length 명시 | 서주은 |
|---|
6
| 2015/04/06 | list api에 udid_required 응답 추가 | 서주은 |
|---|
7
| 2015/04/09 | list api에 revenue_type 설명 수정 | 서주은 |
|---|
8
| 2015/06/11 | API endpoint http → https로 변경 participate/complete api에 udid 파라미터 추가 | 서주은 |
|---|
9
| 2015/07/09 | 리워드 적립 postback에 transaction_id 파라미터 추가 | 서주은 |
|---|
10
| 2015/11/30 | 에러코드 추가 | 서주은 |
|---|
11
| 2016/03/18 | list api에 device_name, target_app, region 추가 | 서주은 |
|---|
12
| 2016/11/11 | 광고 참여 요청 API에 파라미터 추가 udid android_id udid_sha256 android_id_sha256 user_id sub_publisher_id sub_publisher_user_id
| 서주은 |
|---|
13
| 2016/11/30 | 광고 참여 요청 API 파라미터 변경 및 추가 | 서주은 |
|---|
14
| 2016/11/30 | API 주소 변경 api.buzzad.io → ad.buzzvil.com | 서주은 |
|---|
15
| 2016/12/01 | Google account 가져오기 예제 추가 | 서주은 |
|---|
16
| 2017/02/07 | cpy 유튜브 시청 → 동영상 시청 | 서주은 |
|---|
17
| 2018/05/16 | FAQ #1 추가 | 윤진 |
|---|
18
| 2018/07/11 | “3. 부록의 (1) 처리 결과 코드” 에 9004 에러 추가 | 윤진 |
|---|
19
| 2019/01/04 | “2-(1) 광고 목록 조회” 하단에 “타게팅 값이 있는 광고를 받는 절차” 설명 추가 | 윤진 |
|---|
1. 20 | 2020/05/26 | | 공지연 |
|---|
1.21 | 2020/08/18 | CPS = 결제형 광고 → 쇼핑 적립형 광고 로 수정 | 공지연 |
|---|
1.22 | 2020/10/13 | IDFA 트래킹 허용 받지 못한 경우 가이드 추가 | 이태규 |
|---|
1.22 | 2021/11/03 | age_ranges targeting 추가 | 서주은 |
|---|
|