UA 모아보기(SIS) 연동 가이드
- Kai Lee
- Will Choi
Index
- 1 Index
- 2 1. 개요
- 3 2. 기본 URL 구조
- 4 3. 파라미터 (pquery)
- 4.1 3.1 필수 파라미터
- 4.2 3.2 선택적 파라미터
- 5 4. 파라미터 인코딩 과정
- 5.1.1 URI 인코딩
- 5.1.2 Base64 인코딩
- 5.1.3 최종 p값 생성
- 5.2 5. 주의사항
- 5.3 6. 지원 및 문의
1. 개요
버즈빌 SIS 광고 제품을 이용하기 위한 가이드입니다. 필수 정보를 pquery 형태로 넘겨주셔야 광고 할당이 가능합니다.
2. 기본 URL 구조
https://ad.buzzvil.com/action/api/ads/uahub/:publisher_path?pquery=[인코딩된_파라미터]&custom=[커스텀_파라미터]publisher_path : 버즈빌과 사전 협의된 path를 입력합니다.
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 인코딩
Base64 인코딩
최종 p값 생성
위에서 얻은 Base64 인코딩된 문자열이 최종적으로 p 쿼리 값이 됩니다. 이 값을 URL의 쿼리 파라미터로 넘겨주셔야 합니다.
5. 주의사항
birthday와year_of_birth중birthday가 우선순위가 높습니다. 정확한 나이 계산을 위해 가능한birthday를 사용하세요.모든 선택적 파라미터는 가능한 제공하는 것이 좋습니다. 선택 파라미터가 없을 경우 할당 받을 수 있는 광고 물량에 제한이 생깁니다. 예를 들어 성별 정보를 보내주지 않는 경우 성별 타겟팅된 광고를 받을 수 없습니다.
6. 지원 및 문의
연동 과정에서 문제가 발생하거나 추가 정보가 필요한 경우, Buzzvil 기술 지원팀에 문의해 주시기 바랍니다.