다음의 타겟팅 매개변수를 공급하는 것은 선택사항입니다.
VOD용 콘텐츠 소스를 생성 또는 설정하거나 DAI용 실시간 스트림을 설정할 때는 기본 동영상 광고 태그를 지정해야 합니다. 모든 DAI 스트림은 기본적으로 이 광고 태그 및 매개변수를 사용합니다. 광고 태그 매개변수는 미드롤과 프리롤에 모두 적용됩니다. 플레이어가 특정 스트림에 대해 특별한 항목을 요청하도록 하려면 이 옵션을 사용할 수 있습니다.
재정의할 수 있는 Ad Manager 광고 태그 매개변수
특정 매개변수로 이동:
addtl_consentanciu_szscust_paramsdescription_urlgdprgdpr_consentidtypeis_lat |
iultdmptmpvnpappidptplptplnrdid |
rdpsidsztfcdtrtvconpvpavpmutewta |
기본 광고 태그 재정의
동영상 플레이어에서 스트림을 요청하면 기본 광고 태그가 인터페이스에서 지정된 그대로 사용됩니다. 하지만 스트림 요청에서 해당 태그의 특정 매개변수를 재정의할 수 있습니다. 재정의 가능한 매개변수는 다음에 국한됩니다.
IMA SDK를 사용하거나 SSB를 사용하여 기본 광고 태그를 재정의하는 방법을 알아보세요.
| 매개변수 | 설명 | 값 예 | |
|---|---|---|---|
iu |
현재 광고 단위입니다. 다음 형식을 따라야 합니다. |
iu=/6062/video/example_unit |
|
cust_params |
Ad Manager 캠페인 타겟팅에 사용해야 하는 키-값 쌍입니다. 일부 플랫폼의 경우 URL 인코딩이 필요합니다. HTML5용 IMA DAI SDK를 사용하면 값이 자동으로 인코딩되므로 URL 인코딩 요구사항은 적용되지 않습니다. 이 매개변수는 이미 HTML5로 인코딩된 경우에는 작동하지 않습니다. |
여러 개의 키-값 쌍이 있는 예:
SSB 스트림: 전체
Chromecast:
Roku: 전체
iOS 및 tvOS: 아무것도 인코딩해서는 안 됩니다.
Android: 아무것도 인코딩해서는 안 됩니다.
|
|
sz |
기본 광고 태그에서 크기 다음에 ' |
sz=400x300 |
|
tfcd |
아동 대상 서비스로 취급하기 위한 요청을 태그 지정합니다. DAI 요청에 |
|
|
|
이 값은 페이지에서 재생 중인 동영상에 대한 설명입니다. 일반적으로 동영상 플레이어가 포함된 페이지를 뜻하지만 동영상을 설명하는 텍스트가 있는 페이지일 수도 있습니다. 이 매개변수는 IMA SDK에 의해 자동으로 설정되지 않으므로 직접 설정해야 합니다. |
URL 인코딩된 예: 인코딩되지 않은 예: |
||
ppid |
게시자 제공 식별자(PPID)를 통해 게시자는 기기 전반에 대해 최대 게재빈도 설정, 잠재고객 분류 및 타겟팅, 순차적 광고 로테이션, 기타 잠재고객 기반 광고의 게재 관리 시 사용할 수 있는 식별자를 보낼 수 있습니다. 자세히 알아보기 | ppid= |
|
ciu_szs |
쉼표로 분리된 컴패니언 광고 크기의 목록입니다. HTML5 SDK를 사용하는 경우 컴패니언 광고는 DAI에서만 지원됩니다. |
ciu_szs=728x90,300x250 |
|
mpt |
파트너 플레이어의 이름을 나타냅니다. 대부분 SDK와 통합되는 JWPlayer, Brightcove, Ooyala 등의 파트너에 의해 사용됩니다. |
mpt=JWPlayer |
|
mpv |
파트너 플레이어의 버전을 나타냅니다. 이는 |
mpv=2.1 |
|
ptpl |
광고 시간 템플릿 ID입니다.
이 ID는 Ad Manager 인터페이스에서 광고 시간 템플릿 설정을 확인할 때 Ad Manager URL에서 찾을 수 있습니다. |
ptpl=1234 |
|
ptpln |
광고 시간 템플릿 이름입니다. 표시 이름이 아닌 Ad Manager의 '이름' 필드에 대응합니다.
|
ptpln=my_break_template |
|
an |
이 매개변수는 대부분의 프로그래매틱 동영상 광고에 필요하므로 모바일 앱 및 커넥티드 TV 기기에서 전송된 요청에 적용되어야 합니다.* IMA SDK는 이 매개변수를 자동으로 채우지만, DAI API 및 SSB(비 SDK 환경)를 사용하는 경우에는 직접 지정해야 합니다. * 앱 이름은 사람이 읽을 수 있는 이름이어야 하며, iOS 및 tvOS에서는 SDK가 9자리의 앱 스토어 ID에 액세스할 수 없습니다. 이러한 경우에는 SDK가 |
|
|
ltd |
쿠키 또는 기타 로컬 식별자 사용에 대한 동의 없이 제한된 방식으로 광고를 게재할 수 있는지를 나타냅니다. 자세히 알아보기 | ltd=1 |
|
rdid |
네이티브 애플리케이션(웹 또는 모바일 웹은 해당되지 않음)을 사용하는 경우 SDK에서는 사용자 타겟팅에 대해 재설정할 수 있는 기기 식별자를 rdid, idtype 및 is_lat에 대한 매개변수가 포함된 스트림 요청으로 전달합니다. SSB 스트림에서는 클라이언트 측 동영상 솔루션 광고 요청과 마찬가지로, 이러한 매개변수를 명시적 매개변수로 전달해야 합니다.
|
재설정 가능한 기기 식별자의 자세한 예를 확인하세요. | |
trt |
트래픽을 구입한 트래픽 또는 다른 트래픽으로 지정합니다. |
정의되지 않은 트래픽 유형: 구입한 트래픽: 자연 트래픽: |
|
vconp |
다음에 따라 권장됨: MRC 동영상 측정 가이드라인
플레이어가 TV 방송과 유사한 방식으로 콘텐츠 동영상을 연속으로 재생하는지를 나타냅니다. 가능한 값은 연속 재생이 켜짐인 경우 알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다. |
연속 재생 켜짐:vconp=2연속 재생 꺼짐: |
|
vpa |
다음에 따라 권장됨: MRC 동영상 측정 가이드라인
자동재생 또는 클릭 중 무엇으로 광고를 시작할지를 나타냅니다. 가능한 값은 페이지에서 사용자 작업을 기다리는 경우 알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다. |
자동재생:vpa=auto클릭: |
|
vpmute |
다음에 따라 권장됨: MRC 동영상 측정 가이드라인
동영상 플레이어가 음소거된 상태로 광고 재생을 시작할지를 나타냅니다. 가능한 값은 음소거 시 알 수 없는 경우 이 매개변수를 설정하지 않은 상태로 두어야 합니다. |
음소거됨:vpmute=1음소거 해제됨: |
|
npa |
광고 요청의 개인 맞춤설정입니다. 잘림을 방지하려면 매개변수를 태그 앞 부분에 지정하는 것이 좋습니다.
광고 요청을 개인 맞춤이 아닌 광고로 표시하려면 |
npa=1 |
|
gdprgdpr_consent |
이러한 입력란은 수신 및 발신 쿠키 동기화 요청 모두에 대해 TCF v2.0 동의 정보를 전달하는 데 사용됩니다. |
GDPR 사양을 참고하세요. |
|
addtl_consent |
IAB에 등록되어 있지는 않으나 동의한 Google Ads 기술 제공업체의 목록입니다. |
추가 동의 사양을 참고하세요. |
|
rdp |
데이터 처리를 제한하려면 명확히 |
|
|
sid |
최대 게재빈도 설정을 위해서만 사용할 수 있는 개인 정보 보호 광고 식별자의 유형입니다. IAB의 IFA 가이드라인에 따라 이 매개변수는 UUID 형식으로 채워져야 합니다. 자세히 알아보기
|
|
|
wta |
동영상 플레이어가 '이 광고가 표시된 이유'의 렌더링을 지원함을 나타냅니다. 이는 IMA SDK를 사용하는 경우 자동으로 지원됩니다. IMA SDK를 사용하지 않는 경우에는 이 DAI API 가이드에 설명된 대로 동영상 플레이어가 VAST SSB에는 WTA가 지원되지 않습니다. 이는 Ad Exchange를 사용하는 경우 필수 입력란입니다. 자세히 알아보기 * 커넥티드 TV 기기 외에는 |
지원됨: 지원되지 않음: |
IMA SDK를 사용하여 기본 광고 태그 재정의하기
동영상 플레이어에서 IMA SDK를 사용하여 DAI 스트림을 요청하는 경우 'adTagParameters'라는 필드를 전달할 수 있습니다. 키-값 쌍으로 사전과 같은 구조를 설정할 수 있으며, 여기에서 키는 위의 표에 나열된 Ad Manager 광고 태그 매개변수가 될 수 있습니다.
스트림을 맞춤설정하고 이와 같은 구조를 사용하여 Ad Manager 광고 요청과 관련되지 않은 매개변수를 전달할 수도 있습니다. 특정 스트림 변수 요청 방법 및 광고 동적 삽입 방지 설정 방법을 알아보세요.
adTagParameters 필드의 구현은 특정 프로그래밍 언어 또는 플랫폼에 따라 약간 다릅니다. iOS, Android, tvOS, Chromecast, HTML5 개발 문서 또는 DAI 플레이어 및 앱 개발 가이드의 추가 문서를 참고하세요.
SDK를 통해 adTagParameters 설정하기
iOS, tvOS 및 Android 앱에서 SDK를 통해 cust_params 또는 description_url을 설정할 때 문자열을 URL 인코딩해서는 안 됩니다. '&'로 키-값 쌍을 연결하는 하나의 문자열로 cust_params를 전달할 수 있습니다.
예를 들어 cust_params를 sport=football&city=newyork의 값으로 설정하려면 다음을 따릅니다.
인코딩되지 않은 값을 사용하는 adTagParams 구조는 다음과 같습니다.
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport=football&city=newyork",
"description_url": "http://www.sample.com/golf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}HTML5 스트림 요청에 인코딩된 값을 사용하는 adTagParameters 구조는 다음과 같습니다.
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport%3Dfootball%26city%3Dnewyork",
"description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}인코딩된 값을 사용하는 adTagParams 구조(Roku 스트림 요청의 경우)는 다음과 같습니다.
request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"DAI API를 사용하여 기본 광고 태그 재정의하기 (베타)
동영상 플레이어에서 DAI API를 사용하여 DAI 스트림을 요청하는 경우 키-값 쌍을 전달할 수 있으며, 키는 위의 표에 나열된 Ad Manager 광고 태그 매개변수가 될 수 있습니다.
이러한 매개변수는 선형/실시간 및 VOD 둘 다에서 양식 유형 application/x‑www‑form‑urlencoded인 HTTP POST 요청 본문의 일부로 전송되어야 합니다.
스트림을 맞춤설정하고 이와 같은 구조를 사용하여 Ad Manager 광고 요청과 관련되지 않은 매개변수를 전달할 수도 있습니다. 특정 스트림 변형 매개변수 및 HMAC 인증을 요청하는 방법을 알아보세요.
DAI API 샘플 구현을 참조하세요.
SSB를 사용하여 기본 광고 태그 재정의하기
다음은 SSB 기본 VOD 광고 태그를 수정하는 예입니다. 플레이어 또는 앱에서 전달한 재정의된 매개변수는 강조표시됩니다.
VOD 예 |
| 예 | |
|---|---|
| 기본 VOD 스트림 URL | http://dai.google.com/ondemand/hls/content/ |
| (지정된 광고 단위 포함) | http://dai.google.com/ondemand/hls/content/ |
| (재정의된 키-값 포함) |
http://dai.google.com/ondemand/hls/content/ |
| (아동 대상 콘텐츠임을 명시한 내용 포함) |
http://dai.google.com/ondemand/hls/content/ |
| (재정의된 광고 단위 및 키-값 및 맞춤 description_url및 아동 대상 콘텐츠임을 명시한 내용 포함) |
http://dai.google.com/ondemand/hls/content/ |
선형 실시간 방송 스트림의 예 |
| 예 | |
|---|---|
| 기본 라이브 선형 스트림 URL | https://dai.google.com/linear/hls/event/<asset_key> |
| (지정된 광고 단위 포함) | https://dai.google.com/linear/hls/event/<asset_key> |
| (재정의된 키-값 포함) | https://dai.google.com/linear/hls/event/<asset_key> |
| (아동 대상 콘텐츠임을 명시한 내용 포함) |
https://dai.google.com/linear/hls/event/<asset_key> |
| (재정의된 광고 단위 및 키-값 및 맞춤 description_url및 아동 대상 콘텐츠임을 명시한 내용 포함) |
https://dai.google.com/linear/hls/event/<asset_key> |
특정 실시간 스트림 중에 타겟팅 매개변수를 동적으로 업데이트하기
IMA DAI SDK의 replaceAdTagParameters 메서드를 사용하여 스트림 시청 중에 특정 사용자의 타겟팅 데이터를 동적으로 업데이트할 수 있습니다.