앱용 필수 매개변수

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

다음은 VAST 광고 태그 URL 매개변수 중 일부입니다. 이러한 매개변수는 IMA SDK와 통합하지 않는 경우 앱용 태그 기반 동영상 솔루션에 대해 필수입니다.

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

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

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

매개변수	세부정보
correlator (상관자)	상관자 매개변수는 동일한 페이지 조회에서 발생하는 여러 요청에서 함께 사용하는 변수 값을 허용합니다. 이 값은 경쟁 제외(쿠키가 없는 환경에서의 경쟁 제외 포함)를 구현하는 데 사용됩니다. IMA SDK를 사용하는 경우에는 상관자 값이 자동으로 설정됩니다. 플레이어가 이 값을 설정하려고 하면 SDK가 자체 값으로 해당 값을 덮어씁니다. IMA SDK를 사용하지 않는 경우에는 이 값을 복수의 페이지 조회에서 재사용되지 않는 완전한 임의의 정수 값으로 설정해야 합니다. 사용 예 correlator=4345645667 요건 웹 및 앱에서 필수 프로그래매틱 수익 창출에 대해 권장됨
description_url (설명 URL)	설명 URL 매개변수는 페이지에서 재생 중인 동영상을 설명하는 변수 값을 허용합니다. 일반적으로 동영상 플레이어가 포함된 페이지를 뜻하지만 동영상을 설명하는 텍스트가 있는 페이지일 수도 있습니다. description_url 값은 웹페이지 동영상 플레이어 및 CTV/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 요건 웹 및 앱에 대해 필수임
msid (앱 ID) an (앱 이름)	앱 ID 및 이름 매개변수는 대부분의 프로그래매틱 동영상 광고에 대해 필수이므로 모바일 앱 및 커넥티드 TV 기기에서 전송된 요청에 적용되어야 하는 변수 값을 허용합니다. 두 매개변수는 IMA SDK가 자동으로 채우지만, 직접 VAST 호출(비 SDK 환경)에서는 두 매개변수를 직접 지정해야 합니다. 앱 이름은 인간이 읽을 수 있는 이름이어야 합니다. iOS 및 tvOS에서는 SDK가 앱 ID에 액세스할 수 없습니다. 이러한 경우에는 msid 매개변수가 전송되지 않으며, SDK가 an 매개변수를 통해 App Bundle을 전송합니다. 사용 예 msid=com.package.publisher&an=sample%20app 앱 ID는 앱 스토어별로 이름과 형식이 다릅니다. 앱 식별을 위한 IAB 가이드라인 또는 일반 고유 식별자의 예를 참고하세요. 앱 스토어가 없는 플랫폼의 경우 IAB에서는 스토어 ID에 com.publisher.deviceplatform 형식을 사용하도록 권장합니다. 요구사항 두 매개변수 모두 앱에 필요합니다. 프로그래매틱 수익 창출에 대해 권장됨
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 요건 웹 및 앱에서 필수
pvid (앱 세트 ID) pvid_s (앱 세트 범위)	사용자가 Android 기기에서 맞춤설정을 선택 해제할 경우 수익 창출을 위해 앱 세트 ID 값이 필요합니다. pvid 매개변수는 Android 앱 세트 ID로 설정된 변수 값을 허용하고, pvid_s 매개변수는 앱 세트 ID의 범위를 나타내는 상수 값을 허용합니다(scope_app 또는 scope_developer 중 하나). IMA/PAL SDK는 이 필드를 자동으로 전달하지만 비 SDK 구현을 사용하는 게시자는 앱 세트 SDK를 호출하고 광고 요청에서 이러한 매개변수를 수동으로 전달해야 합니다. 앱 세트 ID를 검색하는 방법은 Android 문서를 참조하세요. 사용 예 pvid=[AppSetID_value] pvid_s=scope_app 요건 앱에서 필수 프로그래매틱 수익 창출에 대해 권장됨
rdid idtype is_lat (재설정 가능한 기기 식별자)	재설정 가능한 기기 식별자는 변수 값을 허용합니다. SDK는 내장 애플리케이션(웹 또는 모바일 웹에는 없음)을 통해 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat용 매개변수와 함께 스트림 요청으로 전달합니다. SSB 스트림에서는 클라이언트 측 광고 요청과 마찬가지로, 이러한 매개변수를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요. 거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다. iOS 14.5부터는 Apple이 LAT 신호에 대한 지원을 중단했습니다.대신 Google은 0이 아닌 IDFA가 있는지를 기반으로 하여 사용자가 앱 추적 투명성을 지원하는 iOS 버전에서 추적에 동의했음을 나타냅니다. 따라서 올바른 OS 버전을 나타내는 유효한 UserAgent가 필수입니다. 사용 예 재설정 가능한 기기 식별자의 자세한 예를 확인하세요. 요건 앱에서 필수 프로그래매틱 수익 창출의 경우 권장
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 요구사항 웹 및 앱에서 필수 프로그래매틱 수익 창출에 대해 권장됨
wta (이 광고가 표시된 이유)	'이 광고가 표시된 이유' 매개변수는 동영상 플레이어가 '이 광고가 표시된 이유'에 대한 렌더링을 지원함을 나타내는 상수 값을 허용합니다. '이 광고가 표시된 이유' 기능은 IMA SDK를 사용하는 경우 자동으로 지원됩니다. IMA SDK를 사용하지 않는 경우에는 IAB VAST 표준에 설명된 대로 동영상 플레이어가 VAST Icon 및 IconClickFallbackImage 지원을 구현해야 합니다. VAST 응답에 제공된 AdChoices 아이콘이 컴패니언에서 렌더링되거나 사용자에게 제공되는 경우 오디오 광고 요청에서는 wta=1을 전송해야 합니다. EEA에서 Google 광고 수요 및 Google이 호스팅하는 예약 트래픽에 사용하려면 광고 요청에서 VAST 응답에 제공된 대로 동영상 광고, 컴패니언 광고 또는 모든 광고 소재에 대해 사용자에게 제공되는 AdChoices 아이콘이 렌더링되었음을 나타내는wta=1을 전송해야 합니다. 사용 예 지원됨: wta=1 지원되지 않음: wta=0 요건 Ad Exchange에 필수임 웹 및 앱 EEA 트래픽에 필수임 프로그래매틱 수익 창출에 대해 권장됨