Index
1. 개요
버즈빌 SIS 광고 제품을 이용하기 위한 가이드입니다. 필수 정보를 pquery 형태로 넘겨주셔야 광고 할당이 가능합니다.
2. 기본 URL 구조
2.1 Staging (테스트 환경)
https://buzzad-pointhub-staging.buzzvil.com/hub/[unit_id]/?pquery=[인코딩된_파라미터]
2.2 Production (실제 환경)
https://buzzad-pointhub.buzzvil.com/hub/[unit_id]/?pquery=[인코딩된_파라미터]
여기서 [unit_id]는 Buzzvil에서 발급한 고유 식별자입니다.
위 페이지의 운영상의 이유로 [unit_id] 뒤에 / (slash)를 반드시 사용해야합니다.
3. 파라미터 (pquery)
pquery 파라미터는 다음 정보를 포함한 JSON 객체를 URI 인코딩 후 Base64로 인코딩하여 생성합니다.
3.1 필수 파라미터
파라미터 | 설명 | 예시 |
|---|---|---|
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 기술 지원팀에 문의해 주시기 바랍니다.