Abstract: S2S 연동이란?
광고주 웹사이트 및 서버 상 스크립트를 직접 개발해 연동하는 방식입니다.
광고주 서버에서 버즈빌 서버로 직접 통신을 하기 때문에 Server-to-Server
라는 명칭을 사용하고 있습니다.
S2S 연동에서 주요 페이지는 다음 2가지 입니다.
랜딩 페이지
: 사용자가 광고 클릭 후 처음 도착하는 페이지전환 페이지
: 사용자가 광고주가 기대하는 전환 행위(ex. 회원가입)을 완료하고 처음 도착하는 페이지
S2S 연동을 위해서는 다음 2가지 스크립트 직접 개발해야 합니다.
초기화 스크립트
:랜딩 페이지
에서 실행되어 bz_tracking_id 값을 저장전환 스크립트
:광고주 서버
에서 실행되어 저장해둔 bz_tracking_id 값을 사용해, 버즈빌로 전환 포스트백을 송신
Process: S2S 연동 방법
다음 요건이 충족되면 연동이 완료됩니다!
STEP 1. 준비
- 광고주 웹사이트 상
랜딩 페이지
의 소스코드를 편집할 수 있게 준비해주세요 - 광고주 웹사이트의 서버(BE)의 소스코드를 편집할 수 있게 준비해주세요
STEP 2. 초기화 스크립트 개발
- 다음 조건에 맞는 초기화 스크립트를 개발해주세요.
- 랜딩 페이지 URL query string에 “bz_tracking_id” 라는 파라미터가 있는 경우 그 값을 저장함
- 저장된 값은 추후 전환 페이지에서 사용할 수 있는 공간에 저장되어야 함
STEP3. 전환 스크립트 개발
- 아래 API 명세를 참고해서 다음 조건에 맞는 전환 스크립트를 개발해주세요.
- 사용자가 전환 행위를 완료할 경우 아래 API를 통해 버즈빌 서버로 전환 요청 (http request)를 송신함
- 회원 가입과 같이 여러 경로로 (ex. 소셜 회원가입) 전환 행위가 가능한 경우 모든 경우를 포함해 전환 스크립트가 올바르게 동작하도록 개발해주세요.
- 다음 curl 명령어 상
S2S 연동용 토큰
부분을 실제 토큰 값으로 치환하고 올바르게 동작에 하는 지 확인해 주세요.
(주의: 중괄호 “{}” 생략)
curl -H "Authorization: Bearer {S2S 연동용 토큰을 여기에 넣어주세요}" https://track.buzzvil.com/action/pb/s2s/\?bz_tracking_id\=10023_71ffbffd-ccf1-4edf-9c4c
POST https://track.buzzvil.com/action/pb/s2s/
분류 | Key | Type | Description |
---|---|---|---|
Header | Authorization | string |
|
Content-Type | string |
| |
Body | bz_tracking_id | string |
|
Response (msg)
Code | Name | Msg | 발생하는 경우 | 해결 방법 |
---|---|---|---|---|
200 | RESLUT_OK | ok |
| |
401 | TOO_MANY_REQUEST | too many requests |
|
|
9020 | IS_ALREADY_PARTCIPATED | Already participated. |
|
|
9026 | POSTBACK_PARAMETER_NOT_FOUND | POSTBACK_PARAMETER_NOT_FOUND |
|
|
9028 | TRACKING_ID_NOT_FOUND | tracking_id not found |
|
|
STEP4. 연동 테스트 진행
테스트 도구를 사용해 연동 테스트를 진행해주세요.
FAQ
연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다.
버즈빌 기술지원팀: csm@buzzvil.com