2.4. 광고주 CPA Web - Server to Server(S2S) 인증 강화

JavaScript 방식으로 연동을 완료했을 경우 본 항목은 불필요합니다.

사용자가 특정한 액션을 수행하면 BuzzAd 서버로 액션이 수행 되었음을 알려주어야 합니다. 연동은 다음과 같이 수행합니다.

Server to Server 연동하기

항목

내용

항목

내용

1

요청 방향

광고주 → 버즈빌

2

HTTP Request method

GET or POST

3

HTTP Request URL

https://track.buzzvil.com/action/pb/s2s/

4

HTTP Request parameters

Field 설명

  • bz_tracking_id (String)

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

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

5

HTTP Header

  • Authorization

    • Bearer {{token}} 포맷으로 전달

Token 값은 버즈빌 담당자로부터 발급받아 주세요.

6

Response

  • JSON 형식으로 반환

  • Field 설명

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

      • 200 : 정상

      • 401 : token 인증 실패

        • HTTP Header 값에 정확한 포맷으로 정확한 값을 보냈는지 확인 필요

      • 9020 : 중복 요청

      • 그 외 : 에러

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

curl -H "Authorization: Bearer {token}" https://track.buzzvil.com/action/pb/s2s/\?bz_tracking_id\=10023_71ffbffd-ccf1-4edf-9c4c

FAQ

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

광고 참여 및 포인트 지급 Flow

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

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

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