이 도움말에서는 VAST 광고 태그에 사용할 수 있는 매개변수의 전체 목록을 보여줍니다. 특정 매개변수에 대해 자세히 알아보려는 경우 유용할 수 있습니다.
클릭 가능한 모든 매개변수의 알파벳 색인 보기이 페이지의 내용
구현 유형별 매개변수 목록
특정 구현을 사용하는 경우 해당 구현의 사용 및 요구사항을 요약하는 맞춤 매개변수 목록을 사용할 수 있습니다. 맞춤 매개변수 목록은 다음과 같은 경우에 사용합니다.
모든 매개변수
광고 게재에 필요한 매개변수
일반적으로 이러한 매개변수는 대부분의 구현에서 광고를 게재하는 데 필요합니다. 하지만 필수사항은 아닙니다. 가장 정확한 목록을 보려면 특정 구현 유형의 매개변수 목록을 사용하세요.
correlator(상관자)
설명
상관자 매개변수(correlator)는 동일한 페이지 조회에서 발생하는 여러 요청에서 함께 사용하는 변수 값을 허용합니다. 이 값은 경쟁 제외(쿠키가 없는 환경에서의 경쟁 제외 포함)를 구현하는 데 사용됩니다.
사용 예
correlator=4345645667
description_url(설명 URL)
설명
설명 URL 매개변수(description_url)는 페이지에서 재생 중인 동영상을 설명하는 변수 값을 허용합니다.
설명 URL은 웹 앱, 모바일 앱 또는 TV 앱의 특정 페이지에서 재생되는 동영상에 관한 URL이어야 합니다. 모든 동영상 또는 모든 광고 요청의 최상위 도메인이면 안 됩니다. 예를 들어 골프에 관한 동영상을 표시하는 https://www.sample.com/golf.html 페이지가 있는 경우 description_url의 값으로 설정합니다.
사용 예
description_url 값은 동영상이 있는 웹페이지 및 커넥티드 TV/OTT 기기에 대해 URL 인코딩되어야 합니다. 하지만 모바일 앱의 경우 description_url 값을 인코딩해서는 안 됩니다.
URL 인코딩:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
인코딩되지 않음:
description_url=
https://www.sample.com/golf.html
요구사항 및 권장사항
이 매개변수는 웹 및 모바일 앱에서 광고 게재를 구현하는 데 필요합니다. 동적 할당에 Ad Exchange 또는 애드센스를 사용하는 경우에도 필요합니다.
이 매개변수는 프로그래매틱 수익 창출을 위해 사용하는 것이 좋습니다.
SDK 사용
이 매개변수는 IMA SDK에 의해 자동으로 설정되지 않으므로 직접 설정해야 합니다.
플랫폼에 맞는 IMA SDK 가이드를 참고하세요.
env(환경)
설명
환경 매개변수(env)는 인스트림 광고 요청을 나타내거나 요청이 명확히 동영상 플레이어에서 발생한 것임을 나타내는 상수 값을 허용합니다.
가능한 값은 instream(동영상 및 오디오 광고에 사용할 수 있음) 또는 vp(동영상 광고에만 사용할 수 있음)입니다.
사용 예
동영상 및/또는 오디오:
env=instream
동영상만:
env=vp
gdfp_req(스키마 표시기)
설명
Google Ad Manager 스키마 표시기 매개변수(gdfp_req)는 광고 요청이 Google Ad Manager 인벤토리에 대한 것임을 나타내는 상수 값을 허용합니다.
사용 예
gdfp_req=1
iu(광고 단위)
설명
광고 단위 매개변수(iu)는 /network_code/.../ad_unit 형식의 현재 광고 단위로 설정되어야 하는 변수 값을 허용합니다.
사용 예
iu=/6062/videodemo
output(출력)
설명
출력 형식 매개변수(output)는 광고의 출력 형식으로 설정되어야 하는 상수 값을 허용합니다.
사용 예
네트워크의 기본 VAST 버전 사용:
output=vast
VAST 4 사용(특정 태그에 특정 버전 설정 가능):
output=xml_vast4
네트워크의 기본 VMAP 설정 사용:
output=vmap
VMAP 1 사용:
output=xml_vmap1
VMAP 1을 사용하여 VAST 4 반환(VMAP 내에서 VAST를 반환하는 경우):
output=xml_vmap1_vast4
sz(크기)
설명
크기(sz) 매개변수는 마스터 동영상 광고 슬롯의 크기를 전달하는 변수 값을 허용합니다.
크기는 여러 개인 경우 파이프(|) 문자로 구분해야 합니다.
크기 뒤에 'v'를 붙이지 마세요.
사용 예
단일 크기:sz=400x300
여러 크기:sz=300x250|400x300
unviewed_position_start(지연된 노출수)
설명
지연된 노출(unviewed_position_start) 매개변수는 동영상의 지연된 노출을 나타내는 상수 값을 허용합니다.
사용 예
unviewed_position_start=1
url(URL)
설명
URL 매개변수(url)는 요청이 전송되는 전체 URL로 설정되어야 하는 변수 값을 허용합니다. 이 값은 구매자가 이 요청의 출처를 파악하고 이해하는 데 필요합니다. 가능한 한 이 값은 광고 요청에서 동적으로 채워져야 합니다.
- 웹에서는 동영상 플레이어를 표시하는 페이지의 URL이고,
- 웹 이외의 환경에서는 수익을 창출하는 동영상 또는 오디오 인벤토리를 가장 정확하게 나타내는 URL로 설정되어야 합니다. 예를 들어 사용자가 모바일 앱 내에서 동영상을 보고 있는 경우 그 동영상은 데스크톱의 동일한 URL에서도 볼 수 있는 것입니다.*
참고: url은 광고 요청이 이루어진 위치를 나타내는 반면 description_url은 동영상 콘텐츠를 설명하는 웹 크롤링 가능한 페이지라는 점에서 url과 다릅니다.
이 매개변수의 값을 인코딩해야 합니다.
사용 예
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* 앱의 경우 이 매개변수를 변수 URL 값으로 설정할 수 없다면 다음 패턴을 사용하는 것이 좋습니다. url=https%3A%2F%2F<app/bundleid>.example.com
vpmute(동영상 재생 음소거)
설명
동영상 재생 음소거 매개변수(vpmute)는 동영상 플레이어가 음소거되어 있는 동안 광고 재생이 시작되는지를 나타내는 상수 값을 허용합니다. 이 매개변수는 동영상 플레이어의 상태를 변경하지 않으므로 재생 동작은 동영상 플레이어에서 직접 처리해야 합니다.
사용 예
재생이 음소거 상태로 시작됨:
vpmute=1
재생이 음소거 해제 상태로 시작됨:
vpmute=0
프로그래매틱에 필요한 매개변수
ott_placement(OTT 게재위치)
설명
OTT 게재위치 매개변수(ott_placement)는 인스트림이 아닌 OTT 게재위치 요청을 나타내는 상수 값을 허용합니다.
아래 예시에 대한 게재위치 정의는 다음과 같습니다.
- 일시중지: 사용자가 콘텐츠 재생을 일시중지하면 동영상 콘텐츠 위에 오버레이를 통해 표시되는 아웃스트림 형식입니다.
- 홈 화면: 커넥티드 TV 기기 또는 OTT 앱의 홈 화면에 표시되는 광고입니다. 여기에는 홈 화면의 마스트헤드, 배너, 타일 구현이 포함됩니다.
- PIP 모드: 동영상 콘텐츠 옆에 별도의 광고 동영상 플레이어에서 재생되는 인스트림 광고입니다. 일반적으로 동영상 콘텐츠를 다시 압축하고 두 번째 동영상 플레이어를 로드해야 합니다.
- L 배너: 동영상 콘텐츠를 뒤로 밀고 동영상 주위에 광고를 만드는 인스트림 디스플레이 광고입니다. 일반적으로 L자 모양의 광고 콘텐츠 상자를 의미하지만 이에 국한되지 않습니다.
- 오버레이: 동영상 콘텐츠 위에 표시되지만 전체 화면을 차지하지 않는 인스트림 광고 형식입니다. 디스플레이 광고 또는 동영상 광고일 수 있습니다.
사용 예
지원되는 형식 및 이에 상응하는 값은 다음과 같습니다.
일시중지:
ott_placement=1
홈 화면:
ott_placement=2
PIP 모드:
ott_placement=3
L 배너:
ott_placement=4
오버레이:
ott_placement=5
맞춤/기타:
ott_placement=99
plcmt(게재위치)
설명
게재위치 매개변수(plcmt)는 IAB 사양의 안내에 따라 인스트림 인벤토리가 '인스트림' 또는 '함께 표시되는 콘텐츠'로 선언되는지 여부를 나타내는 데 사용되는 상수 값을 허용합니다.
비인스트림 요청의 경우, 선언된 인벤토리 형식에 따라 구매자에 대해 자동으로 채워지며 인스트림 또는 함께 제공되는 선언을 재정의합니다.
사용 예
인스트림 요청:
plcmt=1
함께 표시되는 콘텐츠 요청:
plcmt=2
venuetype(장소 유형)
설명
장소 유형 매개변수(venuetype)는 옥외 광고 장소의 유형을 나타내는 데 사용됩니다. 유효한 값은 IAB OpenOOH 장소 유형 1.1 분류에서 지원하는 정수 열거 ID입니다.
사용 예
호텔 객실:
venuetype=80703
택시 뒷좌석의 태블릿:
venuetype=103
vpa(동영상 자동 재생)
설명
동영상 재생 자동(vpa) 매개변수는 광고의 동영상 콘텐츠가 자동재생을 통해 시작되는지 아니면 클릭을 통해 시작되는지를 나타내는 상수 값을 허용합니다.
가능한 값은 페이지에서 사용자 작업을 기다리는 경우 click이고, 동영상이 자동 재생되는 경우에는 auto입니다. 이 매개변수는 동영상 플레이어의 상태를 변경하지 않으므로 재생 동작은 동영상 플레이어에서 직접 처리해야 합니다.
사용 예
자동재생:
vpa=auto
클릭 재생방식:
vpa=click
알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다.
요구사항 및 권장사항
이 매개변수는 웹, 모바일 앱, 커넥티드 TV, 오디오에서 프로그래매틱 수익 창출을 위해 필요합니다.
이 매개변수는 미디어 평가 위원회(MRC) 동영상 측정 가이드라인에 따라서도 권장됩니다.
프로그래매틱에 권장되는 매개변수
aconp(오디오 연속 재생)
설명
오디오 연속 재생 매개변수(aconp)는 플레이어가 오디오 콘텐츠를 연속적으로 재생할 것인지를 나타내는 상수 값을 허용합니다. 이를 통해 Google Ad Manager는 사용자 환경에 가장 적합한 광고를 선택할 수 있습니다.
사용 예
연속 재생 켜짐:
conp=2
연속 재생 꺼짐:
aconp=1
오디오가 연속으로 재생되는지 모르는 경우 이 매개변수를 설정하지 않은 상태로 두거나 aconp=0으로 설정해야 합니다.
an(앱 이름)
설명
앱 ID 매개변수(msid) 및 앱 이름 매개변수(an)는 대부분의 프로그래매틱 동영상 광고에 대해 필수이므로 모바일 앱 및 커넥티드 TV 기기에서 전송된 요청에 적용되어야 하는 변수 값을 허용합니다.
앱 이름은 인간이 읽을 수 있는 이름이어야 합니다. iOS 및 tvOS에서는 SDK가 앱 ID에 액세스할 수 없습니다. 이러한 경우에는 msid 매개변수가 전송되지 않으며, SDK가 an 매개변수를 통해 App Bundle을 전송합니다.
사용 예
msid=com.package.publisher&an=sample%20app
앱 ID는 앱 스토어별로 이름과 형식이 다릅니다. 앱 식별을 위한 IAB 가이드라인 또는 일반 고유 식별자의 예를 참고하세요.
앱 스토어가 없는 플랫폼의 경우 IAB에서는 스토어 ID에 com.publisher.deviceplatform 형식을 사용하도록 권장합니다.
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 모바일 앱, 커넥티드 TV, 오디오, 디지털 옥외 광고에서 프로그래매틱 수익 창출을 하는 경우 사용하는 것이 좋습니다.
브랜드 안전성을 위해 그리고 구매자에게 더 많은 투명성을 제공하기 위해 앱 정보를 포함하는 것이 좋습니다.
SDK 사용
IMA SDK는 두 매개변수를 자동으로 채우지만, 직접 VAST 호출을 비롯한 비 SDK 환경에서 또는 프로그래매틱 액세스 라이브러리(PAL) 또는 게시자 인증 인벤토리(PAI)를 사용하는 경우에는 두 매개변수를 수동으로 지정해야 합니다.
참고: HTML5 IMA SDK를 사용하는 경우 앱 정보는 사용되지 않습니다.
dth(기기 유형 힌트)
설명
기기 유형 힌트 매개변수(dth)는 특히 커넥티드 TV 및 셋톱 박스 환경에서 기기 오분류를 줄이는 데 도움이 되는 상수 값을 허용합니다.
기기 오분류는 게시자 또는 커넥티드 TV OEM의 의도치 않은 오류로 인해 발생할 수 있습니다. 이 매개변수는 Google에서 커넥티드 TV 인벤토리가 재분류될 수 있는 경우를 자동으로 신고하기 위해 다른 신호와 함께 사용됩니다.
사용 예
요청받은 내역:
- 피처폰:
dth=1 - 스마트폰:
dth=2 - 데스크톱:
dth=3 - 태블릿:
dth=4 - 커넥티드 TV:
dth=5 - 게임 콘솔:
dth=6 - 셋톱 박스:
dth=7
givn(동영상 nonce)
설명
프로그래매틱 액세스 라이브러리(PAL)를 사용하는 통합의 경우 동영상 nonce 매개변수는 변수 문자열 값을 허용합니다.
nonce는 URL에 안전하므로 URL 인코딩할 필요가 없습니다.
참고: 이전에 기존 paln 매개변수를 사용하여 nonce를 제공한 경우 givn 매개변수로 이전하고 paln 전송을 중지하는 것이 좋습니다. 두 매개변수를 모두 포함하지 마세요.
사용 예
이 매개변수로 전달된 값에 대한 자세한 내용은 PAL 시작 가이드를 참고하세요.
hl(언어)
설명
언어 매개변수(hl)는 해당 언어로 광고를 요청하고, Ad Exchange 또는 애드센스 동영상에 대한 동적 할당에서 광고 언어를 선택하고 동영상 광고를 렌더링하는 데 사용되는 상수 값을 허용합니다.
사용 예
이탈리아어로 광고 요청:
hl=it
매개변수 값은 ISO 639-1(영문 기준 2자) 또는 ISO 639-2(영문 기준 3자) 코드일 수 있습니다. 유효한 코드의 목록을 확인하세요.
이 값이 생략되면 기본적으로 Ad Exchange의 언어별 광고 타겟팅에서 사용되는 언어가 사용됩니다.
msid(앱 ID)
설명
앱 ID 매개변수(msid) 및 앱 이름 매개변수(an)는 대부분의 프로그래매틱 동영상 광고에 대해 필수이므로 모바일 앱 및 커넥티드 TV 기기에서 전송된 요청에 적용되어야 하는 변수 값을 허용합니다.
앱 이름은 인간이 읽을 수 있는 이름이어야 합니다. iOS 및 tvOS에서는 SDK가 앱 ID에 액세스할 수 없습니다. 이러한 경우에는 msid 매개변수가 전송되지 않으며, SDK가 an 매개변수를 통해 App Bundle을 전송합니다.
사용 예
msid=com.package.publisher&an=sample%20app
앱 ID는 앱 스토어별로 이름과 형식이 다릅니다. 앱 식별을 위한 IAB 가이드라인 또는 일반 고유 식별자의 예를 참고하세요.
앱 스토어가 없는 플랫폼의 경우 IAB에서는 스토어 ID에 com.publisher.deviceplatform 형식을 사용하도록 권장합니다.
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 모바일 앱, 커넥티드 TV, 오디오, 디지털 옥외 광고에서 프로그래매틱 수익 창출을 하는 경우 사용하는 것이 좋습니다.
브랜드 안전성을 위해 그리고 구매자에게 더 많은 투명성을 제공하기 위해 앱 정보를 포함하는 것이 좋습니다.
SDK 사용
IMA SDK는 두 매개변수를 자동으로 채우지만, 직접 VAST 호출을 비롯한 비 SDK 환경에서 또는 프로그래매틱 액세스 라이브러리(PAL) 또는 게시자 인증 인벤토리(PAI)를 사용하는 경우에는 두 매개변수를 수동으로 지정해야 합니다.
참고: HTML5 IMA SDK를 사용하는 경우 앱 정보는 사용되지 않습니다.
omid_p(OMID 파트너 이름)
설명
OMID 파트너 이름 매개변수(omid_p)는 OMID 측정을 통합하는 파트너의 이름과 파트너 버전을 나타내는 변수 값을 허용합니다.
지원되는 SDK API 매개변수(sdk_apis)는 지원되는 API의 단일 목록 또는 쉼표로 구분된 목록일 수 있는 변수 값을 허용합니다.
이러한 매개변수는 조회 가능성 및 광고 인증에 사용되는 매개변수 집합의 일부입니다.
사용 예
PAL을 사용하지 않는 경우:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
가능한 API 프레임워크 값 목록을 참조하세요.
PAL을 사용하는 경우:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 웹, 모바일 앱, 커넥티드 TV, 오디오, 디지털 옥외 광고에서 프로그래매틱 수익 창출을 위해 사용하는 것이 좋습니다.
SDK 사용
- 이 매개변수는 Open Measurement SDK(OM SDK)를 사용할 때 Active View 측정을 원하는 게시자에게만 적용됩니다.
- 프로그래매틱 액세스 라이브러리(PAL)를 사용할 때 OMID 지원을 나타내려면
omidPartnerName과omidPartnerVersion을 사용하여 파트너 이름과 버전을 설정해야 합니다. PAL 또는 IMA SDK를 사용하지 않는 경우omid_p및sdk_apis매개변수를 설정해야 합니다. - 이는 자동으로 설정되는 IMA SDK를 사용하는 경우 사용해서는 안 됩니다.
rdid(재설정 가능한 기기 식별자)
설명
재설정 가능한 기기 식별자 매개변수(rdid, idtype, is_lat)는 변수 값을 허용합니다. 이 값은 광고용 식별자(IFA)라고도 합니다.
Android 또는 iOS용 IMA SDK를 사용하는 모바일 애플리케이션의 경우 IMA SDK는 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat 매개변수와 함께 스트림 요청으로 전달합니다.
IMA SDK를 사용하지 않거나 서버 측 비콘(SSB)을 사용하는 경우 이를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요.
거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
|
iOS 14.5부터는 Apple이 |
사용 예
재설정 가능 기기 식별자의 자세한 예 보기
sid(세션 ID)
설명
세션 ID(sid) 매개변수는 최대 게재빈도 설정용으로만 사용되는 개인 정보 보호 광고 식별자인 변수 값을 허용합니다.
세션 ID는 커넥티드 TV의 인스트림 광고 요청 및 모바일 앱 기기로부터의 인스트림 광고 요청에 대해 지원됩니다. 현재 웹에서는 지원되지 않습니다.
sid=0을 설정하여 세션 ID 전달을 선택 해제할 수 있습니다.
사용 예
sid=123e4567-e89b-12d3-a456-426614174000
IAB의 IFA 가이드라인에 따라 이 매개변수는 UUID 형식으로 채워져야 합니다. 사용자 타겟팅에 대해 재설정 가능한 기기 식별자에 대해 자세히 알아보세요.
vconp(동영상 연속 재생)
설명
동영상 연속 재생(vconp) 매개변수는 플레이어가 TV 방송처럼 동영상 콘텐츠를 연속적으로 재생할 것인지를 나타내는 상수 값을 허용합니다.
사용 예
연속 재생 켜짐:
vconp=2
연속 재생 꺼짐:
vconp=1
알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다.
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 웹, 모바일 앱, 커넥티드 TV, 오디오에서 프로그래매틱 수익 창출을 위해 사용하는 것이 좋습니다.
이 매개변수는 미디어 평가 위원회(MRC) 동영상 측정 가이드라인에 따라서도 권장됩니다.
vid_d(동영상 길이)
설명
동영상 재생 시간(vid_d) 매개변수는 콘텐츠의 길이(초)를 지정하는 변수 값을 허용합니다.
vid_d및allcues매개변수는 콘텐츠 처리 없이 미드롤 광고를 게재하는 데 사용됩니다.- 미드롤을 반환하려면 광고 규칙을 사용해야 합니다. 시간 기반 큐가 광고 규칙에 사용되는 경우(예: '매 N초마다' 또는 '고정된 시간에') 광고 규칙에 설정된 큐가 사용되고
allcues로 전달된 신호는 무시됩니다. 미드롤에는 여전히 기간이 필요하므로vid_d는 반드시 전달되어야 합니다.
사용 예
90,000초의 동영상 콘텐츠 길이(25시간):
vid_d=90000
vpos(동영상 위치)
설명
동영상 위치(vpos) 매개변수는 광고 요청이 프리롤, 미드롤, 포스트롤 중 어디에서 전송되는지를 나타내는 상수 값을 허용합니다.
사용 예
프리롤:
vpos=preroll
미드롤:
vpos=midroll
포스트롤:
vpos=postroll
wta(이 광고가 표시된 이유)
설명
'이 광고가 표시된 이유' 매개변수(wta)는 동영상 플레이어에서 광고 배지 표시 렌더링을 지원함을 나타내는 상수 값을 허용합니다.
사용 예
플레이어가 VAST 응답에 제공된 AdChoices 아이콘을 렌더링해야 하는 경우 다음을 사용하세요.
wta=1(또는wta매개변수를 생략하거나, 값을 설정하지 않고wta를 전달)VAST 응답에 제공된 AdChoices 아이콘이 컴패니언에서 렌더링되거나 사용자에게 제공되는 경우 오디오 요청에서
wta=1을 사용해야 합니다.
플레이어가 VAST 응답에 제공된 AdChoices 아이콘을 렌더링해서는 안 되는 경우 다음을 사용하세요.
wta=0
요구사항 및 권장사항
이 매개변수는 특정 구현 유형에 광고를 게재하는 데 필요하지는 않지만 웹, 모바일 앱, 커넥티드 TV, 오디오에서 프로그래매틱 수익 창출을 위해 사용하는 것이 좋습니다.
이 매개변수가 사용되는 경우:
&wta=0트래픽은 Google 광고 수요의 특정 유형의 맞춤설정을 사용할 수 없습니다.- EEA의
&wta=0트래픽은 예약 및 게시자 관리 보장 프로그래매틱 광고 항목의 광고 배지 표시가 사용 설정된 광고 소재에 적합하지 않습니다.
광고가 유럽 경제 지역(EEA)에서 게재되는 광고에 적용되는 규제 요건을 준수해야 합니다. 여기에는 사용자가 불법 콘텐츠를 신고할 수 있는 메커니즘이 포함됩니다. 게시자는 불법 콘텐츠 신고가 있을 경우 Google 콘텐츠 신고 양식을 사용하여 Google에 알려야 합니다.
SDK 사용
광고 배지 표시 기능은 IMA SDK를 사용하는 경우 자동으로 지원됩니다. IMA SDK를 사용하지 않는 경우에는 IAB VAST 표준에 설명된 대로 동영상 플레이어가 VASTIcon 및 IconClickFallbackImage 지원을 구현해야 합니다.기타 매개변수
일반적으로 이러한 매개변수는 광고를 게재하는 데 명시적으로 필요하지는 않지만 특정 기능을 사용하거나 특정 구현 유형에 필요할 수 있습니다.
ad_rule(광고 규칙)
설명
광고 규칙 매개변수(ad_rule)는 VAST 광고 소재를 반환하는지, 아니면 광고 규칙 응답을 반환하는지를 나타내는 상수 값을 허용합니다.
광고 규칙의 기본 설정은 모든 요청을 광고 규칙 요청으로 설정하는 Google Ad Manager 네트워크 설정에 따라 다릅니다. 네트워크 설정을 사용하는 경우 광고 태그에 ad_rule을 설정할 필요가 없습니다. 광고 요청별로 사용 중지하려면 ad_rule=0을 전달하여 네트워크 설정을 재정의할 수 있습니다. 또한 기본적으로 광고 규칙이 사용 설정되어 있지 않은 경우 ad_rule=1 및 ad_rule=0을 각각 전달하여 사용 설정/사용 중지할 수 있습니다.
사용 예
광고 규칙 설정이 사용 중지된 경우:
- VAST 광고 소재 요청:
ad_rule=0또는 설정하지 않음
광고 규칙 설정이 사용 설정된 경우:
- VAST 광고 소재 요청:
ad_rule=0 - 광고 규칙(VMAP) 요청:
ad_rule=1또는 설정하지 않음
광고 규칙을 활용하지 않으려는 경우 광고 태그 매개변수를 사용하여 pmnd, pmxd, pmad를 통해 VAST 태그의 광고 시점 및 광고 모음 재생 시간을 표시할 수 있습니다.
요구사항 및 권장사항
이 매개변수는 특정 구현 유형에 광고를 게재하는 데 필요하지는 않지만 동영상 광고 규칙을 올바르게 사용하려면 필요합니다.
addtl_consent(추가 동의)
설명
추가 동의 매개변수(addtl_consent)는 변수 값을 허용하며, IAB TCF v2.0과 통합하고 아직 IAB 유럽 글로벌 공급업체 목록에는 등록되지 않았지만 Google의 광고 기술 제공업체(ATP) 목록에 있는 제공업체를 이용하려는 게시자가 사용합니다.
이 매개변수로 전달된 값에 대한 자세한 내용은 추가 동의 모드 기술 사양을 참조하세요.
사용 예
addtl_consent=1~1.35.41.101
adtest(광고 테스트)
설명
광고 테스트 매개변수(adtest)는 예비 광고(보장되지 않음) 인벤토리를 테스트하는 데 사용되는 쿼리가 무효 트래픽으로 식별되지 않고 수익에 영향을 미치지 않도록 하는 데 사용해야 합니다.
예비 광고를 테스트할 때는 이 매개변수를 on으로 설정하여 테스트 중에 어떤 광고도 노출수나 클릭수를 기록하지 않도록 합니다. 정상적인 청구를 위해 테스트가 아닌 환경에서는 off로 설정하세요. 이 매개변수를 설정하지 않으면 기본값은 off입니다.
참고: 직접 판매 광고 항목을 테스트할 때는 수익에 영향을 미치지 않는 테스트 광고 항목을 대신 사용해야 합니다.
사용 예
사용 설정:
adtest=on
사용 중지:
adtest=off
ad_type(광고 유형)
설명
광고 유형 매개변수(ad_type)는 요청에 대해 반환되어야 하는 광고 유형을 나타내는 상수 값을 허용합니다.
ad_type이 audio 또는 audio_video로 설정되면 vpmute 매개변수는 0으로 설정되어야 합니다.
사용 예
오디오 광고만 허용:
ad_type=audio
건너뛸 수 있는 동영상 광고와 건너뛸 수 없는 동영상 광고를 모두 허용:
ad_type=video
오디오 광고와 동영상 광고를 모두 허용:
ad_type=audio_video
이
audio_video값을 사용하면 두 형식이 경쟁하지만 하나만 게재됩니다. 동영상 광고 소재를 동영상 광고 재생을 지원하는 오디오 콘텐츠에 게재하거나 본질적으로 '들을 수 있는' 콘텐츠(예: 스포츠 스트림, 동영상캐스트, 뉴스 등)를 지원하는 인스트림 동영상 플레이어에 오디오 광고 소재를 게재하는 데만 사용하도록 만들어졌습니다. 동영상 콘텐츠 내 오디오에 관해 자세히 알아보세요.
건너뛸 수 있는 동영상 광고만 허용:
ad_type=skippablevideo
건너뛸 수 없는 동영상 광고만 허용:
ad_type=standardvideo
요구사항 및 권장사항
- 앱에 동영상 콘텐츠가 있는 경우 이 매개변수를
video,audio_video로 설정하거나 설정하지 않은 상태로 둡니다. - 앱에 오디오 콘텐츠만 있는 경우(예: 라디오 또는 음성 앱) 이 매개변수를
audio로 설정해야 합니다. 이 값을 설정하지 않은 상태로 두면 오디오 광고가 반환되지 않습니다.
afvsz(비선형 광고 크기)
설명
비선형 광고 크기 매개변수(afvsz)는 동영상 광고 슬롯에 표시될 수 있는 쉼표로 구분된 비선형 광고 크기 목록이어야 하는 상수 값을 허용합니다.
지원되는 크기는 다음과 같습니다.
200x200250x250300x250336x280450x50468x60480x90729x90
IMA SDK를 사용하면 이 입력란은 덮어쓰기되며 nonLinearAdSlotWidth 및 nonLinearAdSlotHeight에 해당하는 모든 지원되는 크기로 채워집니다.
지원되는 비선형 크기가 없으면 매개변수를 생략하거나 비워둘 수 있습니다.
사용 예
모든 크기가 지원되는 경우:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
최대 너비가 250인 경우:
afvsz=200x200,250x250
최대 높이가 60인 경우:
afvsz=450x50,468x60
최대 너비가 100인 경우:
//empty; no values supported
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데는 필요하지 않지만 IMA SDK를 사용하지 않는 경우 비선형 동영상 광고를 게재하는 데 필요합니다.
allcues(모든 신호)
설명
모든 신호 매개변수(allcues)는 쉼표로 구분된 큐 포인트 목록(밀리초)인 변수 값을 허용합니다. 각 값에 대해 Google Ad Manager는 광고 시점을 반환합니다.
vid_d및allcues매개변수는 콘텐츠 처리 없이 미드롤 광고를 게재하는 데 사용됩니다.- 미드롤을 반환하려면 광고 규칙도 필요합니다. 시간 기반 큐가 광고 규칙에 사용되는 경우(예: '매 N초마다' 또는 '고정된 시간에') 광고 규칙에 설정된 큐가 사용되고
allcues로 전달된 신호는 무시됩니다. 미드롤에는 여전히 기간이 필요하므로vid_d는 반드시 전달되어야 합니다.
사용 예
10초 및 20초의 큐 포인트:
allcues=10000,20000
ciu_szs(컴패니언 크기)
설명
컴패니언 크기 매개변수(ciu_szs)는 쉼표로 구분된 컴패니언 크기 목록인 변수 값을 허용합니다.
파이프(|)로 구분된 값은 여러 크기의 광고 슬롯을 나타냅니다.
사용 예
ciu_szs=728x90,300x250
여러 크기의 슬롯이 있는 크기:
ciu_szs=728x90,300x200|300x250
cmsid(콘텐츠 소스 ID)
설명
콘텐츠 소스 ID 매개변수(cmsid) 및 동영상 ID 매개변수(vid)는 변수 값을 허용합니다.
동영상 콘텐츠에 광고를 타겟팅하려면 마스터 동영상 태그에 이 두 매개변수를 모두 포함해야 합니다.
cmsid는 각 콘텐츠 소스의 고유 번호입니다. Google Ad Manager에서 이 ID를 찾으려면 동영상, 콘텐츠 소스, 소스의 이름을 차례로 클릭합니다.vid는 특정 동영상을 식별하는 문자열 또는 숫자입니다. 이 ID는 콘텐츠를 호스팅하는 CMS에 의해 지정됩니다. Google Ad Manager에서 이 ID를 찾으려면 동영상, 콘텐츠, 특정 동영상 콘텐츠를 차례로 클릭합니다.
사용 예
cmsid=[value]&vid=[value]
동적 광고 삽입을 사용하여 VOD용 태그를 만드는 경우 올바른 콘텐츠 소스 및 동영상 ID를 동적으로 삽입할 매크로를 사용해야 합니다.
예: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
요구사항 및 권장사항
이러한 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지 않지만 동영상 콘텐츠 타겟팅을 사용하려면 필요합니다.
cust_params(맞춤 매개변수)
설명
맞춤 매개변수 매개변수(cust_params)는 특정 타겟팅(인구통계, 페이지상의 특정 위치, 하나 이상의 특정 페이지)을 설정할 수 있게 해주는 키-값 쌍인 변수 값을 허용합니다.
사용 예
키-값 쌍을 추가하는 방법의 예를 확인하세요.
excl_cat(제외 카테고리)
설명
제외 카테고리 매개변수(excl_cat)는 변수 값을 허용하며 광고 요청에 제외 라벨이 포함된 광고 항목을 차단하는 데 사용됩니다. cust_params 매개변수를 사용하여 제외 카테고리와 제외 라벨을 설정합니다.
사용 예
두 개의 제외 라벨(airline_excl_label 및 train_excl_label)의 제외 카테고리를 설정하려면 파이프 문자(|)를 사용하여 라벨을 구분합니다.
excl_cat=airline_excl_label%7Ctrain_excl_label
그런 다음 URL 인코딩을 적용하고 인코딩된 문자열을 cust_params에 사용합니다.
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr(GDPR)
설명
GDPR 매개변수(gdpr)는 상수 값을 허용하며, IAB TCF v2.0과 통합하려는 게시자가 사용합니다. 직접적인 VAST 요청은 값을 자동으로 읽지 않지만 광고 태그에 추가되면 수락됩니다.
이 매개변수의 유효한 값은 0과 1뿐이며, 0은 GDPR이 적용되지 않는다는 의미이며 1은 GDPR이 적용된다는 의미입니다. GDPR이 적용되는 경우 gdpr_consent 매개변수를 사용하여 유효한 TC 문자열도 제공해야 합니다.
이 매개변수로 전달된 값에 대한 자세한 내용은 프레임워크 구현을 위한 일반 지침 또는 IAB TCF v2.0 사양의 TC 문자열 섹션에서 확인할 수 있습니다.
사용 예
GDPR 적용:
gdpr=1
GDPR 미적용:
gdpr=0
gdpr_consent(GDPR 동의)
설명
GDPR 동의 매개변수(gdpr_consent)는 변수 값을 허용하며, IAB TCF v2.0과 통합하려는 게시자가 사용합니다. 직접적인 VAST 요청은 값을 자동으로 읽지 않지만 광고 태그에 추가되면 수락됩니다.
이 매개변수로 전달된 값에 대한 자세한 내용은 프레임워크 구현을 위한 일반 지침 또는 IAB TCF v2.0 사양의 TC 문자열 섹션에서 확인할 수 있습니다.
사용 예
gdpr_consent=GDPR_CONSENT_123
iabexcl(IAB 제외 URL)
설명
IAB 제외 URL 매개변수(iabexcl)는 쉼표로 구분된 카테고리 목록인 변수 값을 허용합니다.
idtype(기기 유형)
설명
재설정 가능한 기기 식별자 매개변수(rdid, idtype, is_lat)는 변수 값을 허용합니다. 이 값은 광고용 식별자(IFA)라고도 합니다.
Android 또는 iOS용 IMA SDK를 사용하는 모바일 애플리케이션의 경우 IMA SDK는 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat 매개변수와 함께 스트림 요청으로 전달합니다.
IMA SDK를 사용하지 않거나 서버 측 비콘(SSB)을 사용하는 경우 이를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요.
거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
|
iOS 14.5부터는 Apple이 |
사용 예
재설정 가능 기기 식별자의 자세한 예 보기
ipd(인벤토리 파트너 도메인)
설명
인벤토리 파트너 도메인 매개변수(ipd)는 게시자의 app-ads.txt(또는 ads.txt) 파일에 있는 inventorypartnerdomain 선언으로 설정되어야 하는 변수 값을 허용합니다.
inventorypartnerdomain 매개변수는 게시자가 ads.txt/app-ads.txt 유효성 검사를 위해 인벤토리 공유 파트너의 도메인을 지정하는 데 도움이 되는 IAB 사양입니다.
IPD 선언은 요청이 발생한 광고 인벤토리를 다른 파트너(인벤토리 공유 파트너)가 소유할 수 있는 인벤토리 공유 사용 사례에서 특히 중요합니다.
ads.txt/app-ads.txt 및 인벤토리 공유 파트너에 대해 자세히 알아보세요.
사용 예
inventorypartnerdomain은 인벤토리에서 수익을 창출할 수 있는 파트너의 .txt 파일을 가리키는 app-ads.txt 파일에 있습니다. ipd 매개변수의 값은 inventorypartnerdomain 항목 중 하나 아래의 app-ads.txt 파일의 값과 일치해야 합니다.요구사항 및 권장사항
이 매개변수는 소유하지 않은 인벤토리에서 수익을 창출하는 게시자에게 필요합니다.
ipe(노출을 핑하는 개체)
설명
노출을 핑하는 개체 매개변수(ipe)는 클라이언트가 아닌 서버에서 발생하는 노출 핑 및 전환을 나타내는 상수 값을 허용합니다.
노출 핑 항목은 서버에서 노출 핑/비콘을 전송할 때 사용됩니다.
사용 예
서버 측 비코닝(SSB):
ipe=ssb
is_lat(광고 추적 제한)
설명
재설정 가능한 기기 식별자 매개변수(rdid, idtype, is_lat)는 변수 값을 허용합니다. 이 값은 광고용 식별자(IFA)라고도 합니다.
Android 또는 iOS용 IMA SDK를 사용하는 모바일 애플리케이션의 경우 IMA SDK는 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat 매개변수와 함께 스트림 요청으로 전달합니다.
IMA SDK를 사용하지 않거나 서버 측 비콘(SSB)을 사용하는 경우 이를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요.
거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
|
iOS 14.5부터는 Apple이 |
사용 예
재설정 가능 기기 식별자의 자세한 예 보기
lip(광고 모음 내 마지막 위치)
설명
광고 모음 내 마지막 위치 매개변수(lip)는 상수 값을 허용하여 타겟팅 또는 보고를 위해 광고 모음 내 마지막 위치에서 보낸 요청을 나타냅니다.
참고: 이 매개변수는 최적화된 광고 모음에는 적용되지 않으며 사용되는 경우 무시됩니다.
사용 예
lip=1
ltd(제한적인 광고)
설명
제한적인 광고 매개변수(ltd)는 쿠키 또는 기타 로컬 식별자 사용에 대한 동의 없이 제한된 방식으로 광고를 게재하는지를 나타내는 상수 값을 허용합니다.
이 매개변수는 제한적인 광고 요청을 나타내는 데 사용되며 is_lat 매개변수와 다릅니다. 맞춤설정 및 이러한 목적으로의 식별자 사용을 사용 중지합니다.
ltd=1을 설정하면 IMA SDK의 동작이 변경되어 요청을 ID가 없는 것으로 취급하고 스토리지가 허용되지 않습니다.사용 예
ltd=1
max_ad_duration(최대 광고 재생 시간)
설명
최소 광고 재생 시간 매개변수(min_ad_duration) 및 최대 광고 재생 시간 매개변수(max_ad_duration)는 변수 값을 허용하며, 함께 사용하면 광고가 일치해야 하는 재생 시간 범위를 밀리초 단위로 지정할 수 있습니다.
이 매개변수는 단일 광고 또는 최적화된 광고 모음 요청의 광고 태그에 필요한 길이로 광고 소재를 제한하는 데 사용할 수 있습니다.
사용 예
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration(최소 광고 길이)
설명
최소 광고 재생 시간 매개변수(min_ad_duration) 및 최대 광고 재생 시간 매개변수(max_ad_duration)는 변수 값을 허용하며, 함께 사용하면 광고가 일치해야 하는 재생 시간 범위를 밀리초 단위로 지정할 수 있습니다.
이 매개변수는 단일 광고 또는 최적화된 광고 모음 요청의 광고 태그에 필요한 길이로 광고 소재를 제한하는 데 사용할 수 있습니다.
사용 예
min_ad_duration=15000&max_ad_duration=30000
mridx(미드롤 번호)
설명
미드롤 번호 매개변수(mridx)는 미드롤의 서수를 나타내는 변수 값을 허용합니다(예: 미드롤 1, 미드롤 2).
사용 예
mridx=2
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만 특정 미드롤을 타겟팅하고, 미드롤에 대해 보고하고, 미드롤에 대해 예측하는 데는 필요합니다.
nofb(대체 없음)
설명
대체 광고 없음 매개변수(nofb)는 광고 요청이 동영상 대체 광고의 재생목록을 반환해서는 안 된다는 것을 나타내는 상수 값을 허용합니다.
사용 예
대체 광고 비활성화됨:
nofb=1
nofb=1을 전달하여 광고 요청별로 단일 광고 대체 및 최적화된 광고 모음 광고 뷔페를 사용 중지할 수 있습니다.
npa(개인 맞춤이 아닌 광고)
설명
개인 맞춤이 아닌 광고 매개변수(npa)는 광고 요청이 개인 맞춤이 아닌 것으로 취급되어야 함을 나타내는 상수 값을 허용합니다.
명확히 npa=1로 설정하거나 단순히 npa를 포함해야(설정된 값 없이) 요청을 개인 맞춤이 아닌 요청으로 태그 지정할 수 있습니다. 이 매개변수가 없거나 nap=0으로 설정된 광고 요청은 기본적으로 개인 맞춤 광고로 설정됩니다.
사용 예
개인 맞춤이 아닌 광고:
npa=1
요구사항 및 권장사항
이 매개변수는 사용자가 맞춤설정을 사용 중지한 경우에만 필요합니다. 게시자는 상태를 제어할 때 사용자의 정확한 상태를 나타내야 합니다.
ott_placement(맞춤 형식)
설명
OTT 게재위치 매개변수(ott_placement)는 인스트림이 아닌 OTT 게재위치 요청을 나타내는 상수 값을 허용합니다.
아래 예시에 대한 게재위치 정의는 다음과 같습니다.
- 일시중지: 사용자가 콘텐츠 재생을 일시중지하면 동영상 콘텐츠 위에 오버레이를 통해 표시되는 아웃스트림 형식입니다.
- 홈 화면: 커넥티드 TV 기기 또는 OTT 앱의 홈 화면에 표시되는 광고입니다. 여기에는 홈 화면의 마스트헤드, 배너, 타일 구현이 포함됩니다.
- PIP 모드: 동영상 콘텐츠 옆에 별도의 광고 동영상 플레이어에서 재생되는 인스트림 광고입니다. 일반적으로 동영상 콘텐츠를 다시 압축하고 두 번째 동영상 플레이어를 로드해야 합니다.
- L 배너: 동영상 콘텐츠를 뒤로 밀고 동영상 주위에 광고를 만드는 인스트림 디스플레이 광고입니다. 일반적으로 L자 모양의 광고 콘텐츠 상자를 의미하지만 이에 국한되지 않습니다.
- 오버레이: 동영상 콘텐츠 위에 표시되지만 전체 화면을 차지하지 않는 인스트림 광고 형식입니다. 디스플레이 광고 또는 동영상 광고일 수 있습니다.
사용 예
지원되는 형식 및 이에 상응하는 값은 다음과 같습니다.
일시중지:
ott_placement=1
홈 화면:
ott_placement=2
PIP 모드:
ott_placement=3
L 배너:
ott_placement=4
오버레이:
ott_placement=5
맞춤/기타:
ott_placement=99
paln(프로그래매틱 액세스 라이브러리 nonce – 기존)
설명
프로그래매틱 액세스 라이브러리(PAL)를 사용하는 통합의 경우 동영상 nonce 매개변수는 변수 문자열 값을 허용합니다.
nonce는 URL에 안전하므로 URL 인코딩할 필요가 없습니다.
참고: 이전에 기존 paln 매개변수를 사용하여 nonce를 제공한 경우 givn 매개변수로 이전하고 paln 전송을 중지하는 것이 좋습니다. 두 매개변수를 모두 포함하지 마세요.
사용 예
이 매개변수로 전달된 값에 대한 자세한 내용은 PAL 시작 가이드를 참고하세요.
pmad(광고 모음 최대 광고 수)
설명
광고 모음 최대 광고 수 매개변수(pmad)는 광고 모음 내 최대 광고 수를 나타내는 변수 값을 허용합니다.
이 매개변수는 최적화된 광고 모음의 총 광고 수를 제한합니다. 이 기능은 고급 동영상 패키지를 사용하는 게시자에게 제공됩니다.
VMAP에는 이 매개변수를 사용할 수 없습니다(ad_rule=1인 경우).
사용 예
pmad=4
pmnd(광고 모음 최소 재생 시간)
설명
광고 모음 최소 재생 시간 매개변수(pmnd)와 광고 모음 최대 재생 시간 매개변수(pmxd)는 변수 값을 허용하며, 함께 사용하면 광고 모음이 일치해야 하는 재생 시간 범위를 밀리초 단위로 지정할 수 있습니다.
이 매개변수는 최적화된 광고 모음에서 여러 광고를 요청하는 데 사용됩니다. 이 기능은 고급 동영상 패키지를 사용하는 게시자에게 제공됩니다. 광고 규칙을 사용하면 Google Ad Manager에서 이 정보를 자동으로 추가합니다.
VMAP에는 이 매개변수를 사용할 수 없습니다(ad_rule=1인 경우).
사용 예
pmnd=0&pmxd=60000
pmxd(광고 모음 최대 재생 시간)
설명
광고 모음 최소 재생 시간 매개변수(pmnd)와 광고 모음 최대 재생 시간 매개변수(pmxd)는 변수 값을 허용하며, 함께 사용하면 광고 모음이 일치해야 하는 재생 시간 범위를 밀리초 단위로 지정할 수 있습니다.
이 매개변수는 최적화된 광고 모음에서 여러 광고를 요청하는 데 사용됩니다. 이 기능은 고급 동영상 패키지를 사용하는 게시자에게 제공됩니다. 광고 규칙을 사용하면 Google Ad Manager에서 이 정보를 자동으로 추가합니다.
VMAP에는 이 매개변수를 사용할 수 없습니다(ad_rule=1인 경우).
사용 예
pmnd=0&pmxd=60000
pmxfwt(광고 모음 최대 강제 시청 시간)
설명
광고 모음 최대 강제 시청 시간 매개변수(pmxfwt)는 광고 모음의 건너뛸 수 없는 최대 재생 시간(밀리초)을 지정하는 변수 값을 허용합니다.
건너뛸 수 없는 동영상 광고와 건너뛸 수 있는 동영상 광고가 혼합된 광고 모음을 지원하고 사용자의 광고 시간을 제한하려면 이 매개변수를 사용하여 사용자가 시청해야 하는 건너뛸 수 없는 광고의 최대 시간을 정의하세요.
참고: 최대 광고 모음 재생 시간 매개변수(pmxd)는 광고 모음의 최대 총 재생 시간(건너뛸 수 있는 광고의 전체 재생 시간 포함)을 정의할 때 이 매개변수를 대체합니다.
사용 예
pmxfwt=30000
pod(광고 모음 번호)
설명
광고 모음 번호 매개변수(pod)는 동영상에서 광고 모음의 서수를 나타내는 변수 값을 허용합니다(예: 광고 모음 1, 광고 모음 2).
사용 예
pod=3
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만, 동일한 광고가 여러 광고 모음에 게재되도록 허용하고 경쟁 제외, 최대 게재빈도 설정, 관련 기능을 올바르게 사용하려면 필요합니다.
pp(광고 소재 프로필)
설명
광고 소재 프로필 매개변수(pp)는 동영상 및 오디오 광고 소재 프로필에 설정된 구성에 따라 게재할 수 있는 광고 소재를 제어하는 변수 값을 허용합니다.
사용 예
pp=creative_profile
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 동영상 및 오디오 광고 소재 프로필이 있는 Google Ad Manager 호스팅 광고 소재의 미디어 파일을 제한하는 데는 필요합니다. 리디렉션 또는 프로그래매틱 광고의 경우 요구사항을 사용할 수 있도록 하는 데 사용되지만 미디어 파일을 광고 소재 프로필에서 선택한 파일로 제한하지는 않습니다.
ppt(게시자 개인 정보 보호 처리)
설명
게시자 개인 정보 보호 처리 매개변수(ppt)는 광고 요청에 대한 광고 개인 최적화를 사용 중지할지 여부를 나타내는 데 사용되는 상수 값을 허용합니다.
이 매개변수를 사용하면 npa=1 및 rdp=1과 다를 수 있는 개인 맞춤이 아닌 광고를 적용할 수 있습니다. 예약과 프로그래매틱 수요에 모두 영향을 미칩니다.
게시자 개인 정보 보호 처리에 대해 자세히 알아보세요.
사용 예
광고 개인 최적화 사용 중지:
ppt=1
ppid(게시자 제공 식별자)
설명
게시자 제공 식별자(PPID) 매개변수는 최대 게재빈도 설정, 잠재고객 분류 및 타겟팅, 순차적 광고 순환게재 등 복수 기기에 대한 잠재고객 기반 광고의 게재를 관리하는 데 사용되는 식별자의 변수 값을 허용합니다.
게시자 제공 식별자에 대해 자세히 알아보세요.
사용 예
ppid=12JD92JD8078S8J29SDOAKC0EF230337
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만 일관된 플랫폼 독립형 식별자를 사용해야 합니다. 다른 식별자가 없고 구매자에게 제공할 수 있는 경우에 사용할 수 있습니다.
ppos(광고 모음 내 위치)
설명
광고 모음 내 위치(ppos) 매개변수는 광고 모음 내의 위치를 나타내는 변수 값을 허용합니다(예: 위치 1, 위치 2).
이 매개변수는 표준 광고 모음 전용이며, 컴패니언 자동 완성에 필요합니다. 광고 규칙을 사용하면 Google Ad Manager에서 이 정보를 자동으로 추가합니다.
사용 예
ppos=2
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만, 게재위치 타겟팅이 필요한 경우 표준 광고 모음과 표준 광고 모음의 예측 및 보고에 필요합니다. 경쟁 제외, 최대 게재빈도 설정, 관련 기능을 올바르게 사용해야 합니다.
ppsj(게시자 제공 신호 JSON)
설명
게시자 제공 신호 JSON 매개변수(ppsj)는 프로그래매틱 수익 창출을 개선하기 위해 게시자가 제공한 잠재고객 및 문맥 데이터가 포함된 base64로 인코딩된 JSON 객체인 변수 값을 허용합니다.
이 매개변수는 구매자/입찰자에게 특정 신호를 전송하는 데 사용할 수 있습니다.
게시자 제공 신호 및 지원되는 분류에 대해 자세히 알아보세요.
사용 예
JSON 객체:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Base64 인코딩 값 적용:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
유효한 JSON 키-값 쌍에 관한 자세한 내용은
HTML5 IMA SDK 샘플을 참고하세요.
ptpl(광고 시간 템플릿 ID)
설명
광고 시간 템플릿 ID 매개변수(ptpl) 및 이름 매개변수(ptpln)는 최적화된 광고 모음 요청에 적용할 광고 시간 템플릿을 나타내는 데 사용되는 변수 값을 허용합니다.
광고 시간 템플릿을 사용하면 어떤 광고 스팟이나 맞춤 광고 스팟을 광고 시간에 포함하고 어떤 순서로 게재할지 구성할 수 있습니다.
광고 시간 템플릿을 요청하려면 이 매개변수 중 하나만 있으면 됩니다.
사용 예
광고 시간 템플릿을 설정하고 요청하는 방법을 자세히 알아보세요.
요구사항 및 권장사항
이 매개변수는 광고 시간 템플릿을 직접 요청하는 경우에만 필요합니다.
ptpln(광고 시간 템플릿 이름)
설명
광고 시간 템플릿 ID 매개변수(ptpl) 및 이름 매개변수(ptpln)는 최적화된 광고 모음 요청에 적용할 광고 시간 템플릿을 나타내는 데 사용되는 변수 값을 허용합니다.
광고 시간 템플릿을 사용하면 어떤 광고 스팟이나 맞춤 광고 스팟을 광고 시간에 포함하고 어떤 순서로 게재할지 구성할 수 있습니다.
광고 시간 템플릿을 요청하려면 이 매개변수 중 하나만 있으면 됩니다.
사용 예
광고 시간 템플릿을 설정하고 요청하는 방법을 자세히 알아보세요.
요구사항 및 권장사항
이 매개변수는 광고 시간 템플릿을 직접 요청하는 경우에만 필요합니다.
pubf(Ad Exchange 태그의 공개 최저 가격)
설명
Ad Exchange 매개변수의 공개 하한선(pubf) 및 Ad Exchange 매개변수의 비공개 하한선(pvtf)은 Ad Exchange 태그에 가격 하한선을 추가하는 데 사용되는 변수 값을 허용합니다.
이 매개변수는 google_ad_public_floor 및 google_ad_private_floor와 같습니다.
사용 예
공개 하한선:
pubf=123
비공개 하한선:
pvtf=123
pvid(앱 세트 ID)
설명
앱 세트 ID 매개변수(pvid)는 Android 앱 세트 ID로 설정된 변수 값을 허용하고, 앱 세트 범위 매개변수(pvid_s)는 앱 세트 ID의 범위를 나타내는 상수 값(scope_app 또는 scope_developer 중 하나)을 허용합니다.
앱 세트 ID를 검색하는 방법은 Android 문서를 참조하세요.
사용 예
pvid=[AppSetID_value]
pvid_s=scope_app
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 Android 기기의 모바일 앱에서 프로그래매틱 수익 창출을 하는 경우 사용하는 것이 좋습니다.
SDK 사용
IMA/PAL SDK는 이 필드를 자동으로 전달하지만 비 SDK 구현을 사용하는 게시자는 앱 세트 SDK를 호출하고 광고 요청에서 이러한 매개변수를 수동으로 전달해야 합니다.
pvid_s(앱 세트 범위)
설명
앱 세트 ID 매개변수(pvid)는 Android 앱 세트 ID로 설정된 변수 값을 허용하고, 앱 세트 범위 매개변수(pvid_s)는 앱 세트 ID의 범위를 나타내는 상수 값(scope_app 또는 scope_developer 중 하나)을 허용합니다.
앱 세트 ID를 검색하는 방법은 Android 문서를 참조하세요.
사용 예
pvid=[AppSetID_value]
pvid_s=scope_app
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 Android 기기의 모바일 앱에서 프로그래매틱 수익 창출을 하는 경우 사용하는 것이 좋습니다.
SDK 사용
IMA/PAL SDK는 이 필드를 자동으로 전달하지만 비 SDK 구현을 사용하는 게시자는 앱 세트 SDK를 호출하고 광고 요청에서 이러한 매개변수를 수동으로 전달해야 합니다.
pvtf(Ad Exchange 태그의 비공개 최저 가격)
설명
Ad Exchange 매개변수의 공개 하한선(pubf) 및 Ad Exchange 매개변수의 비공개 하한선(pvtf)은 Ad Exchange 태그에 가격 하한선을 추가하는 데 사용되는 변수 값을 허용합니다.
이 매개변수는 google_ad_public_floor 및 google_ad_private_floor와 같습니다.
사용 예
공개 하한선:
pubf=123
비공개 하한선:
pvtf=123
rdp(제한적인 데이터 처리)
설명
데이터 처리 제한 매개변수(rdp)는 광고 요청이 데이터 처리를 제한해야 함을 나타내는 상수 값을 허용합니다.
데이터 처리 제한 네트워크 설정을 사용 설정하여 네트워크 수준에서 데이터 처리를 제한할 수 있습니다.
사용 예
데이터 처리 제한:
rdp=1 또는 rdp(설정된 값 없이)
데이터 처리를 제한하지 않음:
rdp=0
schain(공급망)
설명
공급망(schain) 매개변수는 직렬화된 SupplyChain 객체여야 하는 변수 값을 허용합니다. 이 매개변수가 포함되면 Google은 구매자에게 전송하기 전에 수신된 모든 schain 객체에 노드를 추가합니다.
OpenRTB가 아닌 태그를 통해 SupplyChain 정보를 전달하는 방법은 전체 IAB 문서를 참고하세요.
올바른schain 파싱을 위한 요구사항 보기
IAB 문서에 따라 다음은 SupplyChain 객체의 직렬화를 정의합니다.
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject및SupplyChainNode속성은 쉼표로 구분되므로 옵션 필드는 생략할 수 있고 쉼표 구분자는 선택적으로 제외할 수 있습니다.- 각
SupplyChainNode요소는 '!'로 구분됩니다. - 속성 값에 URL 인코딩이 필요한 문자(예: '
,' 또는 '!')가 포함된 경우 직렬화하기 전에 값을 URL로 인코딩해야 합니다.
직렬화 순서
SupplyChainObject 속성은 다음 순서로 직렬화됩니다.
ver,complete
SupplyChainNode 속성은 다음 순서로 직렬화됩니다.
asi,sid,hp,rid,name,domain,ext
ext의 콘텐츠는 광고 거래소마다 다릅니다. Google Ad Manager는 이 속성을 파싱하지 않습니다.SupplyChain 객체를 직렬화하는 방법의 예
다음은 위의 SupplyChain 객체를 직렬화하는 두 가지 방법의 예입니다.
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
사용 예
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
asi의 값이 exchange,1이면 이스케이프된 문자를 사용한 직렬화는 다음과 같습니다.
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만 Google Ad Manager 요청의 업스트림에서 결제 중개자를 활용하는 게시자에게는 필요합니다. 여기에는 서드 파티 광고 서버 기술을 사용하는 게시자도 포함됩니다.
scor(스트림 상관자)
설명
스트림 상관자(scor) 매개변수는 각 동영상 스트림별로 생성되는 정수를 전달하는 변수 값을 허용합니다.
score 및 correlator 매개변수의 정수 값은 동일할 필요가 없습니다. 그러나 순 시청 세션을 식별하려면 각 동영상 스트림 재생 중에 각 값을 유지해야 합니다.
사용 예
scor=17
sdk_apis(SDK API 프레임워크)
설명
SDK API 프레임워크(sdk_apis) 매개변수는 플레이어가 지원하는 모든 API 프레임워크를 나타내는 쉼표로 구분된 상수 정수 값의 목록을 허용합니다.
요구사항 및 권장사항
SDK 사용
이 매개변수는 프로그래매틱 액세스 라이브러리(PAL)를 사용하는 게시자가 사용합니다. IMA SDK를 사용하는 동안 이 매개변수에 값을 설정하려고 하면 값이 IMA SDK에서 지원하는 값으로 재정의됩니다.
sdmax(건너뛸 수 있는 최대 광고 재생 시간)
설명
건너뛸 수 있는 최대 광고 재생 시간(sdmax) 매개변수는 게시자가 건너뛸 수 있는 광고에 원하는 최대 광고 재생 시간을 지정할 수 있는 변수 값을 허용합니다.
특정 광고 요청에서 건너뛸 수 있는 동영상/오디오 광고 소재의 재생 시간에 허용되는 상한값을 밀리초 단위로 표시합니다.
건너뛸 수 있는 광고에 대해 개별적으로 또는 기존 max_ad_duration 매개변수와 함께 sdmax를 사용하여 건너뛸 수 있는 광고와 건너뛸 수 없는 광고의 최대 길이를 다르게 제공합니다.
사용 예
다음 설정을 사용합니다.
max_ad_duration= 15000(15초)sdmax= 45000(45초)
다음 광고 소재의 경우:
- 광고 소재 A: 건너뛸 수 없음, 30초
- 광고 소재 B: 건너뛸 수 있음, 30초
결과:
- 광고 소재 A는 건너뛸 수 없고 재생 시간이 (건너뛸 수 없음) 최대값을 초과하기에 필터링됩니다.
- 광고 소재 B의 길이는
max_ad_duration을 초과하지만 건너뛸 수 있고 건너뛸 수 있는 최대 광고 시간을 초과하지 않으므로 광고 소재 B는 필터링되지 않습니다.
ssss(서버 측 병합 소스)
설명
서버 측 병합 소스(ssss) 매개변수는 상수 값을 허용하며, 이 값은 동영상 병합 기술 공급업체에서 인식할 수 있는, Google에서 제공한 값으로 설정해야 합니다.
Google과 서버 간 통합을 사용하는 동영상 병합 기술 공급업체는 Google로부터 이 값을 전달받아 이를 제공할 수 있습니다. 이 매개변수로 설정할 값과 관련하여 궁금한 점이 있으면 Google 계정 관리자에게 문의하세요.
사용 예
ssss=mystitcher
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만 서버 측 구현을 사용하려면 필요합니다.
tfcd(아동 대상 서비스로 취급하기 위한 태그)
trt(트래픽 유형)
설명
트래픽 유형(trt) 매개변수는 구입한 트래픽 또는 자연 트래픽을 요청하는 역할을 하는 상수 값을 허용합니다.
사용 예
구입한 트래픽 요청:
trt=1
자연 트래픽 요청:
trt=2
요구사항 및 권장사항
SDK 사용
요청에서 트래픽 유형 매개변수가 누락된 경우 IMA SDK는 기본값을 채우지 않습니다. 이러한 경우 서버에서 기본값인 0(정의되지 않은 트래픽)을 공급합니다.
us_privacy(IAB 미국 개인 정보 보호)
설명
IAB는us_national 문자열을 지원 중단하고 GPP로 대체했습니다. 하지만 Ad Manager는 하위 호환성을 위해 전달된 경우 문자열을 계속 읽고 사용합니다. 게시자는 GPP 또는 기타 개인 정보 보호 설정을 검토하고 us_national에서 이전하는 것이 좋습니다.
vad_type(동영상 광고 유형)
설명
동영상 광고 유형(vad_type) 매개변수는 선형 광고를 반환해야 하는지, 아니면 비선형 광고를 반환해야 하는지를 나타내는 상수 값을 허용합니다.
사용 예
선형 광고 반환:
vad_type=linear
비선형 광고 반환:
vad_type=nonlinear
vid(동영상 ID)
설명
콘텐츠 소스 ID 매개변수(cmsid) 및 동영상 ID 매개변수(vid)는 변수 값을 허용합니다.
동영상 콘텐츠에 광고를 타겟팅하려면 마스터 동영상 태그에 이 두 매개변수를 모두 포함해야 합니다.
cmsid는 각 콘텐츠 소스의 고유 번호입니다. Google Ad Manager에서 이 ID를 찾으려면 동영상, 콘텐츠 소스, 소스의 이름을 차례로 클릭합니다.vid는 특정 동영상을 식별하는 문자열 또는 숫자입니다. 이 ID는 콘텐츠를 호스팅하는 CMS에 의해 지정됩니다. Google Ad Manager에서 이 ID를 찾으려면 동영상, 콘텐츠, 특정 동영상 콘텐츠를 차례로 클릭합니다.
사용 예
cmsid=[value]&vid=[value]
동적 광고 삽입을 사용하여 VOD용 태그를 만드는 경우 올바른 콘텐츠 소스 및 동영상 ID를 동적으로 삽입할 매크로를 사용해야 합니다.
예: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
요구사항 및 권장사항
이러한 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지 않지만 동영상 콘텐츠 타겟팅을 사용하려면 필요합니다.
vpi(동영상 재생목록 인라인)
설명
동영상 재생목록 인라인(vpi) 매개변수는 인라인 VMAP을 게재할지를 나타내는 상수 값을 허용합니다(VMAP 내에서 VAST 반환).
이 매개변수는 지연 시간을 줄이고 동영상 스트림 전반에서 최대 게재빈도 및 경쟁 제외를 보장하는 데 사용할 수 있습니다.
사용 예
VAST 반환:
vpi=1
리디렉션 반환:
vpi=0