Index
Table of Contents | ||||
---|---|---|---|---|
|
...
퍼블리셔가 받아볼 수 있는 광고 목록을 조회합니다.
항목 | 내용 | |
---|---|---|
1 | 요청 방향 | 매체사 → BuzzAd |
2 | HTTP Request method | GET |
3 | HTTP Request URL | |
4 | HTTP Request parameters | Field 설명
|
5 | Response |
|
5) Response Fields
Field | Type | Description |
---|---|---|
| list | 광고 목록
|
| String | 처리 결과 코드
|
| String | 처리 결과 메세지 |
ads
세부 항목 (Response Fields - ads)
Field | Type | Description | ||
---|---|---|---|---|
| Integer | 광고 아이디 (식별값) | ||
| String | 광고 제목 | ||
| String | 광고 설명 | ||
| String | 광고 적립방법 설명 | ||
| String | 아이콘 이미지 주소 | ||
| String | 매체사 단가 | ||
| String | 광고 타입. 추후 새로운 타입이 추가될 수 있으므로 연동시 이를 고려해야 합니다.
예제) “cpc” | ||
| String | 안드로이드 package_name | ||
| String | 아이폰 url scheme | ||
| String | 광고가 지원되는 플랫폼
| ||
| Integer | 나이 하한 타게팅. 타게팅이 없는 경우 | ||
| Integer | 나이 상한 타게팅. 타게팅이 없는 경우 | ||
| JSON | 다 구간 나이 타게팅. age_ranges를 사용하는 경우 age_from, age_to 값은 무시해도 된다.
| ||
| String | 성별 타게팅. 타게팅이 없는 경우
| ||
| String | 결혼 유무 타게팅. 타게팅이 없는 경우
| ||
| String | 통신사 타게팅. 타게팅이 없는 경우
| ||
| Bool |
| ||
| String | 디바이스 모델 타게팅
| ||
| String | 앱 타게팅 (안드로이드만 지원)
| ||
| String | 지역 타게팅
| ||
| list | creative 목록
|
creative
세부 항목 (Response Fields - ads - creative)
Field | Type | Description |
---|---|---|
| Integer | creative ID |
| String | 짧은 참여방법/주의사항 기재 |
| integer | native creative 가 세팅 되어 있는 경우 627 (고정값), 없는 경우 0 |
| integer | native creative 가 세팅 되어 있는 경우 1200 (고정값), 없는 경우 0 |
| String | 참여방법 및 주의사항이 기재 |
| String | ex) 팔로워 누르러 가기 |
| String | Native creative가 세팅되어 있을 경우에만 native 타입의 이미지 파일 url이 담김 |
| String | 오퍼월 리스트내에 볼수 있는 아이콘 이미지 |
Info |
---|
광고 목록 조회 요청 시, Native creative 가 세팅되어 있는 광고만을 선별하여 반환 받을 수 있습니다. Request parameters 내 아래의 key & value를 포함해주시기 바랍니다.
|
...
광고에 참여하기 위해서는 참여 요청 API를 호출하여 참여 가능 여부를 확인해야 합니다.
항목 | 내용 | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
1 | 요청 방향 | 매체사 → BuzzAd | ||||||||
2 | HTTP Request method | POST | ||||||||
3 | HTTP Request URL | |||||||||
4 | HTTP Request parameters |
| ||||||||
5 | Response |
|
4) HTTP Request parameters
Field | Type | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
| Integer | 매체 아이디 | ||||||||
| Integer | 광고 아이디 | ||||||||
| String |
| ||||||||
| String | 매체사 유저 아이디 | ||||||||
| String | 광고 참여한 유저의 ip ex) 123.123.123.123 | ||||||||
| String | 안드로이드 IMEI
| ||||||||
| String | android id | ||||||||
| String | sha1 적용한 안드로이드 IMEI
| ||||||||
| String | sha1 적용한 android id | ||||||||
| String | 매체사의 하위 매체사 아이디 | ||||||||
| String | 매체사의 하위 매체사의 유저 아이디 | ||||||||
| String | 디바이스 모델 이름 | ||||||||
| String | 통신사 ex) SKT, UPlus | ||||||||
| String | 안드로이드 기기에 등록된 google account sha1 적용 값
| ||||||||
| String | 매체사에서 지정하는 커스텀 파라미터
| ||||||||
| String | 매체사에서 지정하는 커스텀 파라미터
| ||||||||
| String | 매체사에서 지정하는 파라미터
|
5) Response
Field | Type | Description |
---|---|---|
| Integer | 처리결과 코드
|
| String | 처리결과 메세지 |
| String | 광고주 페이지 랜딩 URL |
3. 광고 참여 완료
Info |
---|
본 항목은 CPI 광고만 해당됩니다. |
...
Expand | ||
---|---|---|
| ||
패키지명 확인이 가능하면, 해당 api를 요청합니다.
|
항목 | 내용 | |
---|---|---|
1 | 요청 방향 | 매체사 → BuzzAd |
2 | HTTP Request method | POST |
3 | HTTP Request URL | |
4 | HTTP Request parameters |
|
5 | Response | JSON 형식으로 반환
|
4) HTTP Request parameters
Field | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
| Integer | 매체 아이디 | ||||||
| Integer | 광고 아이디 | ||||||
| String |
| ||||||
| String | 광고 참여한 유저의 아이피 ex) 123.123.123.123 | ||||||
| String | 안드로이드 IMEI
|
5) Response
Field | Type | Description |
---|---|---|
| Integer | 처리결과 코드
|
| String | 처리결과 메세지 |
4. 포인트 적립 포스트백 API 연동
BuzzAd에서 유저가 목표한 액션을 수행 시 매체사로 보내주는 리퀘스트입니다.
...
Note |
---|
아래 표에 명시되지 않은 Code가 추가될 수 있으므로 주의해야 합니다. |
코드 | 설명 |
---|---|
200 | 정상 |
401 | 블랙리스트 유저 |
402 | 잘못된 ip 주소 형식 |
1000 | 시스템 에러 |
9001 | 존재하지 않는 unit_id |
9004 | 유효하지 않은 파라미터 (요청에 required field가 누락됐을 경우 발생) |
9008 | 존재하지 않는 캠페인 |
9011 | 요청 unit이 inactive 상태인 경우 |
9013 | 비활성화된 캠페인 |
9014 | 현재 캠페인이 라이브 중이 아니거나, 해당 매체에 타게팅되어 있지 않은 경우 |
9020 | 이미 캠페인에 참여한 경우 |
9021 | 캠페인이 모두 소진된 경우 |
9022 | 광고식별자 수집이 불가한 사용자가 광고식별자 필수 캠페인을 클릭한 경우 |
9031 | 알 수 없는 애드네트워크 캠페인 에러 |
9037 | 클릭한 사용자가 타게팅 조건에 맞지 않아 참여가 불가능한 경우 |
9040 | 광고식별자 형식이 잘못됐거나, 추적이 불가한 식별유형일 경우(e.g. 0000…) |
2) 앱 설치 트래킹
iOS/안드로이드에서 앱 설치여부를 트래킹 하는 방법에 대한 간략한 예제입니다. OS에 맞는 항목을 선택하여 자세한 내용을 확인해주세요.
...