[광고주] CPE/CPA (Web - Javascript 연동) ver.2022


최신 버전의 가이드가 존재합니다! (최신 버전 가이드 보러가기)

준비물

  1. 랜딩 페이지 코드

  2. 액션 완료(회원가입 완료, 이벤트 참여 완료 등)페이지 코드

 

Step 초기화 스크립트 삽입 - 랜딩 페이지 코드 <head> 에 삽입

랜딩 페이지 코드 <head>에 다음 코드를 삽입해주세요. 리다이렉트 되는 페이지가 아닌, 버즈빌 측에 전달해주실 랜딩URL의 페이지 코드에 넣어주세요.

스크립트 전체를 그대로 사용해 주세요.

<!-- Buzzvil Script : 연동 완료 후 삭제 및 이동 불가 --> <script> if (/bz_tracking_id/.test(location.search)) { localStorage.BuzzAd = location.search } </script> <!-- Buzzvil Script End -->

 

  

Step 액션 달성 스크립트 삽입 - 액션 달성시 코드에 삽입

액션 완료 페이지의 액션 달성시 코드에 다음 코드 전체를 그대로 삽입해 주세요.
[연동 완료] 메시지는 연동 테스트 페이지에서만 노출되며, 실 광고 지면에서는 노출되지 않음을 참고 부탁드립니다.

<!-- Buzzvil Complete Script : 연동 완료 후 삭제 및 이동 불가 --> <script> (function (img) { img.onload = function () { var length = localStorage.BuzzAd.length; if(localStorage.BuzzAd.indexOf('10023_71ffbffd-ccf1-4edf-9c4c') != -1){ alert("[연동 완료] 자바스크립트 연동을 완료하셨습니다! 연동이 완료되었음을 버즈빌 광고 담당자에게 알려주세요."); }; //*필요시 여기서 리다이렉트 수행* }; if (localStorage.BuzzAd == null) { localStorage.BuzzAd = ""; } img.src = "//track.buzzvil.com/action/pb/cpa/default/pixel.gif" + localStorage.BuzzAd; }) (new Image()) </script> 

bz_tracking_id=10023_71ffbffd-ccf1-4edf-9c4c는 테스트용으로만 사용되며, 캠페인 진행시 유저의 클릭마다 랜덤하게 치환됩니다.

Step 웹 자바스크립트 연동 테스트

다음 링크에서 연동 테스트를 진행해주세요.

Javascript Integration Test Page(Chrome 브라우저 권장)

 

 

 

  1. 링크를 우클릭하여 복사합니다. (사진: Chrome browser의 예시)

     

  2. 북마크 관리자를 열어 링크를 북마크로 추가합니다.

  1. 크롬 개발자 도구(Mac: option+cmd+i / Window: F12)

  2. Toggle Device Tool bar(Mac: cmd+shift+M / Windows: Ctrl+shift+M)

  1. 상단의 Emulated Devices 옵션에서

Galaxy S5 선택

  1. 새로고침 후 주소창에서 모바일 url 확인

URL이 서로 다를 경우, 자세한 사항은 Step1 FAQ 를 참조하세요.

Step 의 테스트를 완료하셨다면, 연동이 정상 완료되셨습니다

테스트를 완료하셨다면 광고 담당자에게 연동이 완료됨을 말씀해주세요.

 

FAQ

BuzzAd 의 인벤토리를 통해 들어온 유저가 광고주의 웹페이지에서 특정 동작을 수행했는지 여부를 트래킹하는 상품입니다.

광고 참여 및 포인트 지급 Flow

  1. BuzzAd의 인벤토리를 통해서 유저가 광고주의 광고로 랜딩하여 들어올 때, BuzzAd 서버에서는 유저의 액션을 트래킹하기 위한 id인 bz_tracking_id 를 원래의 랜딩 url에 파라미터로 붙여서 전달합니다.

  2. 광고주 페이지에서 유저의 액션이 완료되면, Javascript 연동 코드를 통해 또는 광고주 서버로부터 API 호출을 통해bz_tracking_id 를 전달합니다.

  3. BuzzAd 서버에서는 전달받은 bz_tracking_id 값을 이용해 광고에 참여 완료한 유저 정보를 찾아서 해당 유저에게 포인트를 지급합니다.

이 경우 Javascript 연동이 아닌, 다음의 방법중 하나로 진행하셔야 합니다.

  1. Server to Server 연동 진행

  2. 랜딩 URL에 붙여지는 bz_tracking_id가 액션 완료 페이지 URL에 전달될 수 있도록, 광고주 측에서 자체 개발

일정 액션이 끝나는 지점이 포함된 페이지 이며, 사용자가 회원가입을 완료하는 페이지, 설정한 이벤트 신청을 완료하는 페이지 등이 될 수 있습니다. 만약 액션 완료 페이지가 광고주 도메인이 아닌 경우(광고주측에서 해당 페이지의 코드를 조작할 수 없는 경우)연동이 힘들 수 있습니다.