Vungle VAST 2.0 통합 설명서

여기에서는 Vungle 프로세스 및 사양에 대해 설명하여, 새로운 VAST 파트너가 보유한 기술을 프로그래밍 방식의 광고 플랫폼에 통합할 수 있게 도움을 드립니다.

목차

VAST 응답 사양

입찰 응답은 다음 사양을 준수해야 합니다.

  • 비디오 길이 최대 30초
  • 최소 전송속도 250kbps
  • XML은 다음을 포함해야 합니다.
        • .mp4 미디어 파일 한 개
        • 전송속도 정보
        • 비디오 길이 정보
  • 어떤 리디렉션이든 최대 1회 리디렉션할 수 있습니다.
  • 응답 시간:
        • 스트리밍의 경우: 반드시 250ms 이내
        • 미리 캐시된 경우: 반드시 750ms 이내
  • 클릭 연결을 통한 방문 페이지 이동 필수
  • SSL 지원 및 안전한 자산 응답 필수
  • 광고가 없을 경우 ‘no-ad’ 또는 ‘403’로 응답
  • VAST 확장은 선택 사항이지만, 사용을 권장함

위의 요구 사항 중 하나라도 충족되지 않는 경우 Vungle에서 오류를 반환합니다.

Vungle의 파트너 통합 프로토콜

새로운 VAST 파트너가 프로그래밍 방식의 광고 플랫폼에 기술을 통합할 수 있게 Vungle이 도움을 드리는 경우, 해당 프로세스는 두 단계로 나뉩니다. 첫 번째 단계는 일반적인 유효성 검사입니다. Vungle은 태그를 검사하여 서버 호출이 올바르게 시작되고 값이 바르게 채워졌는지 확인합니다. 두 번째 단계에서는 엄격한 테스트를 거치며, 통계적으로 중요한 노출 세트 중에 불일치를 검색하여 Vungle의 숫자와 파트너의 숫자가 일치하게 합니다.

1단계

  1. 파트너가 Vungle 기술 문서를 전송합니다(가능한 경우).

  2. 파트너가 Vungle에 테스트 VAST 엔드포인트를 전송합니다.
    참고: 의미 있는 테스트 결과를 생성하려면, 파트너가 테스트 단계에서 Vungle의 입찰 요청에 100% 응답해야 합니다.

  3. Vungle은 필요에 따라 Partner의 엔드포인트를 호출할 수 있는 테스트 환경을 구축합니다.
    이는 변수 값 검증 및 비콘 추적에 사용됩니다.

2단계

  1. Vungle이 파트너와 협력하여 테스트 캠페인을 설정합니다.
  • 파트너는 실제 수요를 시뮬레이션하는 테스트엔드 포인트를 전송합니다.
  • Vungle은 테스트 캠페인을 설정하고 사전에 결정된 수의 노출을 실행합니다.

  • 파트너와 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

     

    또 다른 질문이 있으십니까? 문의 등록

    댓글