Feed(Web) Ext.point 연동 가이드
이 문서는 포인트 시스템이 존재하지 않는 퍼블리셔를 위한 버즈빌 Feed(Web) 연동 문서 입니다. 퍼블리셔는 SDK 연동 없이 보상 광고를 집행하고, 사용자에게 네이버페이 포인트와 같은 범용 포인트를 지급할 수 있습니다.
Feed(Web) 미리 보기
Feed(Web) 는 링크를 통해 광고 지면으로 진입이 가능합니다. 로그인을 통해 유저에게 맞는 광고를 노출하고, 광고를 랜딩하여 범용 포인트를 획득할 수 있습니다.
1)
2)
3)
위 스크린샷은, 1) 광고를 처음으로 참여하여 인증 화면이 노출 → 2) 인증 진행 중 → 3) 외부 포인트 서비스를 이용하여 포인트를 획득 성공하는 과정입니다.
연동 준비하기
연동하기 전, 준비 사항 1
다음 항목은 버즈빌에서 발급하는 항목입니다. 준비하지 않은 항목이 있다면, 버즈빌의 BD 매니저에게 문의 바랍니다.
[1] 앱에 사용할 App Id
App Id 는 앱마다 하나씩 발급합니다. 이전에 버즈빌의 상품을 사용하고 있더라도, OS가 다르거나 앱이 다른 경우 새로 발급받아야 합니다.
연동하기 전, 준비 사항 2
다음 항목은 퍼블리셔에서 준비해야 하는 항목입니다. 아래 내용을 버즈빌의 BD 매니저에게 전달해야 합니다.
[1] Feed(Web) 디자인 이미지
다음 항목은 Feed(Web) 의 디자인과 연관된 항목입니다. 아래 내용을 버즈빌의 BD 매니저에게 전달해야 합니다.
퍼블리셔 서비스 로고 이미지 (최대 너비 528px, 높이 160px)
퍼블리셔 서비스 아이콘 이미지 (최대 너비 512px, 높이 128px)
퍼블리셔 서비스 기본(Primary) 색상과 보조(Secondary) 색상
자세한 내용은 Feed(Web) 디자인 가이드 (링크) 를 통해 확인할 수 있습니다.
연동하기
1. URL 적용하기
Feed(Web) 연결을 원하는 버튼 혹은 링크에 다음 연동 페이지 URL과 파라미터를 연결합니다.
연동 페이지 URL
아래 URL의 {app_id}
부분을 퍼블리셔의 app_id (고정값) 로 대체한 뒤 사용합니다.
https://benefit.buzzvil.com/{app_id}/feed
URL 파라미터
아래 URL의 는 {sex}
, {year_of_birth}
부분에 퍼블리셔의 유저 데이터를 설정합니다.
https://benefit.buzzvil.com/{app_id}/feed?sex={sex}&year_of_birth={year_of_birth}
파라미터 이름 (key) | 파라미터 값 (value) | 설명 |
---|---|---|
|
| 사용자의 성별을 입력합니다. |
| e.g 1990 | 사용자의 생년을 입력합니다. |
성별과 나이는 광고 타겟팅 목적으로만 사용되며, 기입 시 약 10배 이상의 보상 광고 집행이 가능합니다.
적용 예시)
다음 링크는
app_id
가123456789
인 웹 피드에 생일 연도가1990
년인 여성(F
) 사용자가 접근할 때, 다음과 같은 링크를 사용하게 됩니다.(링크) https://benefit.buzzvil.com/123456789/feed?sex=F&year_of_birth=1990
연동 링크 실제 예시
다음의 링크는 실제로 구현된 링크입니다. 연동이 완료되었을 경우, 다음과 같은 페이지를 확인할 수 있습니다.
https://benefit.buzzvil.com/82455138753311/feed?sex=F&year_of_birth=1990
커스텀 URL OPTIONAL
사용자에게 링크를 공유할 때 퍼블리셔의 URL을 노출하고 싶을 경우 이 섹션을 참고합니다. 현재 버즈빌 웹 피드는 커스텀 도메인을 지원하지 않습니다. 하지만 URL Redirection을 통해 해당 목적을 달성할 수 있습니다.
SMS나 카카오 채널 등 사용자에게 버즈빌 웹 피드 URL을 전달할 때 302 HTTP 응답 코드를 사용해서 전달합니다. 단 URL에 포함된 쿼리 문자열(Query string)이 최종 URL에 전달 되어야 합니다. 다음 예시를 참고합니다.
항목 | 예시 값 |
---|---|
Publisher | 123456789 |
커스텀 URL 링크 | https://yourdomain.com/custompath?sex=F&year_of_birth=1990 |
HTTP Status Code | 302 Found |
Location | https://benefit.buzzvil.com/123456789/feed?sex=F&year_of_birth=1990 |
연동 문의 사항
연동 중 문의 사항은 버즈빌의 기술 지원팀으로 문의 부탁드립니다.