BuzzAd 의 인벤토리를 통해 들어온 유저가 광고주의 웹페이지에서 특정 동작을 수행했는지 여부를 트래킹하는 상품입니다.
BuzzAd의 인벤토리를 통해서 유저가 광고주의 광고로 랜딩하여 들어올 때, BuzzAd 서버에서는 유저의 액션을 트래킹하기 위한 id인 bz_tracking_id
를 원래의 랜딩 url에 파라미터로 붙여서 전달합니다.
광고주 페이지에서 유저의 액션이 완료되면, Javascript 연동 코드를 통해 또는 광고주 서버로부터 API 호출을 통해bz_tracking_id
를 전달합니다.
BuzzAd 서버에서는 전달받은 bz_tracking_id
값을 이용해 광고에 참여 완료한 유저 정보를 찾아서 해당 유저에게 포인트를 지급합니다.
bz_tracking_id
는 광고마다 부여되는 고정된 값이 아니라, 유저의 클릭 때마다 매번 달라지는 값입니다.
bz_tracking_id
는 광고마다 부여되는 고정된 값이 아니라, 유저의 클릭 때마다 매번 달라지는 값입니다.
위 Flow chart 의 “Action Complete” 신호를 전달하는 방식 (파란색 화살표) 에 따라 Javascript 를 이용한 연동과 Server to Server API 연동이 있습니다.
두 가지 방식 중 상황에 맞게 하나를 선택해서 연동 작업을 진행해주세요.
반드시 제공되는 연동 테스트까지 완료한 후에 버즈빌 담당자에게 연동 완료 회신을 해주시기 바랍니다. |
제공되는 두 종류의 Javascript 코드를 두 단계에 걸쳐 삽입함으로써 연동할 수 있습니다. 첫번째 단계(초기화)는 광고의 첫 페이지(랜딩 페이지)가 로드될 때, 두번째 단계(액션 달성 전송)는 액션이 완료 되었을 때에 호출하도록 합니다.
Javascript 연동은 |
Step1 '초기화' 단계 연동을 통해 광고주 랜딩 url 에 붙어온 bz_tracking_id
파라미터를 유저의 웹브라우저 내에 광고주 도메인의 localStorage
에 저장합니다.
Step2 '액션 달성 전송' 단계의 연동을 통해 액션 완료 시 BuzzAd 서버로 신호를 보낼 때 localStorage
에 저장해 둔 bz_tracking_id
를 꺼내어 함께 전달합니다.
BuzzAd 서버에서는 전달받은 bz_tracking_id
값을 이용해 광고에 참여 완료한 유저 정보를 찾아서 해당 유저에게 포인트를 지급합니다.
항목 | 코드 및 내용 | |||
---|---|---|---|---|
Step1. 초기화 |
| |||
Step2. 액션 달성 전송 |
|
아래 링크된 페이지에서 Buzzad integration test
링크를 북마크로 추가하여 테스트를 진행해주세요. 자세한 테스트 진행 방식은 해당 페이지를 참고합니다.
Javascript Integration Test Page
|
연동 테스트가 실패했을 경우, 아래 FAQ를 참고합니다.
연동 테스트는 Step1을 성공한 후에 Step2를 진행해야 합니다.
코드 작업을 진행하신 페이지의 URL이 광고용으로 전달하신 URL과 동일한지 다시 확인해 주세요.
|
해당 alert는 테스트를 하실 때만 보이게 되어 있습니다. 코드를 수정하지 않으셔도 일반 유저들에게는 보이지 않습니다. |
|
위 1번의 JavaScript 방식으로 연동을 완료했을 경우 본 항목은 불필요합니다. |
사용자가 특정한 액션을 수행하면 BuzzAd 서버로 액션이 수행 되었음을 알려주어야 합니다. 연동은 다음과 같이 수행합니다.
항목 | 내용 | |
---|---|---|
1 | 요청 방향 | 광고주 → 버즈빌 |
2 | HTTP Request method | POST or GET |
3 | HTTP Request URL | |
4 | HTTP Request parameters | Field 설명
|
5 | Response |
|
테스트용 bz_tracking_id
bz_tracking_id
= 10023_71ffbffd-ccf1-4edf-9c4c
ex) https://track.buzzvil.com/action/pb/cpa/default/?bz_tracking_id=10023_71ffbffd-ccf1-4edf-9c4c
테스트용 bz_tracking_id
bz_tracking_id
= 10023_71ffbffd-ccf1-4edf-9c4c
ex) https://track.buzzvil.com/action/pb/cpa/default/?bz_tracking_id=10023_71ffbffd-ccf1-4edf-9c4c
연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다. 버즈빌 기술지원팀: csm@buzzvil.com |
|