IMA SDK를 사용하지 않고 Ad Exchange에서 태그 기반 동영상 솔루션을 구현하는 기능은 베타 버전이며 일부 네트워크에는 제공되지 않을 수 있습니다. 자세한 내용은 계정 관리자에게 문의하세요.
다음은 VAST 광고 태그 URL 매개변수 중 일부입니다. 이러한 매개변수는 IMA SDK 통합을 사용하지 않는 경우 프로그래매틱용 태그 기반 동영상 솔루션을 위한 것입니다.
웹용 필수 및 권장 매개변수 또는 앱용 필수 매개변수 목록을 확인하세요.
목록에서 특정 매개변수로 이동하기
| 매개변수 | 세부정보 | |
|---|---|---|
hl
(언어) |
언어 매개변수는 해당 언어로 광고를 요청하고, Ad Exchange 또는 애드센스 동영상에 대한 동적 할당에서 광고 언어를 선택하고 동영상 광고를 렌더링하는 데 사용되는 상수 값을 허용합니다. 매개변수 값은 ISO 639-1(영문 기준 2자) 또는 ISO 639-2(영문 기준 3자) 코드일 수 있습니다. 유효한 코드의 목록을 확인하세요. 이 값이 생략되면 기본적으로 Ad Exchange의 언어별 광고 타겟팅에서 사용되는 언어가 사용됩니다. 사용 예
요건
|
|
description_url
(설명 URL) |
설명 URL 매개변수는 페이지에서 재생 중인 동영상을 설명하는 변수 값을 허용합니다. 콘텐츠를 설명하는 1~3개의 단락으로 페이지를 간략하게 설명합니다. 예를 들어 사전 정의된 블록에서
이 매개변수는 IMA SDK에 의해 자동으로 설정되지 않으므로 직접 설정해야 합니다. 사용 예URL 인코딩: 인코딩되지 않음: 요구사항
|
|
dth
(기기 유형 힌트) |
기기 유형 힌트 매개변수는 특히 커넥티드 TV 및 셋톱 박스 환경에서 기기 오분류를 줄이는 데 도움이 되는 상수 값을 허용합니다. 기기 오분류는 게시자 또는 커넥티드 TV OEM의 의도치 않은 오류로 인해 발생할 수 있습니다. 이 매개변수는 Google에서 커넥티드 TV 인벤토리가 재분류될 수 있는 경우를 자동으로 신고하기 위해 다른 신호와 함께 사용됩니다. 사용 예요청받은 내역:
요구사항
이 매개변수는 PAL 및 PAI(비 SDK) 구현에 권장됩니다. IMA SDK 또는 DAI SDK에는 필요하지 않습니다. |
|
msid
(앱 ID) an
(앱 이름) |
앱 ID 및 이름 매개변수는 대부분의 프로그래매틱 동영상 광고에 대해 필수이므로 모바일 앱 및 커넥티드 TV 기기에서 전송된 요청에 적용되어야 하는 변수 값을 허용합니다. 두 매개변수는 IMA SDK가 자동으로 채우지만, 직접 VAST 호출(비 SDK 환경)에서는 두 매개변수를 직접 지정해야 합니다. 앱 이름은 인간이 읽을 수 있는 이름이어야 합니다. iOS 및 tvOS에서는 SDK가 앱 ID에 액세스할 수 없습니다. 이러한 경우에는 사용 예
앱 ID는 앱 스토어별로 이름과 형식이 다릅니다. 앱 식별을 위한 IAB 가이드라인 또는 일반 고유 식별자의 예를 참고하세요. 앱 스토어가 없는 플랫폼의 경우 IAB에서는 스토어 ID에 요구사항
|
|
plcmt
(게재위치) |
게재위치 매개변수는 IAB 사양의 안내에 따라 인스트림 인벤토리가 인스트림 또는 함께 표시되는 콘텐츠로 선언되는지 여부를 나타내는 데 사용되는 상수 값을 허용합니다. 비인스트림 요청의 경우, 이 필드는 선언된 인벤토리 형식에 따라 구매자에 대해 자동으로 채워지며 인스트림 또는 함께 제공되는 콘텐츠 선언을 재정의합니다. 사용 예인스트림 요청: 함께 표시되는 콘텐츠 요청: 요구사항 |
|
pp
(광고 소재 프로필) |
광고 소재 프로필 매개변수는 동영상 및 오디오 광고 소재 프로필에 설정된 구성에 따라 게재할 수 있는 광고 소재를 제어하는 변수 값을 허용합니다. 사용 예
요건
|
|
rdid
(재설정 가능한 기기 식별자) |
재설정 가능한 기기 식별자는 변수 값을 허용합니다. SDK는 내장 애플리케이션(웹 또는 모바일 웹에는 없음)을 통해 사용자 타겟팅을 위해 재설정 가능한 기기 식별자를 거의 모든 프로그래매틱 동영상 광고에는 이러한 값이 있어야 합니다.
사용 예재설정 가능한 기기 식별자의 자세한 예를 확인하세요. 요건
|
|
sid
(세션 ID) |
세션 ID 매개변수는 최대 게재빈도 설정용으로만 사용되는 개인 정보 보호 광고 식별자인 변수 값을 허용합니다. 세션 ID는 커넥티드 TV의 인스트림 광고 요청 및 모바일 앱 기기로부터의 인스트림 광고 요청에 대해 지원됩니다. 현재 웹에서는 지원되지 않습니다. IAB의 IFA 가이드라인에 따라 이 매개변수는 UUID 형식으로 채워져야 합니다. 사용자 타겟팅에 대해 재설정 가능한 기기 식별자에 대해 자세히 알아보세요.
사용 예
요건
|
|
url
(URL) |
URL 매개변수는 요청이 전송되는 전체 URL로 설정되어야 하는 변수 값을 허용합니다. 이 값은 구매자가 이 요청의 출처를 파악하고 이해하는 데 필요합니다. 가능한 한 이 값은 광고 요청에서 동적으로 채워져야 합니다. 이는 웹페이지에서는 동영상 플레이어를 표시하는 페이지의 URL입니다. IMA SDK를 사용하는 경우 URL 값이 자동으로 설정됩니다. 플레이어가 이 값을 설정하는 경우 IMA SDK는 설정되는 값을 사용합니다. 앱(휴대기기 또는 CTV)에서 이 값은 수익을 창출하는 동영상 또는 오디오 인벤토리를 가장 정확하게 나타내는 URL로 설정되어야 합니다. 예를 들어 사용자가 모바일 앱 내에서 동영상을 보고 있는 경우 그 동영상은 데스크톱의 동일한 URL에서도 볼 수 있는 것입니다.* 이 매개변수의 값을 인코딩해야 합니다. 사용 예
* 앱의 경우 이 매개변수를 변수 URL 값으로 설정할 수 없다면 다음 패턴으로 설정하는 것이 좋습니다. 요구사항
|
|
vpa
(동영상 자동 재생) |
다음에 따라 권장됨: MRC 동영상 측정 가이드라인 동영상 재생 자동 매개변수는 광고의 동영상 콘텐츠가 자동재생을 통해 시작되는지 아니면 클릭을 통해 시작되는지를 나타내는 상수 값을 허용합니다. 가능한 값은 페이지에서 사용자 작업을 기다리는 경우 알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다. 사용 예자동재생: 클릭 재생방식: 요건
|
|
vpmute
(동영상 재생 음소거) |
다음에 따라 권장됨: MRC 동영상 측정 가이드라인 음소거된 동영상 매개변수는 동영상 플레이어가 음소거되어 있는 동안 광고 재생이 시작되는지를 나타내는 상수 값을 허용합니다. 사용 예음소거됨: 음소거 해제됨: 요구사항 |
|
vpos
(동영상 위치) |
동영상 위치 매개변수는 광고 요청이 프리롤, 미드롤, 포스트롤 중 어디에서 전송되는지를 나타내는 상수 값을 허용합니다. 사용 예프리롤: 미드롤: 포스트롤: 요건
|
|
wta
(이 광고가 표시된 이유) |
'이 광고가 표시된 이유' 파라미터는 동영상 플레이어에서 광고 배지 표시 렌더링을 지원함을 나타내는 상수 값을 허용합니다. 광고 배지 표시 기능은 IMA SDK를 사용하는 경우 자동으로 지원됩니다. IMA SDK를 사용하지 않는 경우에는 IAB VAST 표준에 설명된 대로 동영상 플레이어가 VAST 게시자가 VAST 응답에 제공된 AdChoices 아이콘을 렌더링하지 않을 경우 게시자는 VAST 응답에 제공된 AdChoices 아이콘이 컴패니언에서 렌더링되거나 사용자에게 제공되는 경우 오디오 광고 요청에서는 EEA의 트래픽의 경우 광고가 유럽 경제 지역(EEA)에서 게재되는 광고에 적용되는 규제 요건을 준수해야 합니다. 여기에는 사용자가 불법 콘텐츠를 신고할 수 있는 메커니즘이 포함됩니다. 게시자는 불법 콘텐츠 신고가 있을 경우 적절한 양식을 사용하여 Google에 알려야 합니다. 사용 예지원됨:
지원되지 않음: 요건
|
