| Table of Contents |
|---|
| Warning |
|---|
JavaScript 방식으로 연동을 완료했을 경우 본 항목은 불필요합니다. |
사용자가 특정한 액션을 수행하면 BuzzAd 서버로 액션이 수행 되었음을 알려주어야 합니다. 연동은 다음과 같이 수행합니다.
Server to Server 연동하기
...
항목
...
내용
...
요청 방향
...
광고주 → 버즈빌
...
HTTP Request method
...
POST or GET
...
HTTP Request URL
...
https://track.buzzvil.com/action/pb/cpa/default/
...
HTTP Request parameters
...
Field 설명
bz_tracking_id(String)광고와 유저 트래킹을 위한 아이디
| Info |
|---|
BuzzAd에서 광고와 연결된 URL로 전환 시 함께 전달되는 값으로, 광고주 웹 사이트는 이 값( |
...
Response
...
JSON 형식으로 반환
Field 설명
code(Integer) : 처리 결과 코드200 : 정상
9020 : 중복 요청
그 외 : 에러
msg(String) : 처리결과 메세지
테스트용 bz_tracking_id
bz_tracking_id= 10023_71ffbffd-ccf1-4edf-9c4cex) https://track.buzzvil.com/action/pb/cpa/default/?bz_tracking_id=10023_71ffbffd-ccf1-4edf-9c4c
| Info |
|---|
연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다. 버즈빌 기술지원팀: tech-support@buzzvil.com |
FAQ
...
| title | 위의 코드가 무엇을 위한 것인가요? |
|---|
...
Abstract: S2S 연동이란?
| Info |
|---|
광고주 웹사이트 및 서버 상 스크립트를 직접 개발해 연동하는 방식입니다. |
...
S2S 연동에서 주요 페이지는 다음 2가지 입니다.
랜딩 페이지: 사용자가 광고 클릭 후 처음 도착하는 페이지전환 페이지: 사용자가 광고주가 기대하는 전환 행위(ex. 회원가입)을 완료하고 처음 도착하는 페이지
S2S 연동을 위해서는 다음 2가지 스크립트 직접 개발해야 합니다.
초기화 스크립트:랜딩 페이지에서 실행되어 bz_tracking_id 값을 저장전환 스크립트:광고주 서버에서 실행되어 저장해둔 bz_tracking_id 값을 사용해, 버즈빌로 전환 포스트백을 송신
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Expand | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
BuzzAd 의 인벤토리(=광고 지면)를 통해 들어온 유저가 광고주의 웹 페이지에서 특정 동작을 수행했는지 여부를 트래킹하는 상품입니다. 광고 참여 및 포인트 지급 Flow
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Process: S2S 연동 방법
| Info |
|---|
다음 요건이 충족되면 연동이 완료됩니다! |
STEP 1. 준비
- 광고주 웹사이트 상
랜딩 페이지의 소스코드를 편집할 수 있게 준비해주세요 - 광고주 웹사이트의 서버(BE)의 소스코드를 편집할 수 있게 준비해주세요
STEP 2. 초기화 스크립트 개발
- 다음 조건에 맞는 초기화 스크립트를 개발해주세요.
- 랜딩 페이지 URL query string에 “bz_tracking_id” 라는 파라미터가 있는 경우 그 값을 저장함
- 저장된 값은 추후 전환 페이지에서 사용할 수 있는 공간에 저장되어야 함
STEP3. 전환 스크립트 개발
- 아래 API 명세를 참고해서 다음 조건에 맞는 전환 스크립트를 개발해주세요.
- 사용자가 전환 행위를 완료할 경우 아래 API를 통해 버즈빌 서버로 전환 요청 (http request)를 송신함
- 회원 가입과 같이 여러 경로로 (ex. 소셜 회원가입) 전환 행위가 가능한 경우 모든 경우를 포함해 전환 스크립트가 올바르게 동작하도록 개발해주세요.
- 다음 curl 명령어 상
S2S 연동용 토큰부분을 실제 토큰 값으로 치환하고 올바르게 동작에 하는 지 확인해 주세요.
(주의: 중괄호 “{}” 생략)
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Code Block |
|---|
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
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
| Info |
|---|
연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다. 버즈빌 기술지원팀: csm@buzzvil.com |