クライアント側の広告追跡スキーマとプロパティ - AWS Elemental MediaTailor
Schemaプロパティ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

クライアント側の広告追跡スキーマとプロパティ

MediaTailor クライアント側の広告追跡機能を使用すると、詳細なクライアント側の広告追跡データをプレイヤー環境に統合できます。以下のセクションでは、広告追跡スキーマ全体と、スキーマを構成する特定のプロパティと値について説明します。

Schema

次の表に、 MediaTailor クライアント側の広告追跡スキーマを示します。該当する場合、テーブルはスキーマをVASTデータにマッピングします。

キー データ型 子キー 2VAST.0/3.0 からのマッピング 4.0 VAST からのマッピング 説明
レスポンス JSON
- オブジェクト avails, nonLinearAvails
/avails

配列
MediaTailor は、マニフェストウィンドウ内の avail (ad break) ごとに 1 つのオブジェクトを作成します。 ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime
/ads 配列
MediaTailor は、avail 期間内に広告ごとに 1 つのオブジェクトを作成します。 オブジェクト adID、adType、adParameters、adVerifications、companionAds、duration、 durationInSeconds、、extensions、アイコン、mediaFile、startTime、startTimeInSeconds、、 dateTime adBreakTrackingEvents
/adId 文字列

  • HLS - 広告の先頭に関連付けられているシーケンス番号

  • DASH - 広告の期間 ID
/adParameters

文字列

 VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters

プレイヤー MediaTailor に渡VASTVPAIDされる からの広告パラメータの文字列
/adVerifications 配列 VAST/Ad/InLine/AdVerifications

クリエイティブ再生を検証するためにサードパーティーの測定コードを実行するために必要なリソースとメタデータが含まれています。
MediaTailor は、広告検証要素ごとに オブジェクトを作成します。 オブジェクト executableResource、 javaScriptResource、ベンダー、 verificationParameters
/executableResource 配列 VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
MediaTailor は、各executableResource要素のオブジェクトを作成します。 オブジェクト apiFramework、adType、uri、言語
/apiFramework 文字列 VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
/type 文字列
/uri 文字列 VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
/language

文字列

 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

文字列

 VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
/browserOptional 文字列 VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
/uri 文字列 VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
/trackingEvents

配列
MediaTailor は、広告検証要素の追跡イベントタイプごとに オブジェクトを作成します。 オブジェクト イベント、URI
/event 文字列 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 文字列 VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
/companionAds 配列

広告表示に付随するコンパニオン広告は、広告のフレームやバナーなどのコンテンツを提供して、動画の近くに表示します。
MediaTailor は、Companion-ad 要素ごとに オブジェクトを作成します。 オブジェクト adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents VAST/Ad/InLine/Creatives/Creative/CompanionAds
/adParameters 文字列
/altText 文字列
/attributes

オブジェクト

 adSlotId、apiFramework、assetHeight、assetWidth、expandedHeight、expandedWidthheight、、id、pxratio、renderingMode、 width
/adSlotId 文字列 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

文字列

 VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource
/trackingEvents

配列

 VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents

MediaTailor は、Companion-ad 要素追跡イベントタイプごとに オブジェクトを作成します。
/tracking

オブジェクト

 >event、uri
/event

文字列

 VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
/uri 文字列 VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
/duration 文字列

8601 ISO 秒形式の長さ
/durationInSeconds 数

長さ、秒形式
/extensions 配列

広告サーバーはカスタムVAST拡張機能を使用できます

MediaTailor は、 extensions要素の子拡張ごとに オブジェクトを作成します。

 VAST/Ad/InLine/Extensions
/extension オブジェクト タイプ、コンテンツ VAST/Ad/InLine/Extensions/Extension
/type 文字列 VAST/Ad/InLine/Extensions/Extension/@type
/content 文字列
/icons 配列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons

MediaTailor は、 内の各icon要素のオブジェクトを作成しますicons。

 オブジェクト 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 文字列 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 文字列
/durationInSeconds 数
/htmlResource 文字列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
/iconClicks 文字列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
/iconClickThrough 文字列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
/iconClickTracking オブジェクト id VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
/id 文字列
/iconClickFallbackImages 配列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages

MediaTailor は、アイコンクリックフォールバックイメージノードごとにオブジェクトを作成します。
/altText 文字列 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 文字列 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 文字列 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 文字列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
/statidResource オブジェクト creativeType、URI VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
/creativeType 文字列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
/uri 文字列 VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
/startTime 文字列
/startTimeInSeconds 数
/mediaFiles オブジェクト adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents

プレイヤーが ad avail に必要な動画やその他のアセット
/adParameters 文字列
/duration 文字列
/durationInSeconds 数
/mediaFilesList 配列

MediaTailor は、Companion-ad 要素追跡イベントタイプごとに オブジェクトを作成します。

 apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width
/apiFramework 文字列
/delivery 文字列
/height 文字列
/maintainAspectRatio 文字列
/mediaFileUri 文字列
/mediaType 文字列
/scalable 文字列
/width 文字列
/mezzanine 文字列
/startTime 文字列
/startTimeInSeconds 文字列
/trackingEvents 配列

MediaTailor は、クリエイティブの追跡イベントごとに オブジェクトを作成します。

 beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds
/beaconUrls 配列

URLs このイベントのすべての追跡のカンマ区切りリスト
/duration 文字列
/durationInSeconds 数
/dateTime 文字列
/eventId 文字列
/eventType 文字列
/startTime 文字列
/startTimeInSeconds 数
/startTime 文字列

再生セッションの開始を基準にした ISO8601 秒形式の時間位置
/startTimeInSeconds 数

再生セッションの開始を基準にした秒形式の時間位置
/dateTime 文字列

ad avail ISO の開始時刻を 8601 秒形式でプログラムする日時
/trackingEvents 配列

VAST レスポンスで受信したすべての追跡イベントデータとタイミング情報が含まれます。
/adType 文字列
/availId 文字列
/dateTime 文字列
/duration 文字列
/durationInSeconds 数
/startTime 文字列
/startTimeInSeconds 数

プロパティ

次の表に、クライアント側の追跡 のプロパティAPI、それらの定義、値タイプ、および例を示します。

プロパティ 定義 値のタイプ 例
adID

  • HLS - 広告の先頭に関連付けられているシーケンス番号

  • DASH - 広告の期間 ID

 文字列 10
adBreakTrackingEvents

VAST レスポンスの追跡VMAPイベントを保持する配列。詳細については、1.VMAP0 仕様 のセクション 2.3.3 を参照してください。

 文字列 []
adMarkerDuration

マニフェストの広告マーカーから観測された avail 期間。

 文字列 30
adParameters

プレイヤー MediaTailor に渡VPAIDされる、 VAST からの広告パラメータの文字列。

 文字列
adProgramDateTime

  • HLS - 広告の最初のメディアシーケンスを表す ISO/IEC8601:2004 形式の日付。

  • DASH -

文字列
ads

avail を構成する広告オブジェクトを含む配列。広告は、マニフェストに表示される順序で一覧表示されます。

 配列 []
adSystem

広告を提供するシステムの名前。

重要

必ず値を指定してください。値を指定しないと、問題が発生する可能性があります。

 文字列 myADS
adTitle

広告のタイトル。

 文字列 ad1
adVerifications

クリエイティブ再生を検証するためにサードパーティーの測定コードを実行するために必要なリソースとメタデータが含まれています。このプロパティの詳細については、4.VAST2 仕様 のセクション 3.16 を参照してください。

MediaTailor は 3 VAST つの拡張ノードadVerificationsとして をサポートします。

 配列 []
altText

コンパニオン広告のイメージの代替テキスト。このテキストにより、視覚障害者が画像の説明を読み返すための記述的オーディオサポートを持つプレイヤーが可能になります。

 文字列 video sequence advertising sneakers
attributes

、、 などadSlotId、コンパニオン広告のVAST仕様で定義されているキーpxratiorenderingModeが含まれます。

 オブジェクト {}
apiFramework

この広告がVPAID広告であることをプレイヤーに伝えるには、 VPAIDに設定します。

 文字列 VPAID
availID

  • HLS - ad avail の開始に関連付けられたシーケンス番号。

  • DASH - ad avail の期間 ID。通常は、広告に置き換えられるコンテンツの期間 ID です。

 文字列

  • 34

  • PT34S_1

avails

アクティブなマニフェストウィンドウに表示される広告ブレークオブジェクト、または avails を含む配列。avail はマニフェストに表示される順序で一覧表示されます。

 配列 []
beaconUrls

URL が広告ビーコン MediaTailor を送信する 。

 文字列
bitrate

ビデオアセットのビットレート。このプロパティは通常、実行可能アセットには含まれません。

 文字列 2048
companionAds

1 つ以上のコンパニオン広告コンテンツ仕様。それぞれが使用するリソースファイルを指定します。コンパニオン広告は ad avail に付随し、広告のフレームやバナーなどのコンテンツを提供して、ビデオの近くに表示します。

 配列 []
companionClickThrough

視聴者がコンパニオン広告をクリックしたときにメディアプレーヤーが開く、URLアドバタイザーのページへの 。

 文字列 https://aws.amazon.com/
companionClickTracking

companionClickThrough プロパティURLの追跡。

 文字列 https://myads.com/beaconing/event=clicktracking
creativeId

広告のCreativeタグのId属性値。

 文字列 creative-1
creativeSequence

VAST レスポンスAd@idの値に従って、広告が再生されるシーケンス。

 文字列 1
dashAvailabilityStartTime

ライブ/動的 の場合DASH、オリジンマニフェストMPD@availabilityStartTimeの 。

 文字列 2022-10-05T19:38:39.263Z
delivery

progressive または streamingプロトコルが使用されているかどうかを示します。

 文字列 progressive
duration

8601 ISO 秒形式の長さ。レスポンスには、ad avail 全体と各広告とビーコンの継続時間が含まれますが、ビーコンの継続時間は常にゼロです。

 数 15.015
eventId

  • HLS - ビーコンに関連付けられたシーケンス番号。

  • DASH - 広告ptsTimeの先頭の 。

 文字列 23
eventType

ビーコンのタイプ。

 文字列 impression
extensions

その広告サーバーVASTが使用するカスタム拡張機能。拡張機能の詳細については、4.VAST2 仕様 のセクション 3.18 を参照してください。

 配列 []
height

ビデオアセットの高さをピクセル単位で示します。

 文字列 360
hlsAnchorMediaSequenceNumber

HLS オリジンマニフェストに表示される最初/最も古いメディアシーケンスのメディアシーケンス番号。

 文字列 77
htmlResource

ストリーミングプロバイダーのHTMLページに直接挿入HTMLされる CDATAエンコード。

 文字列 <![CDATA[<!doctype html><html><head><meta name=\"viewport\" content=\"width=1, initial-scale=1.0, minimum-scale=1.0,...]]>
iFrameResource

ストリーミングプロバイダーが iframe にロードする URLHTMLリソースファイルへの 。

 文字列
maintainAspectRatio

スケーリング中にビデオのアスペクト比を維持するかどうかを示します。

 ブール値 true
mediaFilesList

プレイヤーが ad avail に必要な動画やその他のアセットを指定します。

 配列 []
mediaFileUri

URI 実行可能アセットまたはビデオアセットを指す 。

 文字列 https://myad.com/ad/ad134/vpaid.js
mediaType

クリエイティブアセットまたはコンパニオンアセットMIMEのタイプ。

 文字列 video/mp4
meta

mezzanine

VPAID 広告URLにメザニンMP4アセットが含まれている場合に指定されるメザニンアセットの 。

 文字列 https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
nextToken

このような値が存在する場合、結果の次のページを指すトークンの値。

 文字列 UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
nonLinearAds

配列 []
nonLinearAdsList

配列 []
nonLinearAvails

配列
scalable

ビデオを他のディメンションにスケーリングするかどうかを示します。

 ブール値 true
sequence

VAST レスポンスでクリエイティブに指定されたシーケンス値。

 文字列 1
skipOffset

ユーザーがスキップコントロールを使用できるようにするタイミングを識別する時間値。

 文字列 00:00:05
startTime

再生セッションの開始を基準にした 8601 ISO 秒形式の時間位置。レスポンスには、ad avail 全体、および各広告とビーコンの開始時間が含まれます。

 文字列 PT9.943S
startTimeInSeconds

再生セッションの開始を基準にした秒形式の時間位置。レスポンスには、ad avail 全体、および各広告とビーコンの開始時間が含まれます。

 数 9.943
staticResource

広告コンポーネントに使用されるURL静的なクリエイティブファイルへの 。

 文字列 https://very-interactive-ads.com/campaign1/file.json?c=1019113602
vastAdId

Ad タグのId属性値。

 文字列 ad1
width

ビデオアセットの幅をピクセル単位で示します。

 文字列 640