Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Note
  • 사용자는 모바일 기기로 Feed(Web)에 접속해야 포인트를 적립할 수 있습니다. PC 웹 브라우저로 Feed(Web)에 접속하는 사용자는 포인트를 적립할 수 없습니다.

  • 인앱 브라우저가 아닌 외부 브라우저로 Feed(Web)가 열리도록 구현하세요. 그렇지 않으면 제약이 많은 인앱 브라우저(Webview)의 특성상 광고 지면 표시나 동작 등에 다양한 문제가 발생할 수 있습니다.

Feed(Web) 미리 보기

브라우저로 구현되는 Feed(Web Feed )사용자가 링크를 통해 광고 지면으로 진입이 가능합니다. 로그인을 통해 유저에게 맞는 광고를 노출하고, 광고를 랜딩하여 퍼블리셔의 포인트를 획득할 수 있습니다. (클릭하여 확대된 이미지를 볼 수 있습니다.)진입할 수 있는 광고 지면입니다. Feed(Web) 진입을 위해 로그인을 요청하므로 사용자 등록 정보를 기반으로 타겟팅한 광고를 노출할 수 있고, 사용자는 광고에 참여하여 포인트를 적립할 수 있습니다.

...

...

연동 준비하기

연동하기 전, 준비 사항 1

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

...

광고 지면 타입 연동을 시작하기 전, 연동하는 광고 지면 타입의 Unit Id 를 준비해야 합니다. 준비되지 않은 경우, 버즈빌의 BD 매니저에게 문의 바랍니다. 광고 지면이 다를 경우, 지면 별로 각각 Unit Id 를 발급받아야 합니다.

연동하기 전, 준비 사항 2

다음 항목은 퍼블리셔에서 준비해야 하는 항목입니다. 준비가 되면 아래 내용을 버즈빌의 BD 연동 지원 매니저에게 전달해야 합니다.

[1] Feed(Web Feed ) 디자인 이미지

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

  • 퍼블리셔 서비스 로고 이미지 (가로 128px 이상최대 너비 528px, 높이 160px)

  • 퍼블리셔 서비스 아이콘 이미지 (가로 128px, 세로 128px 이상최대 너비 512px, 높이 512px)

  • 퍼블리셔 서비스 메인기본(Primary) 색상과 부차보조(Secondary) 색상

자세한 내용은 Feed(Web) 디자인 가이드 문서 (링크) 를 통해 확인할 수 있습니다.

[2] 포스트백 URL - 연동 이후 전달 가능포인트 세부사항

다음 항목은 포인트를 정의하기 위해 필요한 값입니다.

  • Point Name: 귀사에서 사용하는 포인트 이름 (예: "포인트")

  • Point Unit: 포인트의 유닛 (예: "P")

  • Point Exchange Rate: 원화 <> CTA 내 리워드 재화 단위 비율 (예: "1.0")

[3] 포스트백 URL

버즈빌의 포인트 적립 요청을 받을 수 있는 서버 endpoint API (해당 endpoint 의 url을 "포스트백 URL"으로 지칭) 구축합니다. 아래의 ‘연동하기 - 2. 포스트백 연동하기’ 과정이 완료된 뒤, 완료가 되었음을 공유 부탁드립니다가 필요합니다.
매체사 포인트 적립 포스트백 API 연동 가이드를 참고하여 API 를 구현할 수 있습니다.

...

연동하기

1. URL 적용하기

Web Feed Feed(Web) 연결을 원하는 버튼 혹은 링크에 다음 연동 페이지 URL과 파라미터를 연결합니다.

연동 페이지 URL

아래 URL의 아래와 같은 형식의 URL을 버즈빌에서 제작하여 전달합니다.
{app_id} 부분을 퍼블리셔의 app_id (고정값) 로 대체한 뒤 사용합니다는 버즈빌에서 부여하는 고유한 값입니다.

  • 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)

설명

user_id

e.g buzzviluser123

사용자를 식별할 수 있는 값입니다. 사용자별로 유일한 값이어야 합니다. 해당 값은 이후 보상 지급을 위한 postback 요청에 포함됩니다.

sex

  • M 남자

  • F 여자

사용자의 성별을 입력합니다.

year_of_birth

e.g 1990

사용자의 생년을 입력합니다.

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

적용 예시)

다음 링크는 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

커스텀 URL

...

Status
colourRed
titleOPTIONAL

사용자에게 링크를 공유할 때 퍼블리셔의 URL을 노출하고 싶을 경우 이 섹션을 참고합니다. 현재 버즈빌 웹 피드는 커스텀 도메인을 지원하지 않습니다. 하지만 URL Redirection을 통해 해당 목적을 달성할 수 있습니다.

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

연동하기

2. 포스트백 연동하기

포스트백 연동 프로세스

사용자에게 보상을 지급하기 위해서 포스트백(Postback) 연동이 필요합니다. 포스트백 요청은 보안을 위해 서버 간 통신(Server-to-server) 형태로 진행됩니다. (클릭하여 확대된 이미지를 볼 수 있습니다.)

...

포스트백 연동 단계

...

버즈빌로부터 포스트백 요청을 받을 수 있는 서버 엔드포인트(endpoint)를 준비합니다.

...

Web Feed 포스트백 API 연동 가이드 (링크) 에 맞춰 엔드포인트를 구현합니다.

...

...

연동 문의 사항

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