여기에서는 Vungle 프로세스 및 사양에 대해 설명하여, 새로운 VAST 파트너가 보유한 기술을 프로그래밍 방식의 광고 플랫폼에 통합할 수 있게 도움을 드립니다.
목차
VAST 응답 사양
입찰 응답은 다음 사양을 준수해야 합니다.
- 비디오 길이 최대 30초
- 최소 전송속도 250kbps
- XML은 다음을 포함해야 합니다.
- .mp4 미디어 파일 한 개
- 전송속도 정보
- 비디오 길이 정보
- 어떤 리디렉션이든 최대 1회 리디렉션할 수 있습니다.
- 응답 시간:
- 스트리밍의 경우: 반드시 250ms 이내
- 미리 캐시된 경우: 반드시 750ms 이내
- 클릭 연결을 통한 방문 페이지 이동 필수
- SSL 지원 및 안전한 자산 응답 필수
- 광고가 없을 경우
‘no-ad’또는‘403’로 응답 - VAST 확장은 선택 사항이지만, 사용을 권장함
위의 요구 사항 중 하나라도 충족되지 않는 경우 Vungle에서 오류를 반환합니다.
Vungle의 파트너 통합 프로토콜
새로운 VAST 파트너가 프로그래밍 방식의 광고 플랫폼에 기술을 통합할 수 있게 Vungle이 도움을 드리는 경우, 해당 프로세스는 두 단계로 나뉩니다. 첫 번째 단계는 일반적인 유효성 검사입니다. Vungle은 태그를 검사하여 서버 호출이 올바르게 시작되고 값이 바르게 채워졌는지 확인합니다. 두 번째 단계에서는 엄격한 테스트를 거치며, 통계적으로 중요한 노출 세트 중에 불일치를 검색하여 Vungle의 숫자와 파트너의 숫자가 일치하게 합니다.
1단계
- 파트너가 Vungle 기술 문서를 전송합니다(가능한 경우).
- 파트너가 Vungle에 테스트 VAST 엔드포인트를 전송합니다.
참고: 의미 있는 테스트 결과를 생성하려면, 파트너가 테스트 단계에서 Vungle의 입찰 요청에 100% 응답해야 합니다.
- Vungle은 필요에 따라 Partner의 엔드포인트를 호출할 수 있는 테스트 환경을 구축합니다.
이는 변수 값 검증 및 비콘 추적에 사용됩니다.
2단계
- Vungle이 파트너와 협력하여 테스트 캠페인을 설정합니다.
- 파트너는 실제 수요를 시뮬레이션하는 테스트엔드 포인트를 전송합니다.
- Vungle은 테스트 캠페인을 설정하고 사전에 결정된 수의 노출을 실행합니다.
VAST 요청 샘플
채워지지 않은 매개 변수가 있는 VAST 요청 샘플 URL(VAST 태그)
https://partner.com/vast2/6524rgww153hifw/?duration=15&app_name={{{pub_app_name}}}&app_id={{{market_id}}}&rtb_type=instream_mobile_vast_inter&user_id={{{device_id}}}&ua={{{browser_user_agent}}}&random={{{timestamp}}}&ip_address={{{ip}}} 채워진 매개 변수가 있는 VAST 요청 샘플 URL(VAST 태그)
https://partner.com/vast2/124765432/?duration=15&app_name=My%20Talking%20Tom%20Free%20for%20Android&app_id=com.outfit7.mytalkingtomfree&rtb_type=instream_mobile_vast_inter&user_id=6df43c89-9e3d-43fb-a1e9-bacd51932d41&ua=Mozilla%2F5.0%20(Linux%3B%20Android%204.4.2%3B%20SPH-L720%20Build%2FKOT49H)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Version%2F4.0%20Chrome%2F30.0.0.0%20Mobile%20Safari%2F537.36&random=2015-01-27T21%3A30%3A34%2B00%3A00&ip_address=66.87.114.254 VAST 요청 매개 변수
| 매개 변수 이름 | 매크로 | 값 | 참고 | 예 |
| 앱 장르 | {{{pub_app_store_category}}} |
문자열 | 장르 목록 | 게임 |
| 앱 이름 | {{{pub_app_name}}} |
문자열 | iTunes 또는 Play 스토어에서 | Family Farm Seaside |
| 앱 스토어 URL | {{{pub_app_store_url}}} |
문자열 | 앱 스토어 또는 콘텐츠 URL. 인코딩됨. | https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en |
| 번들 ID | {{{pub_market_app_id}}} |
String/Int | iTunes 또는 Play 스토어에서 | com.funplus.familyfarm&hl=en (Android) 539920547 (iOS) |
| 도시 | {{{city}}} |
문자열 | 인코딩됨 | 뉴욕 |
| 연결 유형 | {{{connection_type}}} |
문자열 | Wifi, wwan, 모바일 | Wifi, wwan, 모바일 |
| 국가 | {{{country}}} |
문자열 | 국가 코드 2자리 | US |
| 장치 DNT | {{{ad_tracking_disabled}}} |
문자열 | 'True'인 경우 사용자가 광고 추적을 허용하지 않은 것입니다. | True/False |
| 장치 DNT | {{{ad_tracking_enabled}}} |
문자열 | 'True'인 경우 사용자가 광고 추적을 허용한 것입니다. | True/False |
| 장치 DNT | {{{boolean_number ad_tracking_disabled}}} |
Int | 이진법으로 추적 금지 | 0 – False 1 - True |
| 장치 ID | {{{device_id}}} |
문자열 | 삭제 또는 해시 | ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74 |
| 장치 모델 | {{{device_model}}} |
문자열 | 인코딩됨 | Amazon,KFFOWI samsung,SM-J700T |
| IP | {{{ip}}} |
문자열 | 인터넷 프로토콜 주소 | 95.118.153.77 |
| 언어 | {{{language}}} |
문자열 | 헤더의 2글자 언어 | 10.2.1 |
| OS 버전 | {{{os_version}}} |
문자열 | OS 버전(예: iOS 7.2) | 2014-12-05T00%3A44%3A19%2B00%3A00 |
| 플랫폼 | {{{device_platform}}} |
문자열 | iOS 또는 Android | iOS/Android |
| 화면 높이 | {{{screen_height}}} |
정수 | 화면 높이(픽셀) | 768 |
| 화면 방향 | {{{screen_orientation}}} |
문자열 | 세로 또는 가로 | 세로/가로 |
| 화면 폭 | {{{screen_width}}} |
정수 | 화면 폭(픽셀) | 1024 |
| 타임스탬프 | {{{timestamp}}} |
String/Int | 인코딩됨 | 2014-12-05T00:44:19+00:00 |
| 사용자 에이전트 | {{{browser_user_agent}}} |
문자열 | 헤더의 UA 인코딩됨. | Mozilla/5.0 (Linux; Android 5.1.1; VF-1397 Build/LMY47V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/55.0.2883.91 Safari/537.36 |
| Vungle ID | {{{vungle_id}}} |
문자열 | Vungle 퍼블리셔 ID로 실적 연결 | 5497c989a3b61ba3660001b1 |