이 문서는 포인트 시스템을 보유한 퍼블리셔를 위한 버즈빌 Web Feed 연동 문서 입니다. 퍼블리셔는 SDK 연동 없이 보상 광고를 집행하고, 사용자에게 퍼블리셔 포인트를 지급할 수 있습니다.
...
Web Feed 는 링크를 통해 광고 지면으로 진입이 가능합니다. 로그인을 통해 유저에게 맞는 광고를 노출하고, 광고를 랜딩하여 퍼블리셔의 포인트를 획득할 수 있습니다. (클릭하여 확대된 이미지를 볼 수 있습니다.)
...
...
연동 준비하기
연동하기 전, 준비 사항 1
다음 항목은 버즈빌에서 발급하는 항목입니다. 준비하지 않은 항목이 있다면, 버즈빌의 BD 매니저에게 문의 바랍니다.
...
퍼블리셔 서비스 로고 이미지 (가로 128px 이상)
퍼블리셔 서비스 아이콘 이미지 (가로 128px, 세로 128px 이상)
퍼블리셔 서비스 메인(Primary) 색상과 부차(Secondary) 색상
자세한 내용은 Web Feed 디자인 가이드 문서 (링크) 를 통해 확인할 수 있습니다.
[2] 포스트백 URL - 연동 이후 전달 가능
버즈빌의 포인트 적립 요청을 받을 수 있는 서버 endpoint (해당 endpoint 의 url을 "포스트백 URL"으로 지칭) 구축합니다. 아래의 ‘연동하기 - 2. 포스트백 연동하기’ 과정이 완료된 뒤, 완료가 되었음을 공유 부탁드립니다.
...
연동하기
1. URL 적용하기
Web Feed 연결을 원하는 버튼 혹은 링크에 다음 연동 페이지 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 | 사용자의 생년을 입력합니다. |
...
https://benefit.buzzvil.com/82455138753311/feed?user_id=a100001&sex=F&year_of_birth=1990
커스텀 URL
...
| Status | ||||
|---|---|---|---|---|
|
사용자에게 링크를 공유할 때 퍼블리셔의 URL을 노출하고 싶을 경우 이 섹션을 참고합니다. 현재 버즈빌 웹 피드는 커스텀 도메인을 지원하지 않습니다. 하지만 URL Redirection을 통해 해당 목적을 달성할 수 있습니다.
...
항목 | 예시 값 |
|---|---|
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 |
...
연동하기
2. 포스트백 연동하기
포스트백 연동 프로세스
사용자에게 보상을 지급하기 위해서 포스트백(Postback) 연동이 필요합니다. 포스트백 요청은 보안을 위해 서버 간 통신(Server-to-server) 형태로 진행됩니다. (클릭하여 확대된 이미지를 볼 수 있습니다.)
...
버즈빌로부터 포스트백 요청을 받을 수 있는 서버 엔드포인트(endpoint)를 준비합니다.
다음 Web Feed 포스트백 API 연동 가이드 (링크) 에 가이드에 맞춰 엔드포인트를 구현합니다.
완료가 되었음을 버즈빌의 BD 매니저에게 공유 부탁드립니다.
...