Page Comparison

요청 방향

광고주 → 버즈빌

HTTP Request method

POST or GET

HTTP Request URL

https://track.buzzvil.com/action/pb/cps/default/

HTTP Request parameters

Field 설명

• bz_tracking_id (String)

  • 광고와 유저 트래킹을 위한 아이디

  • BuzzAd에서 광고와 연결된 URL로 전환 시 함께 전달되는 값으로, 광고주 웹 사이트는 이 값을 보관하였다가 액션 달성 API 호출 시 다시 전달해주어야 합니다.

• transaction_id (String) - CPS에서만 사용

  • 유저가 상품 구매 이벤트를 트래킹 하기 위한 고유한 아이디

  • 유저가 광고 페이지에서 상품 구매를 하였을 때 해당 파라미터에 값이 인입되며, 광고 페이지 방문만으로는 생성되지 않습니다. 웹 사이트는 이 값이 발생되면 보관하였다가 액션 달성 API 호출 시 전달해 줍니다.

• count(Integer) - CPS에서만 사용, 버즈빌과 자동으로 상품목록을 받아오는 API 연동을 진행하지 않으셨을 경우에만 사용

  • 유저가 구매한 상품의 개수

  • transaction_id 값이 생성시 같이 생성되는 값으로 액션 달성 API 호출 시 전달되는 값입니다.

• order_list(String) - CPS에서만 사용, 버즈빌과 자동으로 상품목록을 받아오는 API 연동을 진행하셨을 경우에만 사용

  • 유저가 구매한 상품의 리스트. 여러개의 order 객체가 담길 수 있는 json format의 String입니다.

  • 상품 목록을 자동을 받아오는 연동을 진행하지 않으셨을 경우 order_list 대신 위의 count를 보내주게끔 연동을 진행하셔서 햡니다.

  • order 객체는 유저가 주문완료한 각각의 상품을 나타내고 다음과 같이 구성됩니다.

    • id(Integer) - 상품의 고유 ID.

    • count(Integer) - 유저가 구매한 해당 상품의 수량

    • price(Integer) - 해당 상품의 단가

  • (예시1) [{“count”: 1, “price”: 11900, “id”: “100144”}]
    - 상품 ID가 100144인 단가 11900 짜리 상품을 1개 구매한 경우

  • (예시1) [{“count”: 2, “price”: 11900, “id”: “100144”},{“count”: 3, “price”: 2500, “id”: “100145”}]
    - 상품 ID가 100144인 단가 11900 짜리 상품 2개와 상품 ID가 100145인 단가 2500 짜리 상품을 3개 구매한 경우

Request Example

상품 목록 연동 미진행 시:

https://track.buzzvil.com/action/pb/cps/default/?bz_tracking_id=10023_71ffbffd-ccf1-4edf-9c4c&transaction_id=2012282210547253&count=2

상품 목록 연동 진행 시:

https://track.buzzvil.com/network/pb/sample?bz_tracking_id=10023_71ffbffd-ccf1-4edf-9c4c&transaction_id=2012282210547253&order_list=[{“count”:2,“price”:11900,“id”: “100144”},{“count”:3,“price”:2500,“id”:“100145”}]

Response

• JSON 형식으로 반환

• Field 설명

  • code (Integer) : 처리 결과 코드

    • 200 : 정상

    • 9020 : 중복 요청

    • 그 외 : 에러

  • msg (String) : 처리결과 메세지

Step1. 초기화

<script>
	if (/bz_tracking_id/.test(location.search)) { localStorage.BuzzAd = location.search }
</script>

• BuzzAd를 통해 랜딩되는 광고의 첫 페이지에서 아래의 자바스크립트 코드를 실행합니다.

• 해당 코드는 bz_tracking_id 라는 파라미터가 현재 url의 검색 쿼리 부분에 있다면 이를 localStorage 에 “BuzzAd”라는 이름으로 저장합니다.

Step2. 액션 달성 전송

<script>
  	(function (img) { img.onload = function () {
        if(localStorage.BuzzAd.indexOf('10023_71ffbffd-ccf1-4edf-9c4c') != -1){
          alert("[Success] Action Completed!");
        };
        //*필요시 여기서 리다이렉트 수행*
  	};
  	    var queryString;
  		if (localStorage.BuzzAd == null) { queryString = ""; }
  		else { queryString = localStorage.BuzzAd + "&count={{COUNT}}" + "&transaction_id={{TRANSACTION_ID}}"; }
  		img.src = "//track.buzzvil.com/action/pb/cps/default/pixel.gif" + queryString;
	}) (new Image())
</script>
// postback 요청시마다 COUNT에는 유저가 구매한 수량 값을 TRANSTACTION_ID 에는 고유한 구매 ID 값을 넣어서 해당 스크립트를 호출해야함.

• 광고 페이지를 방문한 사용자가 광고 상품을 구매 시 상단의 JavaScript 코드를 실행합니다.

  • 앞서 저장한 “BuzzAd” 라는 이름의 변수에 count 값과 transaction_id 값을 붙여 서버로 전송합니다. 이 값을 통해 유저가 광고를 통해 상품 구매를 완료했음을 BuzzAd 서버로 전달하여 구매한 내역에 맞는 리워드를 지급할 수 있게 됩니다.