이 도움말에서는 오디오 구현에서 광고를 게재하는 데 사용되는 VAST 광고 태그에 필수 및 권장 매개변수 목록을 보여줍니다.
이 페이지의 내용
오디오용 필수 및 권장 매개변수
광고 게재에 필요한 매개변수
설명
광고 유형 매개변수(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로 설정해야 합니다. 이 값을 설정하지 않은 상태로 두면 오디오 광고가 반환되지 않습니다.
설명
상관자 매개변수(correlator)는 동일한 페이지 조회에서 발생하는 여러 요청에서 함께 사용하는 변수 값을 허용합니다. 이 값은 경쟁 제외(쿠키가 없는 환경에서의 경쟁 제외 포함)를 구현하는 데 사용됩니다.
사용 예
correlator=4345645667
설명
환경 매개변수(env)는 인스트림 광고 요청을 나타내거나 요청이 명확히 동영상 플레이어에서 발생한 것임을 나타내는 상수 값을 허용합니다.
가능한 값은 instream(동영상 및 오디오 광고에 사용할 수 있음) 또는 vp(동영상 광고에만 사용할 수 있음)입니다.
사용 예
동영상 및/또는 오디오:
env=instream
동영상만:
env=vp
설명
출력 형식 매개변수(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
설명
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
프로그래매틱에 필요한 매개변수
설명
재설정 가능한 기기 식별자 매개변수(rdid, idtype, is_lat)는 변수 값을 허용합니다. 이 값은 광고용 식별자(IFA)라고도 합니다.
Android 또는 iOS용 IMA SDK를 사용하는 모바일 애플리케이션의 경우 IMA SDK는 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat 매개변수와 함께 스트림 요청으로 전달합니다.
IMA SDK를 사용하지 않거나 서버 측 비콘(SSB)을 사용하는 경우 이를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요.
거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
|
iOS 14.5부터는 Apple이 |
사용 예
재설정 가능 기기 식별자의 자세한 예 보기
설명
재설정 가능한 기기 식별자 매개변수(rdid, idtype, is_lat)는 변수 값을 허용합니다. 이 값은 광고용 식별자(IFA)라고도 합니다.
Android 또는 iOS용 IMA SDK를 사용하는 모바일 애플리케이션의 경우 IMA SDK는 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat 매개변수와 함께 스트림 요청으로 전달합니다.
IMA SDK를 사용하지 않거나 서버 측 비콘(SSB)을 사용하는 경우 이를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요.
거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
|
iOS 14.5부터는 Apple이 |
사용 예
재설정 가능 기기 식별자의 자세한 예 보기
설명
재설정 가능한 기기 식별자 매개변수(rdid, idtype, is_lat)는 변수 값을 허용합니다. 이 값은 광고용 식별자(IFA)라고도 합니다.
Android 또는 iOS용 IMA SDK를 사용하는 모바일 애플리케이션의 경우 IMA SDK는 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 rdid, idtype, is_lat 매개변수와 함께 스트림 요청으로 전달합니다.
IMA SDK를 사용하지 않거나 서버 측 비콘(SSB)을 사용하는 경우 이를 명시적 매개변수로 전달해야 합니다. 기기 식별자에 대해 자세히 알아보세요.
거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
|
iOS 14.5부터는 Apple이 |
사용 예
재설정 가능 기기 식별자의 자세한 예 보기
설명
동영상 재생 자동(vpa) 매개변수는 광고의 동영상 콘텐츠가 자동재생을 통해 시작되는지 아니면 클릭을 통해 시작되는지를 나타내는 상수 값을 허용합니다.
가능한 값은 페이지에서 사용자 작업을 기다리는 경우 click이고, 동영상이 자동 재생되는 경우에는 auto입니다. 이 매개변수는 동영상 플레이어의 상태를 변경하지 않으므로 재생 동작은 동영상 플레이어에서 직접 처리해야 합니다.
사용 예
자동재생:
vpa=auto
클릭 재생방식:
vpa=click
알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다.
요구사항 및 권장사항
이 매개변수는 웹, 모바일 앱, 커넥티드 TV, 오디오에서 프로그래매틱 수익 창출을 위해 필요합니다.
이 매개변수는 미디어 평가 위원회(MRC) 동영상 측정 가이드라인에 따라서도 권장됩니다.
설명
동영상 재생 음소거 매개변수(vpmute)는 동영상 플레이어가 음소거되어 있는 동안 광고 재생이 시작되는지를 나타내는 상수 값을 허용합니다. 이 매개변수는 동영상 플레이어의 상태를 변경하지 않으므로 재생 동작은 동영상 플레이어에서 직접 처리해야 합니다.
사용 예
재생이 음소거 상태로 시작됨:
vpmute=1
재생이 음소거 해제 상태로 시작됨:
vpmute=0
프로그래매틱에 권장되는 매개변수
설명
오디오 연속 재생 매개변수(aconp)는 플레이어가 오디오 콘텐츠를 연속적으로 재생할 것인지를 나타내는 상수 값을 허용합니다. 이를 통해 Google Ad Manager는 사용자 환경에 가장 적합한 광고를 선택할 수 있습니다.
사용 예
연속 재생 켜짐:
conp=2
연속 재생 꺼짐:
aconp=1
오디오가 연속으로 재생되는지 모르는 경우 이 매개변수를 설정하지 않은 상태로 두거나 aconp=0으로 설정해야 합니다.
설명
앱 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)는 특히 커넥티드 TV 및 셋톱 박스 환경에서 기기 오분류를 줄이는 데 도움이 되는 상수 값을 허용합니다.
기기 오분류는 게시자 또는 커넥티드 TV OEM의 의도치 않은 오류로 인해 발생할 수 있습니다. 이 매개변수는 Google에서 커넥티드 TV 인벤토리가 재분류될 수 있는 경우를 자동으로 신고하기 위해 다른 신호와 함께 사용됩니다.
사용 예
요청받은 내역:
- 피처폰:
dth=1 - 스마트폰:
dth=2 - 데스크톱:
dth=3 - 태블릿:
dth=4 - 커넥티드 TV:
dth=5 - 게임 콘솔:
dth=6 - 셋톱 박스:
dth=7
설명
프로그래매틱 액세스 라이브러리(PAL)를 사용하는 통합의 경우 동영상 nonce 매개변수는 변수 문자열 값을 허용합니다.
nonce는 URL에 안전하므로 URL 인코딩할 필요가 없습니다.
참고: 이전에 기존 paln 매개변수를 사용하여 nonce를 제공한 경우 givn 매개변수로 이전하고 paln 전송을 중지하는 것이 좋습니다. 두 매개변수를 모두 포함하지 마세요.
사용 예
이 매개변수로 전달된 값에 대한 자세한 내용은 PAL 시작 가이드를 참고하세요.
설명
언어 매개변수(hl)는 해당 언어로 광고를 요청하고, Ad Exchange 또는 애드센스 동영상에 대한 동적 할당에서 광고 언어를 선택하고 동영상 광고를 렌더링하는 데 사용되는 상수 값을 허용합니다.
사용 예
이탈리아어로 광고 요청:
hl=it
매개변수 값은 ISO 639-1(영문 기준 2자) 또는 ISO 639-2(영문 기준 3자) 코드일 수 있습니다. 유효한 코드의 목록을 확인하세요.
이 값이 생략되면 기본적으로 Ad Exchange의 언어별 광고 타겟팅에서 사용되는 언어가 사용됩니다.
설명
앱 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 파트너 이름 매개변수(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를 사용하는 경우 사용해서는 안 됩니다.
설명
세션 ID(sid) 매개변수는 최대 게재빈도 설정용으로만 사용되는 개인 정보 보호 광고 식별자인 변수 값을 허용합니다.
세션 ID는 커넥티드 TV의 인스트림 광고 요청 및 모바일 앱 기기로부터의 인스트림 광고 요청에 대해 지원됩니다. 현재 웹에서는 지원되지 않습니다.
sid=0을 설정하여 세션 ID 전달을 선택 해제할 수 있습니다.
사용 예
sid=123e4567-e89b-12d3-a456-426614174000
IAB의 IFA 가이드라인에 따라 이 매개변수는 UUID 형식으로 채워져야 합니다. 사용자 타겟팅에 대해 재설정 가능한 기기 식별자에 대해 자세히 알아보세요.
설명
동영상 연속 재생(vconp) 매개변수는 플레이어가 TV 방송처럼 동영상 콘텐츠를 연속적으로 재생할 것인지를 나타내는 상수 값을 허용합니다.
사용 예
연속 재생 켜짐:
vconp=2
연속 재생 꺼짐:
vconp=1
알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다.
요구사항 및 권장사항
이 매개변수는 특정 구현에 광고를 게재하는 데 필요하지는 않지만 웹, 모바일 앱, 커넥티드 TV, 오디오에서 프로그래매틱 수익 창출을 위해 사용하는 것이 좋습니다.
이 매개변수는 미디어 평가 위원회(MRC) 동영상 측정 가이드라인에 따라서도 권장됩니다.
설명
'이 광고가 표시된 이유' 매개변수(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 지원을 구현해야 합니다.