Versions Compared

Key

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

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

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

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

Feed(Web) 미리 보기

브라우저로 구현되는 Feed(Web)는 사용자가 링크를 통해 진입할 수 있는 광고 지면입니다. Feed(Web) 진입을 위해 로그인을 요청하므로 사용자 등록 정보를 기반으로 타겟팅한 광고를 노출할 수 있고, 사용자는 광고에 참여하여 포인트를 적립할 수 있습니다.

...

...

연동 준비하기

연동하기 전, 준비 사항 1

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

...

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

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

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

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

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

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

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

[2] 포인트 세부사항

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

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

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

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

[3] 포스트백 URL

버즈빌의 포인트 적립 요청을 받을 수 있는 서버 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)

설명

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

...

연동 문의 사항

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