웹용 필수 및 권장 매개변수

IMA SDK를 사용하지 않고 Ad Exchange에서 태그 기반 동영상 솔루션을 구현하는 기능은 베타 버전이며 일부 네트워크에는 제공되지 않을 수 있습니다. 자세한 내용은 계정 관리자에게 문의하세요.

다음은 VAST 광고 태그 URL 매개변수 중 일부입니다. 이들 매개변수는 IMA SDK 통합을 사용하지 않는 경우 웹용 태그 기반 동영상 솔루션을 위한 것입니다.

앱용 필수 매개변수 또는 프로그래매틱 수익 창출용 필수 및 권장 매개변수 목록을 확인하세요.

 목록에서 특정 매개변수로 이동하기

correlator description_url env gdfp_req iu

output plcmt sz unviewed_position_start

url vpa vpmute wta

 

매개변수	세부정보
correlator (상관자)	상관자 매개변수는 동일한 페이지 조회에서 발생하는 여러 요청에서 함께 사용하는 변수 값을 허용합니다. 이 값은 경쟁 제외(쿠키가 없는 환경에서의 경쟁 제외 포함)를 구현하는 데 사용됩니다. IMA SDK를 사용하는 경우에는 상관자 값이 자동으로 설정됩니다. 플레이어가 이 값을 설정하려고 하면 SDK가 자체 값으로 해당 값을 덮어씁니다. IMA SDK를 사용하지 않는 경우에는 이 값을 복수의 페이지 조회에서 재사용되지 않는 완전한 임의의 정수 값으로 설정해야 합니다. 사용 예 correlator=4345645667 요건 웹 및 앱에서 필수 프로그래매틱 수익 창출에 대해 권장됨
description_url (설명 URL)	설명 URL 매개변수는 페이지에서 재생 중인 동영상을 설명하는 변수 값을 허용합니다. 콘텐츠를 설명하는 1~3개의 단락으로 페이지를 간략하게 설명합니다. 예를 들어 사전 정의된 블록에서 description_url 페이지 콘텐츠를 동적으로 병합합니다. 고유한 설명 URL 제공에 대해 자세히 알아보세요. description_url 값은 웹페이지 동영상 플레이어 및 커넥티드 TV/OTT 기기에 대해 URL 인코딩되어야 하며, 모바일 인앱 동영상 플레이어에 대해서는 인코딩되지 않아야 합니다. 이 매개변수는 IMA SDK에 의해 자동으로 설정되지 않으므로 직접 설정해야 합니다. 사용 예 URL 인코딩: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html 인코딩되지 않음: description_url= https://www.sample.com/golf.html 요구사항 웹, 앱, Ad Exchange에서 필수 프로그래매틱 수익 창출에 대해 권장됨
env (환경)	환경 매개변수는 인스트림 광고 요청을 나타내거나 요청이 명확히 동영상 플레이어에서 발생한 것임을 나타내는 상수 값을 허용합니다. 가능한 값은 instream(동영상 및 오디오 광고에 사용할 수 있음) 또는 vp(동영상 광고에만 사용할 수 있음)입니다. 사용 예 동영상 및/또는 오디오: env=instream 동영상만: env=vp 요건 웹 및 앱에서 필수
gdfp_req (Ad Manager 스키마 표시기)	Ad Manager 스키마 표시기 매개변수는 사용자가 Ad Manager 스키마에 있음을 나타내는 상수 값을 허용합니다. 사용 예 gdfp_req=1 요건 웹 및 앱에 대해 필수임
iu (광고 단위)	광고 단위 매개변수는 다음과 같은 형식으로, 현재 광고 단위로 설정되어야 하는 변수 값을 허용합니다. /network_id/.../ad_unit 사용 예 iu=/6062/videodemo 요건 웹 및 앱에 대해 필수임
output (광고 출력 형식)	광고 출력 형식 매개변수는 광고의 출력 형식으로 설정되는 상수 값을 허용합니다. 네트워크에 대해 설정된 기본 VAST 버전에는 output=vast를 사용하세요. 특정 광고 태그 또는 사이트 일부에 대해 특정 VAST 또는 VMAP 버전을 요청할 수 있습니다. VAST의 경우 동영상 플레이어가 IMA SDK를 사용하면 동영상 광고 요청에 대한 출력 매개변수가 항상 output=xml_vast4로 설정됩니다. SDK는 외부 광고 서버에서 제공할 수 있는 모든 VAST 버전과 하위 호환되므로 안정성은 걱정하지 않아도 됩니다. 네트워크에 대해 활성화한 기본 VMAP 버전(예: VMAP 1)을 반환하려면 output=vmap을 사용하세요. VMAP 내에서 VAST를 반환하는 경우 xml_vmap1_vast3 또는 xml_vmap1_vast4를 사용하여 반환할 VAST 버전을 지정할 수 있습니다. 사용 예 네트워크의 기본 VAST 설정: output=vast VAST 4: output=xml_vast4 네트워크의 기본 VMAP 설정: output=vmap VMAP 1: output=xml_vmap1 VAST 4를 반환하는 VMAP 1: output=xml_vmap1_vast4 요건 웹 및 앱에서 필수
plcmt (게재위치)	게재위치 매개변수는 IAB 사양의 안내에 따라 인스트림 인벤토리가 인스트림 또는 함께 표시되는 콘텐츠로 선언되는지 여부를 나타내는 데 사용되는 상수 값을 허용합니다. 비인스트림 요청의 경우, 이 필드는 선언된 인벤토리 형식에 따라 구매자에 대해 자동으로 채워지며 인스트림 또는 함께 제공되는 콘텐츠 선언을 재정의합니다. 사용 예 인스트림 요청: plcmt=1 함께 표시되는 콘텐츠 요청: plcmt=2 요구사항   웹 및 프로그래매틱 수익 창출에 필수
sz (크기)	크기 매개변수는 마스터 동영상 광고 슬롯의 크기를 전달하는 변수 값을 허용합니다. 크기는 여러 개인 경우 파이프(|) 문자로 구분해야 합니다. 크기 뒤에 'v'를 붙이지 마세요. 사용 예 sz=400x300 요건 웹 및 앱에서 필수 이 매개변수는 ad_type=audio만 요청하는 경우 선택사항입니다.
unviewed_position_start (지연된 노출수)	지연된 노출 매개변수는 동영상의 지연된 노출을 나타내는 상수 값을 허용합니다. 사용 예 unviewed_position_start=1 요건 웹 및 앱에서 필수
url (URL)	URL 매개변수는 요청이 전송되는 전체 URL로 설정되어야 하는 변수 값을 허용합니다. 이 값은 구매자가 이 요청의 출처를 파악하고 이해하는 데 필요합니다. 가능한 한 이 값은 광고 요청에서 동적으로 채워져야 합니다.  이는 웹페이지에서는 동영상 플레이어를 표시하는 페이지의 URL입니다. IMA SDK를 사용하는 경우 URL 값이 자동으로 설정됩니다. 플레이어가 이 값을 설정하는 경우 IMA SDK는 설정되는 값을 사용합니다. 앱(휴대기기 또는 CTV)에서 이 값은 수익을 창출하는 동영상 또는 오디오 인벤토리를 가장 정확하게 나타내는 URL로 설정되어야 합니다. 예를 들어 사용자가 모바일 앱 내에서 동영상을 보고 있는 경우 그 동영상은 데스크톱의 동일한 URL에서도 볼 수 있는 것입니다.* 이 매개변수의 값을 인코딩해야 합니다. 사용 예 url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * 앱의 경우 이 매개변수를 변수 URL 값으로 설정할 수 없다면 다음 패턴으로 설정하는 것이 좋습니다. url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com 요구사항 웹 및 앱에서 필수 프로그래매틱 수익 창출에 대해 권장됨
vpa (동영상 자동 재생)	다음에 따라 권장됨: MRC 동영상 측정 가이드라인 동영상 재생 자동 매개변수는 광고의 동영상 콘텐츠가 자동재생을 통해 시작되는지 아니면 클릭을 통해 시작되는지를 나타내는 상수 값을 허용합니다. 가능한 값은 페이지에서 사용자 작업을 기다리는 경우 click이고, 동영상이 자동 재생되는 경우에는 auto입니다. 알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다. 사용 예 자동재생: vpa=auto 클릭 재생방식: vpa=click 요건 프로그래매틱 수익 창출에 대해 권장됨
vpmute (동영상 재생 음소거)	다음에 따라 권장됨: MRC 동영상 측정 가이드라인 음소거된 동영상 매개변수는 동영상 플레이어가 음소거되어 있는 동안 광고 재생이 시작되는지를 나타내는 상수 값을 허용합니다. 사용 예 음소거됨: vpmute=1 음소거 해제됨: vpmute=0 요구사항   웹 및 프로그래매틱 수익 창출에 필수
wta (이 광고가 표시된 이유)	'이 광고가 표시된 이유' 파라미터는 동영상 플레이어에서 광고 배지 표시 렌더링을 지원함을 나타내는 상수 값을 허용합니다. &wta 파라미터를 전송하지 않으면 기본값은 &wta=1입니다. 광고 배지 표시 기능은 IMA SDK를 사용하는 경우 자동으로 지원됩니다. IMA SDK를 사용하지 않는 경우에는 IAB VAST 표준에 설명된 대로 동영상 플레이어가 VAST Icon 및 IconClickFallbackImage 지원을 구현해야 합니다. 게시자가 VAST 응답에 제공된 AdChoices 아이콘을 렌더링하지 않을 경우 게시자는 &wta=0을 보내야 합니다. &wta=1이 있거나 &wta 파라미터가 없는 광고 요청은 게시자가 제공된 AdChoices 정보를 렌더링할 것임을 나타낸다고 간주됩니다. VAST 응답에 제공된 AdChoices 아이콘이 컴패니언에서 렌더링되거나 사용자에게 제공되는 경우 오디오 광고 요청에서는 wta=1을 전송할 수 있습니다. EEA의 트래픽의 경우 &wta=0이 포함된 요청은 Google 배지가 사용 설정된 예약 광고 소재에 게재할 수 없습니다. 광고가 유럽 경제 지역(EEA)에서 게재되는 광고에 적용되는 규제 요건을 준수해야 합니다. 여기에는 사용자가 불법 콘텐츠를 신고할 수 있는 메커니즘이 포함됩니다. 게시자는 불법 콘텐츠 신고가 있을 경우 적절한 양식을 사용하여 Google에 알려야 합니다. 사용 예 지원됨: wta=1 또는 wta 파라미터 없음 지원되지 않음: wta=0 요건 Ad Exchange에 필수임 웹 및 앱 EEA 트래픽에 필수임 프로그래매틱 수익 창출에 대해 권장됨