2.2. 광고주 CPA Web - Server to Server(S2S) 연동

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

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

	항목	내용
1	요청 방향	광고주 → 버즈빌
2	HTTP Request method	POST or GET
3	HTTP Request URL	https://track.buzzvil.com/action/pb/cpa/default/
4	HTTP Request parameters	Field 설명 `bz_tracking_id` (String) 광고와 유저 트래킹을 위한 아이디 BuzzAd에서 광고와 연결된 URL로 전환 시 함께 전달되는 값으로, 광고주 웹 사이트는 이 값(`bz_tracking_id`)을 보관하였다가 액션 달성 API 호출 시 다시 전달해주어야 합니다.
5	Response	JSON 형식으로 반환 Field 설명 `code` (Integer) : 처리 결과 코드 200 : 정상 9020 : 중복 요청 그 외 : 에러 `msg` (String) : 처리결과 메세지

테스트용 bz_tracking_id

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

버즈빌 기술지원팀: tech-support@buzzvil.com

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

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

광고 참여 및 포인트 지급 Flow

BuzzAd의 인벤토리를 통해서 유저가 광고주의 광고로 랜딩하여 들어올 때, BuzzAd 서버에서는 유저의 액션을 트래킹하기 위한 id인 bz_tracking_id 를 원래의 랜딩 url에 파라미터로 붙여서 전달합니다.
광고주 페이지에서 유저의 액션이 완료되면, Javascript 연동 코드를 통해 또는 광고주 서버로부터 API 호출을 통해bz_tracking_id 를 전달합니다.
BuzzAd 서버에서는 전달받은 bz_tracking_id 값을 이용해 광고에 참여 완료한 유저 정보를 찾아서 해당 유저에게 포인트를 지급합니다.