Table of Contents

Abstract: S2S 연동이란?

Info
광고주 웹사이트 및 서버 상 스크립트를 직접 개발해 연동하는 방식입니다. 광고주 서버에서 버즈빌 서버로 직접 통신을 하기 때문에 `Server-to-Server` 라는 명칭을 사용하고 있습니다.

...

Expand

title	bz_tracking_id 란?

Include Page

	[용어집] bz_tracking_id (비즈 트래킹 아이디)
	[용어집] bz_tracking_id (비즈 트래킹 아이디)

Expand

title	상세 동작 원리

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

광고 참여 및 포인트 지급 Flow

Drawio

contentId	406749212
zoom	1
simple	0
pageId	405012616
lbox	1
diagramDisplayName	BuzzAd_cpa_web_flow.drawio
contentVer	2
revision	2
baseUrl	https://buzzvil.atlassian.net/wiki
diagramName	BuzzAd_cpa_web_flow.drawio
width	441
links
tbstyle
height	423.5

[광고 클릭]
BuzzAd의 인벤토리를 통해서 유저가 광고를 클릭하면, BuzzAd 서버에서는 유저의 액션을 트래킹하기 위한 id(식별자)인 bz_tracking_id 를 랜딩 url의 파라미터로 붙여서 전달합니다.
[초기화 스크립트 실행]
유저는 해당 url을 통해 광고주 웹 사이트 상 랜딩 페이지에 랜딩하고, 동시에 랜딩 페이지에 삽입된 초기화 스크립트가 실행되며 bz_tracking_id 라는 파라미터가 현재 url의 검색 쿼리 부분에 있는 경우 전환 스크립트 실행 시 호출 가능한 공간에 저장합니다.
[전환 스크립트 실행]
유저가 전환 행위(ex. 회원가입)를 완료하면, 광고주 서버에서 전환 스크립트가 실행되며 저장해 둔 bz_tracking_id 를 BuzzAd 서버로 전달합니다.
[포인트 지급]
BuzzAd 서버는 전달받은 bz_tracking_id 값을 이용해 광고에 참여 완료한 유저를 식별하고, 해당 유저에게 포인트를 지급합니다.

...

Process: S2S 연동 방법

Info
다음 요건이 충족되면 연동이 완료됩니다!

...

Code	Name	Msg	발생하는 경우	해결 방법
200	RESLUT_OK	ok	올바른 요청인 경우
401	TOO_MANY_REQUEST	too many requests	잘못된 `S2S 연동용 토큰`을 사용한 경우	입력한 `S2S 연동용 토큰` 값 주변에 중괄호가 있는 경우 제거 온보딩 시트 상 발급 된 `S2S 연동용 토큰`의 값과 동일한지 재확인
9020	IS_ALREADY_PARTCIPATED	Already participated.	동일한 정보로 1회 이상 요청한 경우	해결된 것으로 판단하고 다음 단계로 속행
9026	POSTBACK_PARAMETER_NOT_FOUND	POSTBACK_PARAMETER_NOT_FOUND	body에 `bz_tracking_id`값을 비워둔 상태로 포스트백을 송신한 경우	포스트백 header에 Content-Type을 `"application/x-www-form-urlencoded"`로 지정했는지 확인 포스트백 body에 `bz_tracking_id` 값을 채워주는 로직 디버깅
9028	TRACKING_ID_NOT_FOUND	tracking_id not found	잘못된 `bz_tracking_id`을 사용한 경우 (ex. Step 4 상 테스트 도구에서 발급되는 가짜 bz_tracking_id)	curl 기반 API 테스트 전용 bz_tracking_id 사용 `10023_71ffbffd-ccf1-4edf-9c4c`

...

테스트 도구를 사용해 연동 테스트를 진행해주세요.

...

Expand

title	광고를 클릭하지 않은 사용자도 과금되나요?

Include Page

	[광고주 QnA] 광고를 클릭하지 않은 사용자도 과금되나요?
	[광고주 QnA] 광고를 클릭하지 않은 사용자도 과금되나요?

...