동적 광고 삽입 광고 모음 게재 VOD API

동적 광고 삽입 API를 사용하면 DAI 주문형 스트림을 요청하고 추적할 수 있습니다.

서비스: dai.google.com

모든 URI는 https://dai.google.com을 기준으로 합니다.

메서드: 스트림 만들기

이 메서드는 기기에서 직접 스트림을 만들어 클라이언트 애플리케이션이 광고를 재생 및 추적하고 UI 요소를 표시하는 데 필요한 모든 리소스를 반환합니다.

메서드
create stream POST: /ondemand/pods/api/v1/network/{network_code}/stream

DAI 광고 모음 게재 VOD 세션을 만듭니다.

HTTP 요청

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/stream

경로 매개변수

매개변수
network_code string

게시자의 Google Ad Manager 네트워크 코드입니다.

요청 본문

요청 본문은 application/json 유형이며 CreateStreamRequest 객체를 포함해야 합니다.

응답 본문

성공한 경우 응답 본문에 새 CreateStreamResponse 객체가 포함됩니다.

메서드: 스트림 등록

이 메서드는 기기에서 Google DAI 백엔드에 스트림을 등록하여 클라이언트 애플리케이션이 광고를 추적하고 UI 요소를 표시하는 데 필요한 모든 리소스를 반환합니다. create stream 메서드와 달리 이 메서드는 플레이 가능한 광고 매니페스트를 반환하지 않습니다. 대신 이 작업은 별도의 서버 호출인 decision ad pods에서 실행됩니다.

메서드
register stream POST: /ondemand/pods/api/v1/network/{network_code}/stream_registration

DAI 광고 모음 게재 VOD 세션을 등록합니다.

HTTP 요청

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/stream_registration

경로 매개변수

매개변수
network_code string

게시자의 Google Ad Manager 네트워크 코드입니다.

요청 본문

요청 본문은 application/json 유형이며 StreamRegistrationRequest 객체를 포함해야 합니다.

응답 본문

성공한 경우 응답 본문에 새 StreamRegistrationResponse 객체가 포함됩니다.

메서드: 광고 모음 가져오기

이 메서드는 기기에서 register stream 호출을 따르며 콘텐츠 매니페스트에 스티치할 수 있는 플레이 가능한 광고 매니페스트를 검색하는 데 필요합니다.

메서드
decision ad pods POST: /ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods

DAI 광고 모음 게재 VOD 세션의 광고 모음을 결정합니다.

HTTP 요청

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods

경로 매개변수

매개변수
network_code string

게시자의 Google Ad Manager 네트워크 코드입니다.

stream_id string

stream_registration 호출에서 수신한 stream_id입니다.

요청 본문

요청 본문은 application/json 유형이며 AdPodDecisionRequest 객체를 포함해야 합니다.

응답 본문

성공한 경우 응답 본문에 새 AdPodDecisionResponse 객체가 포함됩니다.

메서드: 광고 모음 메타데이터

이 메서드는 클라이언트 앱이 광고를 추적하고 적절한 UI 요소를 정확하게 렌더링하는 데 필요한 모든 정보를 반환합니다.

메서드
ad pods metadata GET: /ondemand/pods/api/v1/network/.../metadata

특정 세션의 광고 모음 메타데이터를 가져옵니다. 이 URL은 StreamRegistrationResponse metadata_url 속성으로 반환됩니다.

HTTP 요청

GET: /ondemand/pods/api/v1/network/.../metadata

응답 본문

성공하면 응답 본문에 Ad pods metadata 객체가 포함됩니다.

데이터

PodMetadata

PodMetadata에는 광고, 광고 시점, 미디어 ID 태그에 관한 메타데이터 정보가 포함됩니다.
JSON 표현
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
  "polling_frequency": number,
}
필드
tags map[string, object(TagSegment)]

태그 접두사로 색인이 생성된 태그 세그먼트의 맵
ads map[string, object(Ad)]

광고 ID로 색인이 생성된 광고의 맵입니다.
ad_breaks map[string, object(AdBreak)]

광고 시점 ID로 색인이 생성된 광고 시점의 맵입니다.
polling_frequency number

권장 메타데이터 URL 폴링 빈도(초)입니다. 주문형 의사 결정을 사용하는 VOD 스트림에 대해 채워집니다.

TagSegment

TagSegment에는 광고, 광고 시점, 이벤트 유형에 대한 참조가 포함됩니다. type='progress'가 있는 TagSegment는 광고 미디어 확인 엔드포인트로 핑해서는 안 됩니다.
JSON 표현
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
필드
ad string

이 태그의 광고 ID입니다.
ad_break_id string

이 태그의 광고 시점 ID입니다.
type string

이 태그의 이벤트 유형입니다.

AdBreak

AdBreak는 스트림의 단일 광고 시간을 설명합니다. 재생 시간, 유형 (mid/pre/post), 광고 수를 포함합니다.
JSON 표현
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
필드
type string

유효한 광고 유형은 pre, mid, post입니다.
duration number

이 광고 시간의 총 광고 시간(초)입니다.
expected_duration number

모든 광고와 슬레이트를 포함한 광고 시점의 예상 기간 (초)입니다.
ads number

광고 시점의 광고 수입니다.
Ad는 스트림의 광고를 설명합니다.
JSON 표현
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
필드
ad_break_id string

이 광고의 광고 시점 ID입니다.
position number

광고 시점 내 광고의 위치입니다(1부터 시작).
duration number

광고 길이(초)입니다.
title string

광고의 선택적 제목입니다.
description string

광고에 대한 설명(선택사항)
advertiser string

선택적 광고주 식별자입니다.
ad_system string

선택적 광고 시스템입니다.
ad_id string

선택적 광고 ID입니다.
creative_id string

선택적 광고 소재 ID입니다.
creative_ad_id string

선택적 광고 소재 광고 ID입니다.
deal_id string

선택적 거래 ID입니다.
clickthrough_url string

선택사항인 클릭연결 URL입니다.
click_tracking_urls string

선택적 클릭 추적 URL입니다.
verifications [object(Verification)]

서드 파티 측정 코드를 실행하여 광고 소재 재생을 확인하는 데 필요한 리소스와 메타데이터를 나열하는 선택적 Open Measurement 확인 항목
slate boolean

현재 항목이 슬레이트임을 나타내는 선택적 불리언입니다.
icons [object(Icon)]

아이콘 목록입니다. 비어 있으면 생략됩니다.
wrappers [object(Wrapper)]

래퍼 목록입니다. 비어 있으면 생략됩니다.
universal_ad_id object(UniversalAdID)

선택적 범용 광고 ID입니다.
extensions string

VAST의 모든 <Extension> 노드의 선택적 목록입니다.
companions [object(Companion)]

이 광고와 함께 표시될 수 있는 컴패니언(선택사항)입니다.
interactive_file object(InteractiveFile)

광고 재생 중에 표시되어야 하는 선택적 양방향 광고 소재 (SIMID)입니다.

MatchOpts

MatchOpts는 스트림의 엄격한 미디어 일치 요구사항을 지정합니다.
JSON 표현
{
  "audio_channels": boolean,
  "audio_sample_rate": boolean,
}
필드
audio_channels boolean

콘텐츠와 광고 간 오디오 채널을 일치시킵니다.
audio_sample_rate boolean

콘텐츠와 광고 간 오디오 샘플링 레이트가 일치해야 합니다.

CreateStreamRequest

CreateStreamRequest는 VOD 포드 서비스 API에 대한 HTTP 요청에서 찾은 정보를 설명합니다. 스트림 생성은 SDK와 게시자를 대신하여 VTP (동영상 기술 파트너)에 의해 모든 사용자에 대해 시작됩니다. 생성된 스트림으로 인해 VTP가 스티칭할 결정된 광고 모음이 생성됩니다. 이는 스트림을 등록하고 여러 요청에서 광고 애드팟을 결정하는 StreamRegistrationRequest+AdPodDecisionRequest 흐름과 대조됩니다.
JSON 표현
{
  "encoding_profiles": [object(EncodingProfile)],
  "ad_tag": string,
  "cuepoints": [],
  "manifest_type": string,
  "enable_hls_asset_list": boolean,
  "targeting_parameters": map[string, string],
  "content_duration_seconds": number,
  "decision_timing_options": object(DecisionTimingOptions),
  "enable_inline_manifests": boolean,
  "dai_options": object(CreateStreamOptions),
}
필드
encoding_profiles [object(EncodingProfile)]

인코딩 프로필 목록입니다. 필수입니다.
ad_tag string

결정을 위한 기본 광고 태그입니다. 필수입니다.
cuepoints number

큐 포인트 목록(초 단위)입니다. 광고 태그의 응답이 위치 시간 오프셋을 사용하는 경우 필요합니다.
manifest_type string

유효한 매니페스트 유형은 hls와 dash입니다. 기본값: hls 선택사항입니다.
enable_hls_asset_list boolean

HLS 애셋 목록 인터스티셜이 사용 설정되었는지 나타냅니다. 사용 설정하면 DAI가 각 광고 시점에 대한 애셋 목록 URL을 반환하며, 이는 HLS 인터스티셜에 사용할 수 있습니다.
targeting_parameters string

추가 Ad Manager 타겟팅 매개변수입니다. 선택사항입니다.
content_duration_seconds number

ContentDurationSeconds는 콘텐츠의 길이(초)입니다. 광고 태그의 응답에서 백분율 시간 오프셋을 사용하는 경우 필요합니다.
decision_timing_options object(DecisionTimingOptions)

광고 애드팟의 결정을 내려야 하는 시기를 나타냅니다.
enable_inline_manifests boolean

중단 매니페스트가 JSON 응답에 인라인되어야 하는지 여부를 나타냅니다.
dai_options object(CreateStreamOptions)

스트림 생성의 DAIOptions입니다.

CreateStreamOptions

CreateStreamOptions는 원스텝 스트림 생성 워크플로에서 사용할 수 있는 옵션을 나타냅니다.
JSON 표현
{
  "dash_profile": string,
  "match_options": object(MatchOpts),
  "data_sharing_policy_code": string,
  "sam_id": string,
  "session_title": string,
  "dash_inband_event_stream": boolean,
  "distinct_ad_profiles": boolean,
  "tracking_mode": string,
  "emsg_version": uint32,
}
필드
dash_profile string

사용할 MPEG-DASH 프로필입니다('live' 또는 'on-demand').
match_options object(MatchOpts)

data_sharing_policy_code string

게시자가 네트워크 기본 데이터 공유 정책을 재정의할 수 있습니다.
sam_id string

sam_id는 세션의 SAM 디버그 키입니다(선택사항).
session_title string

session_title은 스트림의 SAM 세션 제목으로, 선택사항입니다.
dash_inband_event_stream boolean

dash_inband_event_stream은 DAI가 InbandEventStream 요소를 사용하여 ID3 메시지를 EventStream 요소 (매니페스트 내)가 아닌 인밴드 이벤트 (미디어 내)로 삽입함을 나타냅니다.
distinct_ad_profiles boolean

true로 설정되면 서버가 요청된 인코딩 프로필을 일치시킬 때 사용 가능한 광고 프로필을 최대 한 번 사용함을 나타냅니다.
tracking_mode string

tracking_mode는 스트림에 사용할 광고 추적 유형입니다(선택사항). 유효한 값은 'ad_media', 'server', 'client'입니다.
emsg_version uint32

emsg_version은 미디어 내 ID3에 특정 emsg 버전을 사용하도록 강제합니다. dash_inband_event_stream이 true인 경우에만 지원됩니다.

StreamRegistrationRequest

StreamRegistrationRequest는 향후 광고 애드팟 결정을 위해 기기에서 스트림을 등록합니다. 이는 단일 요청에서 스트림을 만들고 광고 애드팟을 결정하는 CreateStreamRequest와는 대조적입니다.
JSON 표현
{
  "targeting_parameters": map[string, string],
  "dai_options": object(StreamRegistrationOptions),
}
필드
targeting_parameters string

추가 Ad Manager 타겟팅 매개변수입니다. 선택사항입니다.
dai_options object(StreamRegistrationOptions)

스트림 등록을 위한 DAIOptions

StreamRegistrationOptions

StreamRegistrationOptions는 스트림 생성에 사용할 수 있는 옵션을 나열합니다.
JSON 표현
{
  "sam_id": string,
  "tracking_mode": string,
  "emsg_version": uint32,
  "skippable_ads_supported": boolean,
}
필드
sam_id string

sam_id는 세션의 SAM 디버그 키입니다(선택사항).
tracking_mode string

tracking_mode는 스트림에 사용할 광고 추적 유형입니다(선택사항). 유효한 값은 'ad_media', 'server', 'client'입니다.
emsg_version uint32

emsg_version은 미디어 내 ID3에 특정 emsg 버전을 사용하도록 강제합니다. dash_inband_event_stream이 true인 경우에만 지원됩니다.
skippable_ads_supported boolean

건너뛸 수 있는 광고가 지원되는지 나타냅니다.

StreamRegistrationResponse

StreamRegistrationResponse는 StreamRegistrationRequest에 대한 응답으로 클라이언트에 다시 전송되는 json 응답을 나타냅니다. 여기에는 스트림 ID와 기기에 필요한 모든 URL이 포함됩니다. 스트림 ID는 후속 광고 애드팟 결정 요청에서 참조할 수 있습니다. 이는 스트림을 만들고 동시에 광고 애드팟을 결정하는 응답을 나타내는 CreateStreamResponse와 대조됩니다.
JSON 표현
{
  "stream_id": string,
  "media_verification_url": string,
  "valid_for": string,
  "valid_until": string,
  "metadata_url": string,
}
필드
stream_id string

StreamID는 이 시청자의 현재 스트림에 대한 고유 식별자입니다.
media_verification_url string

MediaVerificationURL은 아래에 설명된 광고 미디어 확인 요청에 사용되는 URL 접두사입니다. 클라이언트 측 비커닝 스트림에는 없습니다.
valid_for string

ValidFor는 이 스트림이 유효한 기간으로, '00h00m00s' 형식입니다.
valid_until string

ValidUntil은 이 스트림이 유효한 날짜와 시간입니다.
metadata_url string

MetadataURL은 광고 모음 메타데이터를 요청하는 데 사용되는 메타데이터 URL입니다.

DecisionTimingOptions

DecisionTimingOptions는 스트림의 광고 시점을 결정하는 타이밍 옵션을 설명합니다.
JSON 표현
{
  "type": string,
  "on_create_breaks": [],
}
필드
type string

Type은 스트림의 광고 애드팟이 결정되는 시점을 설명합니다. 유효한 유형은 on_create (기본값), on_demand입니다. 유형이 on_demand인 경우 특정 광고 구간의 매니페스트가 요청될 때 광고가 지연 결정됩니다. 유형이 on_create인 경우 스트림이 생성될 때 모든 광고가 결정됩니다.
on_create_breaks string

OnCreateBreaks는 스트림 생성 시 결정되어야 하는 대소문자를 구분하는 VMAP breakID의 목록입니다. 이 필드는 유형이 on_demand인 경우에만 허용됩니다. 특수 광고 시점 식별자 'preroll' 및 'postroll'은 스트림 생성 시 프리롤 또는 포스트롤 시점을 결정해야 함을 나타내는 데 사용할 수 있습니다.

EncodingProfile

EncodingProfile은 단일 콘텐츠 변형의 인코딩을 설명합니다. 동영상 설정만, 오디오 설정만 (미디어 유형의 경우), 동영상 및 오디오 설정 모두 또는 자막의 경우 둘 다 포함하지 않을 수 있습니다.
JSON 표현
{
  "profile_name": string,
  "type": string,
  "container_type": string,
  "video_settings": object(VideoSettings),
  "audio_settings": object(AudioSettings),
  "subtitle_settings": object(SubtitleSettings),
}
필드
profile_name string

프로필에 대해 게시자가 제공한 이름입니다. 스트림별로 고유합니다. 필수입니다.
type string

유효한 유형은 media, iframe, subtitles입니다. 필수입니다.
container_type string

유효한 유형은 mpeg2ts, fmp4cmaf, hls_packed_audio입니다. Type media 및 iframe에 필요합니다.
video_settings object(VideoSettings)

컨테이너 유형이 iframe인 경우 동영상 설정이 필요합니다. 그렇지 않으면 프로필에 동영상이 포함된 경우에만 표시됩니다.
audio_settings object(AudioSettings)

프로필에 오디오가 포함된 경우 오디오 설정이 있습니다. 오디오 설정은 컨테이너 유형이 미디어인 경우에만 허용됩니다.
subtitle_settings object(SubtitleSettings)

자막 유형에 자막 설정이 필요합니다.

VideoSettings

VideoSettings는 인코딩 프로필의 동영상을 설명합니다. 동영상 설정이 하나라도 있으면 모두 있어야 합니다.
JSON 표현
{
  "codec": string,
  "bitrate": int32,
  "frames_per_second": number,
  "resolution": object(Resolution),
}
필드
codec string

동영상의 RFC6381 코덱 문자열입니다.
bitrate int32

인코딩 프로필의 최대 동영상 비트 전송률입니다.
frames_per_second number

동영상의 초당 프레임 수입니다.
resolution object(Resolution)

동영상의 너비 x 높이 해상도입니다.

AudioSettings

AudioSettings는 인코딩 프로필의 오디오를 설명합니다. 오디오 설정이 하나 있으면 모두 있어야 합니다.
JSON 표현
{
  "codec": string,
  "bitrate": int32,
  "channels": int32,
  "sample_rate": int64,
}
필드
codec string

오디오의 RFC6381 코덱 문자열입니다.
bitrate int32

인코딩 프로필의 최대 오디오 비트 전송률입니다.
channels int32

오디오 채널 수 (저주파수 채널 포함)
sample_rate int64

오디오의 샘플링 레이트(Hz)입니다.

SubtitleSettings

SubtitleSettings는 인코딩 프로필의 자막을 설명합니다.
JSON 표현
{
  "format": string,
  "language": string,
}
필드
format string

자막 형식: hls의 경우 webvtt, dash의 경우 webvtt 또는 ttml
language string

매니페스트에 삽입할 언어입니다.

해상도

해상도는 동영상의 너비 x 높이를 설명합니다.
JSON 표현
{
  "width": int32,
  "height": int32,
}
필드
width int32

동영상의 너비(단위: 픽셀)입니다. 필수입니다.
height int32

동영상의 높이(픽셀)입니다. 필수입니다.

AdPodDecisionRequest

AdPodDecisionRequest는 이전에 등록된 스트림의 광고 모음을 결정하기 위한 요청을 나타냅니다.
JSON 표현
{
  "encoding_profiles": [object(EncodingProfile)],
  "ad_tag": string,
  "cuepoints": [],
  "manifest_type": string,
  "enable_hls_asset_list": boolean,
  "targeting_parameters": map[string, string],
  "content_duration_seconds": number,
  "decision_timing_options": object(DecisionTimingOptions),
  "enable_inline_manifests": boolean,
  "dai_options": object(AdPodDecisionOptions),
}
필드
encoding_profiles [object(EncodingProfile)]

인코딩 프로필 목록입니다. 필수입니다.
ad_tag string

결정을 위한 기본 광고 태그입니다. 필수입니다.
cuepoints number

큐 포인트 목록(초 단위)입니다. 광고 태그의 응답이 위치 시간 오프셋을 사용하는 경우 필요합니다.
manifest_type string

유효한 매니페스트 유형은 hls와 dash입니다. 기본값: hls 선택사항입니다.
enable_hls_asset_list boolean

HLS 애셋 목록 인터스티셜이 사용 설정되었는지 나타냅니다. 사용 설정하면 DAI가 각 광고 시점에 대한 애셋 목록 URL을 반환하며, 이는 HLS 인터스티셜에 사용할 수 있습니다.
targeting_parameters string

추가 Ad Manager 타겟팅 매개변수입니다. 선택사항입니다.
content_duration_seconds number

ContentDurationSeconds는 콘텐츠의 길이(초)입니다. 광고 태그의 응답에서 백분율 시간 오프셋을 사용하는 경우 필요합니다.
decision_timing_options object(DecisionTimingOptions)

광고 애드팟의 결정을 내려야 하는 시기를 나타냅니다.
enable_inline_manifests boolean

중단 매니페스트가 JSON 응답에 인라인되어야 하는지 여부를 나타냅니다.
dai_options object(AdPodDecisionOptions)

광고 모음 결정을 위한 DAIOptions입니다.

AdPodDecisionResponse

AdPodDecisionResponse는 이전에 등록된 스트림의 광고 모음을 결정하기 위한 응답을 나타냅니다. 해당 스트림에 대해 결정된 광고 애드팟 목록이 포함됩니다.
JSON 표현
{
  "valid_for": string,
  "valid_until": string,
  "ad_pods": [object(AdPod)],
}
필드
valid_for string

ValidFor는 이 스트림이 유효한 기간으로, '00h00m00s' 형식입니다.
valid_until string

ValidUntil은 이 스트림이 유효한 날짜와 시간입니다.
ad_pods [object(AdPod)]

삽입 순서대로 정렬된 광고 애드팟 목록입니다.

CreateStreamResponse

CreateStreamResponse는 CreateStreamRequest에 대한 응답으로 클라이언트에 다시 전송되는 json 응답을 나타냅니다.
JSON 표현
{
  "valid_for": string,
  "valid_until": string,
  "ad_pods": [object(AdPod)],
  "stream_id": string,
  "media_verification_url": string,
  "pod_metadata": object(PodMetadata),
  "metadata_url": string,
}
필드
valid_for string

ValidFor는 이 스트림이 유효한 기간으로, '00h00m00s' 형식입니다.
valid_until string

ValidUntil은 이 스트림이 유효한 날짜와 시간입니다.
ad_pods [object(AdPod)]

삽입 순서대로 정렬된 광고 애드팟 목록입니다.
stream_id string

StreamID는 이 시청자의 현재 스트림에 대한 고유 식별자입니다.
media_verification_url string

MediaVerificationURL은 아래에 설명된 광고 미디어 확인 요청에 사용되는 URL 접두사입니다. 클라이언트 측 비커닝 스트림에는 없습니다.
pod_metadata object(PodMetadata)

PodMetadata에는 기기에서 포드를 렌더링하고 확인을 트리거하는 데 필요한 추가 정보가 포함됩니다. 동적 광고 삽입 선형 API 문서에 설명된 대로 클라이언트 측 비커닝 스트림에만 포함됩니다.
metadata_url string

MetadataURL은 광고 모음 메타데이터를 요청하는 데 사용되는 메타데이터 URL입니다.

AdPod

AdPod는 재생 준비가 완료된 결정된 광고 시점을 나타냅니다.
JSON 표현
{
  "manifest_uris": map[string, string],
  "multivariant_uri": string,
  "mpd_uri": string,
  "manifests": map[string, string],
  "multivariant_manifest": string,
  "mpd_manifest": string,
  "asset_list_uri": string,
  "start": number,
  "duration": number,
  "type": string,
  "midroll_index": number,
}
필드
manifest_uris string

ManifestURIs는 HLS 콘텐츠의 인코딩 프로필 이름과 HLS 변형 manifest_uris의 맵입니다.
multivariant_uri string

MultivariantURI는 HLS 콘텐츠의 다중 변형 매니페스트의 URI입니다.
mpd_uri string

MPDURI는 DASH 콘텐츠의 MPD URI입니다.
manifests string

Manifests는 인코딩 프로필 이름과 HLS 변형 매니페스트의 맵입니다. 스트림의 enable_inline_manifests가 true로 설정된 경우에만 채워집니다.
multivariant_manifest string

MultivariantManifest는 HLS 콘텐츠의 다중 변형 매니페스트입니다. 스트림의 enable_inline_manifests가 true로 설정된 경우에만 채워집니다.
mpd_manifest string

MPDManifest는 DASH 콘텐츠의 MPD 매니페스트입니다. 스트림의 enable_inline_manifests가 true로 설정된 경우에만 채워집니다.
asset_list_uri string

AssetListURI는 HLS 콘텐츠의 HLS 광고 애셋 목록의 URI입니다. 스트림에 HLS 애셋 목록 인터스티셜이 사용 설정된 경우에만 채워집니다.
start number

애셋 타임라인에서 광고 모음의 시작 시간입니다(이전 광고 모음은 포함되지 않음)(부동 소수점 초).
duration number

광고 모음의 길이(부동 소수점 초)입니다.
type string

광고 시점 유형입니다.
midroll_index number

VMAP 광고 시간 ID를 기반으로 한 스트림의 미드롤 1 기반 색인입니다. 프리롤 및 포스트롤에서는 생략됩니다.

AdPodDecisionOptions

AdPodDecisionOptions는 스트림의 추가 옵션을 나타냅니다.
JSON 표현
{
  "dash_profile": string,
  "match_options": object(MatchOpts),
  "data_sharing_policy_code": string,
  "sam_id": string,
  "session_title": string,
  "dash_inband_event_stream": boolean,
  "distinct_ad_profiles": boolean,
}
필드
dash_profile string

사용할 MPEG-DASH 프로필입니다('live' 또는 'on-demand').
match_options object(MatchOpts)

data_sharing_policy_code string

게시자가 네트워크 기본 데이터 공유 정책을 재정의할 수 있습니다.
sam_id string

sam_id는 세션의 SAM 디버그 키입니다(선택사항).
session_title string

session_title은 스트림의 SAM 세션 제목으로, 선택사항입니다.
dash_inband_event_stream boolean

dash_inband_event_stream은 DAI가 InbandEventStream 요소를 사용하여 ID3 메시지를 EventStream 요소 (매니페스트 내)가 아닌 인밴드 이벤트 (미디어 내)로 삽입함을 나타냅니다.
distinct_ad_profiles boolean

true로 설정되면 서버가 요청된 인코딩 프로필을 일치시킬 때 사용 가능한 광고 프로필을 최대 한 번 사용함을 나타냅니다.

스트림

스트림은 새로 생성된 스트림의 모든 리소스 목록을 JSON 형식으로 렌더링하는 데 사용됩니다 .
JSON 표현
{
  "stream_id": string,
  "valid_for": string,
  "valid_until": string,
  "media_verification_url": string,
}
필드
stream_id string

스트림 식별자입니다.
valid_for string

스트림이 유효한 기간입니다('00h00m00s' 형식).
valid_until string

스트림이 유효한 날짜입니다(RFC 3339 형식).
media_verification_url string

미디어 확인 URL입니다.

아이콘

아이콘에는 VAST 아이콘에 관한 정보가 포함됩니다.
JSON 표현
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
필드
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

ClickData에는 아이콘 클릭연결에 관한 정보가 포함됩니다.
JSON 표현
{
  "url": string,
}
필드
url string

FallbackImage

FallbackImage에는 VAST 대체 이미지에 관한 정보가 포함됩니다.
JSON 표현
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
필드
creative_type string

height int32

width int32

resource string

alt_text string

래퍼

래퍼에는 래퍼 광고에 관한 정보가 포함됩니다. 존재하지 않는 경우 거래 ID는 포함되지 않습니다.
JSON 표현
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
필드
system string

광고 시스템 식별자입니다.
ad_id string

래퍼 광고에 사용되는 광고 ID입니다.
creative_id string

래퍼 광고에 사용된 광고 소재 ID입니다.
creative_ad_id string

래퍼 광고에 사용되는 광고 소재 광고 ID입니다.
deal_id string

래퍼 광고의 선택적 거래 ID입니다.

인증

인증에는 서드 파티 조회가능성 및 인증 측정을 용이하게 하는 Open Measurement 정보가 포함되어 있습니다. 현재는 JavaScript 리소스만 지원됩니다. https://iabtechlab.com/standards/open-measurement-sdk/를 참고하세요.
JSON 표현
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
필드
vendor string

인증 공급업체입니다.
java_script_resources [object(JavaScriptResource)]

확인을 위한 JavaScript 리소스 목록입니다.
tracking_events [object(TrackingEvent)]

인증의 추적 이벤트 목록입니다.
parameters string

부트스트랩 인증 코드에 전달되는 불투명 문자열입니다.

자바스크립트 리소스

JavaScriptResource에는 JavaScript를 통한 확인 정보가 포함됩니다.
JSON 표현
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
필드
script_url string

JavaScript 페이로드의 URI
api_framework string

APIFramework는 확인 코드를 실행하는 동영상 프레임워크의 이름입니다.
browser_optional boolean

이 스크립트를 브라우저 외부에서 실행할 수 있는지 여부입니다.

TrackingEvent

TrackingEvent에는 특정 상황에서 클라이언트가 핑해야 하는 URL이 포함되어 있습니다.
JSON 표현
{
  "event": string,
  "uri": string,
}
필드
event string

추적 이벤트의 유형입니다.
uri string

핑할 추적 이벤트입니다.

UniversalAdID

UniversalAdID는 광고 시스템 전반에서 유지되는 고유한 광고 소재 식별자를 제공하는 데 사용됩니다.
JSON 표현
{
  "id_value": string,
  "id_registry": string,
}
필드
id_value string

선택한 광고의 광고 소재의 범용 광고 ID입니다.
id_registry string

선택한 광고 소재의 범용 광고 ID가 등록된 등록처 웹사이트의 URL을 식별하는 데 사용되는 문자열입니다.

컴패니언

컴패니언에는 광고와 함께 표시될 수 있는 컴패니언 광고에 관한 정보가 포함됩니다.
JSON 표현
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
필드
click_data object(ClickData)

이 컴패니언의 클릭 데이터입니다.
creative_type string

정적 유형의 동반 광고인 경우 VAST의 <StaticResource> 노드에 있는 CreativeType 속성
height int32

이 컴패니언의 높이(픽셀)입니다.
width int32

이 컴패니언의 너비(픽셀)입니다.
resource string

정적 및 iframe 동반 광고의 경우 로드되고 표시될 URL입니다. HTML 컴패니언의 경우 컴패니언으로 표시되어야 하는 HTML 스니펫입니다.
type string

이 컴패니언의 유형입니다. 정적, iframe 또는 HTML일 수 있습니다.
ad_slot_id string

이 앱의 슬롯 ID입니다.
api_framework string

이 앱의 API 프레임워크입니다.
tracking_events [object(TrackingEvent)]

이 컴패니언의 추적 이벤트 목록입니다.

InteractiveFile

InteractiveFile에는 광고 재생 중에 표시되어야 하는 대화형 광고 소재 (예: SIMID)에 관한 정보가 포함되어 있습니다.
JSON 표현
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
필드
resource string

대화형 광고 소재의 URL입니다.
type string

리소스에 제공된 파일의 MIME 유형입니다.
variable_duration boolean

이 광고 소재가 재생 시간 연장을 요청할 수 있는지 여부입니다.
ad_parameters string

VAST의 <AdParameters> 노드 값입니다.