기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
클라이언트측 광고 추적 스키마 및 속성
MediaTailor 클라이언트측 광고 추적 기능을 사용하면 상세한 클라이언트 측 광고 추적 데이터를 플레이어 환경에 통합할 수 있습니다. 다음 섹션에서는 전체 광고 추적 스키마와 스키마를 구성하는 특정 속성 및 값에 대해 설명합니다.
스키마
다음 표는 클라이언트 측 광고 추적 스키마를 설명합니다. MediaTailor 해당하는 경우 표는 스키마를 데이터에 매핑합니다. VAST
| 키 | 데이터 유형 | 하위 키 | VAST2.0/3.0에서의 매핑 | 4.0에서의 매핑 VAST | 설명 |
|---|---|---|---|---|---|
| 응답 JSON | |||||
| - | 객체 | avails, nonLinearAvails | |||
/avails
|
배열 |
||||
| MediaTailor 매니페스트 창 내에서 각 어베일 (광고 브레이크) 에 대해 하나의 객체를 생성합니다. | ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime | ||||
/ads
|
배열 | ||||
| MediaTailor 광고 유효 기간 내의 각 광고에 대해 하나의 객체를 생성합니다. | 객체 | adID,adType,adParameters,adVerifications,companionAds, duration durationInSeconds,extensions,, 아이콘mediaFile,startTime,startTimeInSeconds, dateTime adBreakTrackingEvents | |||
/adId
|
String |
|
|||
/adParameters
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
플레이어로 VAST VPAID MediaTailor 전달되는 광고 파라미터 문자열 |
||
/adVerifications
|
배열 |
VAST/Ad/InLine/AdVerifications
|
창의적인 재생을 확인하기 위해 타사 측정 코드를 실행하는 데 필요한 리소스 및 메타데이터가 포함되어 있습니다. |
||
| MediaTailor 각 광고 검증 요소에 대한 개체를 만듭니다. | 객체 | executableResource,, 공급업체 javaScriptResource, verificationParameters | |||
/executableResource
|
배열 |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor 각 executableResource 요소에 대해 객체를 생성합니다. |
객체 | apiFramework,adType, uri, 언어 | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
문자열 | ||||
/uri
|
문자열 |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
배열 |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor 각 javaScriptResource 요소에 대해 객체를 생성합니다. |
객체 | apiFramework,browserOptional, uri | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
문자열 |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
배열 |
||||
| MediaTailor 각 광고 검증 요소 추적 이벤트 유형에 대한 객체를 생성합니다. | 객체 | 이벤트, uri | |||
/event
|
String |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
문자열 |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
문자열 |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
String |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
배열 |
광고 혜택과 함께 제공되는 컴패니언 광고는 광고 주위의 프레임이나 동영상 근처에 표시할 배너와 같은 콘텐츠를 제공합니다. |
|||
| MediaTailor 각 컴패니언 광고 요소에 대해 객체를 생성합니다. | 객체 | adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
String | ||||
/altText
|
String | ||||
/attributes
|
객체 |
adSlotId,,apiFramework,assetHeight,,assetWidth,,expandedHeight, id expandedWidthheight, pxratio, renderingMode width | |||
/adSlotId
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
문자열 |
||||
/renderingMode
|
문자열 |
||||
/width
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
문자열 |
||||
/staticResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
배열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
|
MediaTailor 각 컴패니언 광고 요소 추적 이벤트 유형에 대해 객체를 만듭니다. |
|||||
/tracking
|
객체 |
>이벤트, uri | |||
/event
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
String |
길이, ISO 8601초 형식 |
|||
/durationInSeconds
|
숫자 |
길이 (초 단위) |
|||
/extensions
|
배열 |
광고 서버는 맞춤 VAST 확장 프로그램을 사용할 수 있습니다. |
|||
|
MediaTailor |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
객체 | 유형, 내용 |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
String |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
String | ||||
/icons
|
배열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
|
MediaTailor 안에 있는 각 |
객체 | attributes, dateTime, duration, durationInSeconds, htmlResource, iconClicks, iconViewTracking, iFrameResource, staticResource, startTime, startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
객체 | apiFramework,duration,height, 오프셋, 프로그램, pxratio, width xPosition yPosition | |||
/apiFramework
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
문자열 | ||||
/duration
|
String | ||||
/durationInSeconds
|
숫자 | ||||
/htmlResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
객체 | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
String | ||||
/iconClickFallbackImages
|
배열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
|
MediaTailor 각 아이콘 클릭 폴백 이미지 노드에 대해 개체를 만듭니다. |
|||||
/altText
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@height
|
|||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@width
|
|||
/staticResource
|
객체 | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/@creativeType
|
|||
/uri
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
객체 | creativeType, 유리 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
문자열 |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
String | ||||
/startTimeInSeconds
|
숫자 | ||||
/mediaFiles
|
객체 | adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents |
플레이어가 광고 게재를 위해 필요한 동영상 및 기타 애셋 |
||
/adParameters
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
숫자 | ||||
/mediaFilesList
|
배열 | ||||
|
MediaTailor 각 컴패니언-광고 요소 추적 이벤트 유형에 대한 객체를 생성합니다. |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
String | ||||
/delivery
|
문자열 | ||||
/height
|
문자열 | ||||
/maintainAspectRatio
|
문자열 | ||||
/mediaFileUri
|
문자열 | ||||
/mediaType
|
문자열 | ||||
/scalable
|
문자열 | ||||
/width
|
문자열 | ||||
/mezzanine
|
문자열 | ||||
/startTime
|
문자열 | ||||
/startTimeInSeconds
|
String | ||||
/trackingEvents
|
배열 | ||||
|
MediaTailor 크리에이티브를 위해 각 추적 이벤트에 사용할 개체를 만듭니다. |
beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds | ||||
/beaconUrls
|
배열 | ||||
|
이 이벤트에 대한 모든 추적을 URLs 쉼표로 구분한 목록입니다. |
|||||
/duration
|
String | ||||
/durationInSeconds
|
숫자 | ||||
/dateTime
|
String | ||||
/eventId
|
문자열 | ||||
/eventType
|
문자열 | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
숫자 | ||||
/startTime
|
String |
재생 세션의 시작을 기준으로 한 시간 위치 (ISO8601초 형식) |
|||
/startTimeInSeconds
|
숫자 |
재생 세션의 시작을 기준으로 한 시간 위치 (초 형식) |
|||
/dateTime
|
String |
광고 시작을 위한 프로그램 날짜 시간 (ISO8601초 형식) |
|||
/trackingEvents
|
배열 |
응답에서 수신된 모든 추적 이벤트 데이터를 타이밍 정보와 함께 포함합니다. VAST |
|||
/adType
|
String | ||||
/availId
|
문자열 | ||||
/dateTime
|
문자열 | ||||
/duration
|
String | ||||
/durationInSeconds
|
숫자 | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
숫자 | ||||
속성
다음 표에는 클라이언트 측 추적의 속성, 정의API, 값 유형 및 예제가 나와 있습니다.
| 속성 | 정의 | 값 유형 | 예 |
|---|---|---|---|
adID
|
|
String | 10 |
adBreakTrackingEvents
|
VAST응답의 VMAP 추적 이벤트를 전달하는 배열입니다. 자세한 내용은 VMAP1.0 사양의 |
String |
[]
|
adMarkerDuration
|
매니페스트의 광고 마커에서 관찰한 사용 기간입니다. |
String |
30
|
adParameters
|
에서 가져온 광고 파라미터 문자열로 VASTVPAID, 플레이어에 MediaTailor 전달됩니다. |
String | |
adProgramDateTime
|
|
String | |
ads
|
광고를 구성하는 광고 개체가 포함된 배열입니다. 광고는 매니페스트에 표시된 순서대로 나열됩니다. |
배열 |
[]
|
adSystem
|
광고를 게재하는 시스템의 이름. 중요반드시 값을 입력하세요. 값을 제공하지 않으면 문제가 발생할 수 있습니다. |
String |
myADS
|
adTitle
|
광고 제목. |
String |
ad1
|
adVerifications
|
크리에이티브 재생을 확인하기 위해 타사 측정 코드를 실행하는 데 필요한 리소스 및 메타데이터가 포함되어 있습니다. 이 속성에 대한 자세한 내용은 VAST4.2 사양의 MediaTailor VAST3개의 확장 |
배열 |
[]
|
altText
|
컴패니언 광고 이미지의 대체 텍스트입니다. 시각 장애인을 위한 설명 오디오 지원을 받는 플레이어는 이 텍스트를 통해 이미지에 대한 설명을 다시 읽을 수 있습니다. |
String |
video sequence advertising sneakers
|
attributes
|
컴패니언 광고 VAST 사양에 정의된 키 (예:, |
객체 |
{}
|
apiFramework
|
플레이어에게 이 광고가 VPAID 광고임을 |
String |
VPAID
|
availID
|
|
String |
|
avails
|
활성 매니페스트 창에 표시되는 광고 브레이크 개체 (avas) 를 포함하는 배열입니다. 가용은 매니페스트에 나타나는 순서대로 나열됩니다. |
배열 |
[]
|
beaconUrls
|
URL여기서 광고 비콘을 MediaTailor 전송합니다. |
String | |
bitrate
|
비디오 자산의 비트레이트. 이 속성은 일반적으로 실행 가능한 에셋에 포함되지 않습니다. |
String |
2048
|
companionAds
|
하나 이상의 보조 광고 콘텐츠 사양. 각 사양에는 사용할 리소스 파일이 지정되어 있습니다. 컴패니언 광고는 광고 혜택과 함께 제공되며 광고 주위의 프레임이나 배너 등 동영상 근처에 표시할 콘텐츠를 제공합니다. |
배열 |
[]
|
companionClickThrough
|
시청자가 URL 컴패니언 광고를 클릭할 때 미디어 플레이어가 여는 광고주 페이지를 나타냅니다. |
String |
https://aws.amazon.com/
|
companionClickTracking
|
속성에 URL |
String |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
광고용 |
String |
creative-1
|
creativeSequence
|
VAST응답의 |
String |
1
|
dashAvailabilityStartTime
|
|
String |
2022-10-05T19:38:39.263Z
|
delivery
|
|
String |
progressive
|
duration
|
길이 (ISO8601초 형식) 응답에는 전체 광고 사용 기간과 각 광고 및 비콘의 지속 시간이 포함되지만 비콘 지속 시간은 항상 0입니다. |
숫자 |
15.015
|
eventId
|
|
String |
23
|
eventType
|
비콘의 종류. |
String |
impression
|
extensions
|
VAST해당 광고 서버가 사용하는 맞춤 확장 프로그램 확장 프로그램에 대한 자세한 내용은 VAST4.2 사양의 |
배열 |
[]
|
height
|
비디오 에셋의 높이 (픽셀 단위). |
String |
360
|
hlsAnchorMediaSequenceNumber
|
오리진 매니페스트에 표시된 첫 번째/가장 오래된 미디어 시퀀스의 미디어 시퀀스 번호입니다. HLS |
String |
77
|
htmlResource
|
스트리밍 제공업체 페이지에 직접 HTML 삽입되는 CDATA -encoded. HTML |
String |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
스트리밍 공급자가 iframe에 로드하는 HTML 리소스 파일입니다. URL |
String | |
maintainAspectRatio
|
스케일링 중에 비디오의 가로 세로 비율을 유지할지 여부를 나타냅니다. |
불 |
true
|
mediaFilesList
|
플레이어가 광고를 게재하는 데 필요한 비디오 및 기타 에셋을 지정합니다. |
배열 |
[]
|
mediaFileUri
|
URI이는 실행 가능한 에셋 또는 비디오 에셋을 가리킵니다. |
String |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
크리에이티브 또는 컴패니언 에셋의 MIME 유형. |
String |
video/mp4
|
meta
|
|||
mezzanine
|
메자닌 URL 에셋의 것으로, VPAID 광고에 메자닌 MP4 에셋이 포함된 경우 지정됩니다. |
String |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
해당 값이 존재할 경우 결과의 다음 페이지로 연결되는 토큰의 가치입니다. |
String |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
배열 |
[]
|
|
nonLinearAdsList
|
배열 |
[]
|
|
nonLinearAvails
|
배열 | ||
scalable
|
비디오를 다른 크기로 확대할지 여부를 나타냅니다. |
불 |
true
|
sequence
|
VAST응답에서 크리에이티브에 대해 지정된 시퀀스 값입니다. |
String |
1
|
skipOffset
|
플레이어가 사용자가 스킵 컨트롤을 사용할 수 있게 하는 시기를 식별하는 시간 값입니다. |
String |
00:00:05
|
startTime
|
재생 세션의 시작을 기준으로 한 시간 위치 (ISO8601초 형식) 응답에는 전체 광고 시간과 각 광고 및 비콘에 대한 시작 시간이 포함됩니다. |
String |
PT9.943S
|
startTimeInSeconds
|
재생 세션의 시작을 기준으로 한 시간 위치 (초 형식). 응답에는 전체 광고 시간과 각 광고 및 비콘에 대한 시작 시간이 포함됩니다. |
숫자 |
9.943
|
staticResource
|
광고 구성 요소에 사용되는 정적 크리에이티브 파일에 대한 것입니다. URL |
String |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
|
String |
ad1
|
width
|
비디오 에셋의 너비 (픽셀 단위). |
String |
640
|
