Index

1. 개요

버즈빌 SIS 광고 제품을 이용하기 위한 가이드입니다. 필수 정보를 pquery 형태로 넘겨주셔야 광고 할당이 가능합니다.

2. 기본 URL 구조

https://ad.buzzvil.com/action/api/ads/uahub/buzzad?pquery=[인코딩된_파라미터]&custom=[커스텀_파라미터]

3. 파라미터 (pquery)

pquery 파라미터는 다음 정보를 포함한 JSON 객체를 URI 인코딩 후 Base64로 인코딩하여 생성합니다.

3.1 필수 파라미터

파라미터	설명	예시
unit_id	버즈빌에서 발급드린 고유 식별자	1234567
puid	매체사 암호화 유저 ID	"user123"
ifa	광고 ID	"a31752d2-5d7e-4f41-a45c-af4d39d2fb2d"
client_ip	사용자의 IP 주소	"192.168.1.1"
platform	운영 체제 정보	"A" (Android) 또는 "I" (iOS)

3.2 선택적 파라미터

파라미터	설명	예시
birthday	생년월일 (우선순위 높음)	"1990-01-01"
year_of_birth	출생년도	"1990"
sex	성별	"M" 또는 "F"
region	지역	"서울특별시 강남구"
device_name	단말기기 정보	"SHV-E250S"
carrier	통신사	"kt", "skt", "lgt" 또는 null

4. 파라미터 인코딩 과정

자바스크립트 기준의 예시입니다.

JSON 객체 생성
URI 인코딩 (JavaScript의 encodeURIComponent() 함수 사용)
Base64 인코딩 (JavaScript의 btoa() 함수 사용)

예시 JSON

{
  "puid": "암호화된 유저 ID",
  "ifa": "a31752d2-5d7e-4f41-a45c-af4d39d2fb2d",
  "birthday": "1990-01-01",
  "year_of_birth": "1989",
  "sex": "M",
  "platform": "A",
  "carrier": "kt",
  "device_name": "SHV-E250S",
  "region": "서울특별시 강남구"
}

'{"puid":"암호화된 유저 ID","ifa":"a31752d2-5d7e-4f41-a45c-af4d39d2fb2d","birthday":"1990-01-01","year_of_birth":"1989","sex":"M","platform":"A","carrier":"kt","device_name":"SHV-E250S","region":"서울특별시 강남구"}'

URI 인코딩

let jsonString = '{"puid":"암호화된 유저 ID","ifa":"a31752d2-5d7e-4f41-a45c-af4d39d2fb2d","birthday":"1990-01-01","year_of_birth":"1989","sex":"M","platform":"A","carrier":"kt","device_name":"SHV-E250S","region":"서울특별시 강남구"}';
let uriEncodedString = encodeURIComponent(jsonString);

Base64 인코딩

let base64EncodedString = btoa(uriEncodedString);

최종 p값 생성

위에서 얻은 Base64 인코딩된 문자열이 최종적으로 p 쿼리 값이 됩니다. 이 값을 URL의 쿼리 파라미터로 넘겨주셔야 합니다.

https://buzzad-pointhub.buzzvil.com/hub/[unit_id]/?pquery=p=JTdCJTIyaWZhJTIyJTNBJTIyRVRFR0RHUkVHLTExQUFBLUJCQjIyMzQ1JTIyJTJDJTIyYWdlJTIyJTNBMzAlMkMlMjJzZXglMjIlM0ElMjJNJTIyJTJDJTIycGxhdGZvcm0lMjIlM0ElMjJBJTIyJTJDJTIyY2FycmllciUyMiUzQSUyMmt0JTIyJTJDJTIyZGV2aWNlX25hbWUlMjIlM0ElMjJTSFYtRTI1MFMlMjIlMkMlMjJyZWdpb24lMjIlM0ElMjIlRUMlODQlOUMlRUMlOUElQjglRUQlOEElQjklRUIlQjMlODQlRUMlOEIlOUMlMjAlRUElQjAlOTUlRUIlODIlQTglRUElQjUlQUMlMjIlN0Q=

5. 주의사항

birthday와 year_of_birth 중 birthday가 우선순위가 높습니다. 정확한 나이 계산을 위해 가능한 birthday를 사용하세요.
모든 선택적 파라미터는 가능한 제공하는 것이 좋습니다. 선택 파라미터가 없을 경우 할당 받을 수 있는 광고 물량에 제한이 생깁니다. 예를 들어 성별 정보를 보내주지 않는 경우 성별 타겟팅된 광고를 받을 수 없습니다.

6. 지원 및 문의

연동 과정에서 문제가 발생하거나 추가 정보가 필요한 경우, Buzzvil 기술 지원팀에 문의해 주시기 바랍니다.

csm@buzzvil.com