이 문서는 포인트 시스템을 보유한 퍼블리셔를 위한 버즈빌 Feed(Web) 연동 문서 입니다. 퍼블리셔는 SDK 연동 없이 보상 광고를 집행하고, 사용자에게 퍼블리셔 포인트를 지급할 수 있습니다.

Feed(Web) 는 링크를 통해 광고 지면으로 진입이 가능합니다. 로그인을 통해 유저에게 맞는 광고를 노출하고, 광고를 랜딩하여 퍼블리셔의 포인트를 획득할 수 있습니다. (클릭하여 확대된 이미지를 볼 수 있습니다.)

...

연동 준비하기

연동하기 전, 준비 사항 1

다음 항목은 버즈빌에서 발급하는 항목입니다. 준비하지 않은 항목이 있다면, 버즈빌의 BD 매니저에게 문의 바랍니다.

...

다음 항목은 Feed(Web) 의 디자인과 연관된 항목입니다. 아래 내용을 버즈빌의 BD 매니저에게 전달해야 합니다.

...

버즈빌의 포인트 적립 요청을 받을 수 있는 서버 API (해당 endpoint 의 url을 "포스트백 URL"으로 지칭) 가 필요합니다.
Feed(Web) 포스트백 API 연동 (링크) 를 참고하여 API 를 구현할 수 있습니다.

...

Feed(Web) 연결을 원하는 버튼 혹은 링크에 다음 연동 페이지 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)	설명
`user_id`	e.g buzzviluser123	사용자를 식별할 수 있는 값입니다. 사용자별로 유일한 값이어야 합니다. 해당 값은 이후 보상 지급을 위한 postback 요청에 포함됩니다.
`sex`	`M` 남자 `F` 여자	사용자의 성별을 입력합니다.
`year_of_birth`	e.g 1990	사용자의 생년을 입력합니다.

성별과 나이는 광고 타겟팅 목적으로만 사용되며, 기입 시 약 10배 이상의 보상 광고 집행이 가능합니다.

...

SMS나 카카오 채널 등 사용자에게 버즈빌 웹 피드 URL을 전달할 때 302 HTTP 응답 코드를 사용해서 전달합니다. 단 URL에 포함된 쿼리 문자열(Query string)이 최종 URL에 전달 되어야 합니다. 다음 예시를 참고합니다.

항목	예시 값
Publisher `app_id`	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

...

연동 중 문의 사항은 버즈빌의 기술 지원팀으로 문의 부탁드립니다.