이 문서는 포인트 시스템을 보유한 퍼블리셔를 위한 버즈빌 Feed(Web) 연동 문서입니다. 퍼블리셔는 SDK 연동 없이 보상 광고를 집행하고 사용자에게 퍼블리셔 포인트를 지급할 수 있습니다.
...
브라우저로 구현되는 Feed(Web)는 사용자가 링크를 통해 진입할 수 있는 광고 지면입니다. Feed(Web) 진입을 위해 로그인을 요청하므로 사용자 등록 정보를 기반으로 타겟팅한 광고를 노출할 수 있고, 사용자는 광고에 참여하여 포인트를 적립할 수 있습니다.
...
...
연동 준비하기
연동하기 전, 준비 사항 1
다음 항목은 버즈빌에서 발급하는 항목입니다. 준비하지 않은 항목이 있다면, 버즈빌의 BD 매니저에게 문의 바랍니다.
...
버즈빌의 포인트 적립 요청을 받을 수 있는 서버 API (해당 endpoint 의 url을 "포스트백 URL"으로 지칭) 가 필요합니다.
매체사 포인트 적립 포스트백 API 연동 가이드를 참고하여 API 를 구현할 수 있습니다.
...
연동하기
Feed(Web) 연결을 원하는 버튼 혹은 링크에 다음 연동 페이지 URL과 파라미터를 연결합니다.
...
https://benefit.buzzvil.com/{app_id}/feed
URL 파라미터
아래 URL의 는 {user_id}, {sex}, {year_of_birth} 부분에 퍼블리셔의 유저 데이터를 설정합니다.
https://benefit.buzzvil.com/{app_id}/feed?user_id={user_id}&sex={sex}&year_of_birth={year_of_birth}
파라미터 이름 (key) | 파라미터 값 (value) | 설명 |
|---|---|---|
| e.g buzzviluser123 | 사용자를 식별할 수 있는 값입니다. 사용자별로 유일한 값이어야 합니다. 해당 값은 이후 보상 지급을 위한 postback 요청에 포함됩니다. |
|
| 사용자의 성별을 입력합니다. |
| e.g 1990 | 사용자의 생년을 입력합니다. |
...
적용 예시)
다음 링크는
app_id가123456789인 웹 피드에user_id가a100001이고 생일 연도가1990년인 여성(F) 사용자가 접근할 때, 다음과 같은 링크를 사용하게 됩니다.(링크) https://benefit.buzzvil.com/123456789/feed?user_id=a100001&sex=F&year_of_birth=1990
연동 링크 실제 예시
...
https://benefit.buzzvil.com/82455138753311/feed?user_id=a100001&sex=F&year_of_birth=1990
...
항목 | 예시 값 |
|---|---|
Publisher | 123456789 |
커스텀 URL 링크 | https://yourdomain.com/custompath?user_id=a100001&sex=F&year_of_birth=1990 |
HTTP Status Code | 302 Found |
Location | https://benefit.buzzvil.com/123456789/feed?user_id=a100001&sex=F&year_of_birth=1990 |
...