Versions Compared

Key

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

...

사용자가 특정한 액션을 수행하면 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)

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

Info

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

5

HTTP Header

  • Authorization

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

Note

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

6

Response

  • JSON 형식으로 반환

  • Field 설명

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

      • 200 : 정상

      • 401 : token 인증 실패

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

      • 9020 : 중복 요청

      • 그 외 : 에러

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

...

Info

연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다.

버즈빌 기술지원팀: csm@buzzvil.com

FAQ

Expand
title위의 코드가 무엇을 위한 것인가요?

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

광고 참여 및 포인트 지급 Flow

Drawio
contentId406749212
zoom1
simple0
pageId405012616
lbox1
diagramDisplayNameBuzzAd_cpa_web_flow.drawio
contentVer2
revision2
baseUrlhttps://buzzvil.atlassian.net/wiki
diagramNameBuzzAd_cpa_web_flow.drawio
width441
links
tbstyle
height423.5
  1. BuzzAd의 인벤토리를 통해서 유저가 광고주의 광고로 랜딩하여 들어올 때, BuzzAd 서버에서는 유저의 액션을 트래킹하기 위한 id인 bz_tracking_id 를 원래의 랜딩 url에 파라미터로 붙여서 전달합니다.

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

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