알림

Google Ad Manager 360에서만 사용 가능

스트림 매개변수 재정의

스트림 매개변수 재정의는 선택사항입니다.

플레이어나 애플리케이션에서 다음을 재정의하기를 원하는 경우 사용할 수 있습니다.

  • 스트림 생성 매개변수의 기본값
  • HLS 또는 DASH 재생목록이 요청되었을 때 변형의 선택항목 또는 기본 순서

이러한 매개변수는 IMA SDKSSB(서버 측 비커닝), DAI API 구현 시 플레이어나 앱에서 전달할 수 있습니다.

도움말: 다른 기본 광고 태그 매개변수를 재정의할 수도 있습니다.

변형 선택항목 및 순서 재정의

기본 재생목록 순서는 게시자가 결정합니다. 순서 매개변수가 지정되지 않으면 재생목록은 게시자가 반환한 것과 같은 원래 순서로 반환됩니다.

스트림을 생성할 때 지정된 변형 선택 및 순서 매개변수를 재정의할 수 있습니다. 이렇게 하면 마스터 재생목록 요청 응답에 포함된 변형의 하위 집합을 지정하고 해당 변형의 순서를 결정할 수 있습니다. 콘텐츠를 소비하는 사용자에 따라 특정 변형이 다른 변형에 비해 우선적으로 사용되기를 원할 때 유용합니다.

변형의 하위집합 및 순서는 스트림이 사용되는 동안 그대로 유지됩니다. 매개변수는 IMA SDK를 사용할 때 adTagParameters 구조의 일부인 DAI API 매개변수로 수용되거나 SSB를 사용할 때 추가 HTTP GET 매개변수로 수용됩니다.

매개변수 스트리밍 프로토콜 설명
dai-aor HLS, DASH

반환할 오디오 변형의 대역폭 범위입니다.

  • 더 높은 대역폭을 모두 선택하려면 startBandwidth만 지정하세요. 
  • 더 낮은 대역폭을 모두 선택하려면 :endBandwidth(콜론(:)으로 시작함)만 지정하세요.

dai-aor=123:456
dai-aor=12
dai-aor=:456

dai-dlid HLS, DASH

동영상 애셋의 CDN 구성을 만들 때 기본 CDN 구성 및 추가 CDN 게재 설정을 정의합니다. 이렇게 하면 두 개 이상의 CDN을 설정하고 키-값을 사용하여 세션 시작 시 게재할 CDN을 동적으로 선택할 수 있습니다.

CDN 구성을 설정하고 저장하고 나면 Ad Manager에서는 각각의 이름을 지정합니다. 이 이름은 dai-dlid 매개변수의 값으로 스트림 생성 요청에 전달되어야 합니다.

요청에 이름이 전달되지 않으면 Ad Manager에서는 기본 CDN을 사용합니다.

참고: dai-dlid는 단일 콘텐츠에 대해 게재 위치가 다른 여러 CDN이 있는 경우 여러 값을 허용합니다.

dai-dlid=AaBbC1aaBa0obA1BABaaBA

(AaBbC1aaBa0obA1BABaaBA는 Ad Manager에 표시되는 이름입니다.)

dai-excl HLS, DASH 재생목록에서 제외할 변환입니다. subtitles, codec, audio-lang, subtitle-lang, iframe, resolution을 지원합니다. 단일 값 또는 여러 값이 쉼표로 구분된 목록을 사용하여 해상도, 오디오 코덱, 동영상 코덱, 오디오 또는 자막 언어를 제외할 수 있습니다. Codec 접두사는 '*' 접미사도 지원되며, 이는 제공된 접두사를 포함하는 codec이 있는 모든 변환을 제외합니다.

dai-excl=subtitles
dai-excl=iframe


단일 코덱
dai-excl=codec:ec-3

여러 코덱
dai-excl=codec:ec-3,codec:ac-3

접두사 코덱
dai-excl=codec:avc1*


단일 언어 오디오
dai-excl=audio-lang:en

단일 언어 자막
dai-excl=subtitle-lang:en

여러 선택항목
dai-excl=audio-lang:en,
audio-lang:es,
subtitle-lang:en,
subtitle-lang:es


해상도
dai-excl=resolution:480x272

dai-os HLS 마스터 재생목록 상단에 배치할 동영상 변형 대역폭입니다. 값이 startBandwidth에 가장 가까운 변형이 선택됩니다. 두 값의 거리가 같으면 더 낮은 값이 선택됩니다. 이 매개변수는 제공되고 dai-aor는 제공되지 않는 경우 모든 오디오 전용 변형이 제외됩니다. dai-os=1700000
dai-ot
                         
HLS

dai-ov 매개변수로 지정하는 값의 유형을 나타내는 순서 유형 정보입니다. 대역폭 기반 순서(가장 가까운 값으로 매칭)를 나타내는 'bw' 또는 대역폭 및 해상도 기반 순서(정확하게 일치하는 항목에 매칭)를 나타내는 'bw_res' 중 하나여야 합니다. 대역폭이나 해상도 중 적어도 하나는 지정되어야 하며 기본값은 'bw'입니다.

dai-ot 매개변수는 지정되고 dai-ov는 지정되지 않은 경우 재생목록은 모든 변형을 원래 순서로 반환합니다.

dai-ot=bw
dai-ot=bw_res
dai-ov HLS

반환될 미디어 재생목록의 순서를 지정하는 쉼표로 구분된 값입니다. dai-ot와 함께 사용되어야 하며, 각 값은 dai-ot 매개변수에 설명된 유형과 같아야 합니다. 특수 값 audio를 사용하여 오디오 변형을 지정하세요.

순서 값이 동일한 변형이 여러 개 존재하는 경우(예: 대역폭은 같지만 해상도가 다른 두 개의 변형이 있는 경우) 그러한 변형들은 원래 순서로 유지됩니다.

dai-ot=bw&dai-ov=2025837,1406061

dai-ot=bw_res&dai-ov=1400000:640x360,audio

dai-sr HLS, DASH

반환될 동영상 변형의 대역폭 범위입니다. 더 높은 대역폭을 모두 선택하려면 startBandwidth만 지정하세요. 더 낮은 대역폭을 모두 선택하려면 :endBandwidth(콜론(:)으로 시작함)만 지정하세요.

대역폭 적용은 동영상 콘텐츠에만 적용됩니다.
dai-sr=1300000:2500000

기타 재정의 매개변수

매개변수 스트리밍 프로토콜 설명
dai-ah HLS, DASH 실시간 스트림에 광고 동적 삽입 방지 적용 여부를 지정합니다. 광고 동적 삽입 방지 길이는 실시간 스트림 구성에 지정되어야 합니다. 광고 동적 삽입 방지 사용 설정:
dai-ah=1
dai-apto
 (베타) 
HLS, DASH

VOD 및 라이브 스트림 생성에 대한 광고 모음 결정 제한 시간(밀리초)입니다.

이 값은 스트림 생성 시 모든 광고 차단 결정(선형의 경우 중간 광고 시점 및 과거 광고 시점 결정, VOD의 경우 VMAP 결정)에 사용됩니다. 그러나 과거 광고 시점의 경우 이벤트 유형 재생목록 또는 dai-dpb 매개변수를 사용하는 경우에만 사용할 수 있습니다.

0보다 크고 10,000 이하인 값으로 설정할 수 있습니다.

매우 낮거나 높은 값을 설정하면 광고 유효노출이나 사용자 경험에 영향을 미칠 수 있습니다.

dai-apto=4000
dai-dpb HLS, DASH

비SSB 선형 스트림에 대해 과거 광고 시점 결정을 사용할지 여부를 지정합니다(SSB 스트림의 경우 매개변수가 무시됨). 사용 설정하면 과거 광고 시점은 중간 광고 시점 결정으로 결정됩니다.

이는 사용자가 dai-apto 매개변수로 제어할 수 있는 시작 지연 시간에 영향을 미칠 수 있습니다.

사용자가 되감기를 하지 않는 한 과거 시점은 조회되지 않으며 이로 인해 코드 제공 횟수가 늘어날 수 있습니다.

과거 광고 시점 결정 사용 설정:
dai-dpb=true

HSL 이벤트 유형 재생목록에 대한 과거 광고 시점 결정 사용 안함:
dai-dpb=false
dai-dvr HLS, DASH 사용자가 뒤로 스크롤하여 재생을 원활하게 유지할 수 있는, 실시간 콘텐츠와 광고의 DVR 길이(초)입니다. 

이 값의 현재 기본값은 100초 또는 실시간 스트림 설정에 지정된 값입니다. 하지만 실시간 스트림마다 새로운 최대값을 지정할 수 있습니다. SSB의 경우 최대 100초, SDK 또는 API를 사용하면 최대 1800초까지 지정할 수 있습니다. DVR 길이를 더 늘이려면 계정 관리자에게 문의하세요.

dai-dvr=60
dai-emsgv HLS

이벤트 메시지 버전은 호출자가 CMAF(Common Media Application Format) 콘텐츠의 'emsg' 버전을 지정할 수 있는 스트림 생성 매개변수입니다.

HLS 표준을 사용하려면 'emsg' 버전 1이 필요합니다.

이 설정은 Roku와 같이 표준 버전 1을 지원하지 않고 버전 0이 필요한 플랫폼에 유용합니다.
dai-emsgv=1
dai-pre (베타)  HLS, DASH 프리롤을 사용 설정한 라이브 스트림이 겹치는 경우 미드롤 대신 프리롤을 표시할지 여부를 지정합니다. 기본 동작은 프리롤 대신 겹치는 미드롤을 표시합니다. dai-pre=1
dai-ad-dlid (베타)  HLS, DASH

라이브 스트림에 광고를 게재하기 위해 Google Ad Manager에서 사전 구성한 외부 CDN의 고유한 이름을 지정합니다.

외부 CDN을 통한 광고 게재에 대해 자세히 알아보세요.

dai-ad-dlid=AaBbC1aaBa0obA1BABaaBA

(AaBbC1aaBa0obA1BABaaBA는 Ad Manager에 표시되는 이름입니다.)

dai-aup (베타)  HLS, DASH

라이브 스트림에 광고를 게재하기 위해 광고 세그먼트 URL을 생성하는 데 사용되는 외부 CDN을 가리키는 임의의 URL 접두어를 지정합니다.

외부 CDN을 통한 광고 게재에 대해 자세히 알아보세요.

dai-aup=https://domain.com/path-c1/path-c2

매개변수 재정의 예

모두 펼치기  모두 접기

DAI 문제 해결 또는 중단과 관련된 모든 문제는 게시자 지원팀에 문의하세요.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?
9076060176562127251
true
도움말 센터 검색
true
true
true
true
true
148
검색
검색어 지우기
검색 닫기
기본 메뉴
false
false
false
false