Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Schema und Eigenschaften für das clientseitige Ad-Tracking
Mit der MediaTailor clientseitigen Ad-Tracking-Funktion können Sie detaillierte clientseitige Ad-Tracking-Daten in Ihre Player-Umgebung integrieren. In den folgenden Abschnitten werden das allgemeine Ad-Tracking-Schema sowie die spezifischen Eigenschaften und Werte behandelt, aus denen sich das Schema zusammensetzt.
Inhalt
Schema
In der folgenden Tabelle wird das MediaTailor clientseitige Ad-Tracking-Schema beschrieben. Gegebenenfalls ordnet die Tabelle das Schema den Daten zu. VAST
| Schlüssel | Datentyp | Schlüssel für Kinder | Zuordnung ab VAST 2.0/3.0 | Kartierung ab 4.0 VAST | Beschreibung |
|---|---|---|---|---|---|
| Antwort JSON | |||||
| - | Object | avails, nonLinearAvails | |||
/avails
|
Array |
||||
| MediaTailor erstellt ein Objekt für jeden Avail (Ad-Break) innerhalb des Manifestfensters. | ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime | ||||
/ads
|
Array | ||||
| MediaTailor erstellt für jede Anzeige innerhalb des Verfügbarkeitszeitraums ein Objekt. | Object | adID,adType,adParameters,adVerifications,companionAds,duration, durationInSeconds, Symboleextensions,,mediaFile,startTime,startTimeInSeconds, dateTime adBreakTrackingEvents | |||
/adId
|
String |
|
|||
/adParameters
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
Eine Reihe von Anzeigenparametern von VASTVPAID, die MediaTailor an den Player übergeben werden |
||
/adVerifications
|
Array |
VAST/Ad/InLine/AdVerifications
|
Enthält die Ressourcen und Metadaten, die für die Ausführung von Messcode eines Drittanbieters erforderlich sind, um die kreative Wiedergabe zu überprüfen |
||
| MediaTailor erstellt ein Objekt für jedes Element zur Anzeigenverifizierung. | Object | executableResource, javaScriptResource, Anbieter, verificationParameters | |||
/executableResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor erstellt für jedes executableResource Element ein Objekt. |
Object | apiFrameworkadType, URI, Sprache | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
Zeichenfolge | ||||
/uri
|
Zeichenfolge |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor erstellt für jedes javaScriptResource Element ein Objekt. |
Object | apiFramework,browserOptional, uri | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
Zeichenfolge |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
Array |
||||
| MediaTailor erstellt ein Objekt für jeden Tracking-Ereignistyp eines Elements zur Anzeigenverifizierung. | Object | Ereignis, URI | |||
/event
|
String |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
Zeichenfolge |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
Zeichenfolge |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
String |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
Array |
Begleitanzeigen, die die Anzeige begleiten, bieten Inhalte wie einen Rahmen um die Anzeige oder ein Banner, das in der Nähe des Videos angezeigt wird. |
|||
| MediaTailor erstellt für jedes Begleitanzeigenelement ein Objekt. | Object | adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
String | ||||
/altText
|
String | ||||
/attributes
|
Object |
adSlotId,apiFramework,,assetHeight,assetWidth,expandedHeight, id expandedWidthheight, pxratio, renderingMode width | |||
/adSlotId
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
Zeichenfolge |
||||
/renderingMode
|
Zeichenfolge |
||||
/width
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
Zeichenfolge |
||||
/staticResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
Array |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
|
MediaTailor erstellt ein Objekt für jeden Ereignistyp zur Erfassung von Begleitanzeigen-Elementen. |
|||||
/tracking
|
Object |
>Ereignis, URI | |||
/event
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
String |
Länge im ISO 8601-Sekunden-Format |
|||
/durationInSeconds
|
Zahl |
Länge im Sekundenformat |
|||
/extensions
|
Array |
Werbeserver können benutzerdefinierte VAST Erweiterungen verwenden |
|||
|
MediaTailor erstellt ein Objekt für jede untergeordnete Erweiterung des |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
Object | Typ, Inhalt |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
String |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
String | ||||
/icons
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
|
MediaTailor erstellt ein Objekt für jedes |
Object | attributes, dateTime, duration, durationInSeconds, htmlResource, iconClicks, iconViewTracking, iFrameResource, staticResource, startTime, startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
Object | apiFramework, durationheight, Offset, Programm, pxratio,,width, xPosition yPosition | |||
/apiFramework
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
Zeichenfolge | ||||
/duration
|
String | ||||
/durationInSeconds
|
Zahl | ||||
/htmlResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
Object | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
String | ||||
/iconClickFallbackImages
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
|
MediaTailor erstellt ein Objekt für jeden Icon-Click-Fallback-Image-Knoten. |
|||||
/altText
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
Zeichenfolge |
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
|
Object | 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
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
Object | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
Zeichenfolge |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
String | ||||
/startTimeInSeconds
|
Zahl | ||||
/mediaFiles
|
Object | adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents |
Video und andere Ressourcen, die der Spieler für die Anzeige benötigt, stehen zur Verfügung |
||
/adParameters
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Zahl | ||||
/mediaFilesList
|
Array | ||||
|
MediaTailor erstellt ein Objekt für jeden Ereignistyp der Begleitanzeigen-Elementverfolgung |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
String | ||||
/delivery
|
Zeichenfolge | ||||
/height
|
Zeichenfolge | ||||
/maintainAspectRatio
|
Zeichenfolge | ||||
/mediaFileUri
|
Zeichenfolge | ||||
/mediaType
|
Zeichenfolge | ||||
/scalable
|
Zeichenfolge | ||||
/width
|
Zeichenfolge | ||||
/mezzanine
|
Zeichenfolge | ||||
/startTime
|
Zeichenfolge | ||||
/startTimeInSeconds
|
String | ||||
/trackingEvents
|
Array | ||||
|
MediaTailor erstellt für jedes Tracking-Ereignis ein Objekt für das Werbemittel |
beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds | ||||
/beaconUrls
|
Array | ||||
|
Eine durch Kommas getrennte Liste aller Tracking-Aktivitäten URLs für dieses Ereignis |
|||||
/duration
|
String | ||||
/durationInSeconds
|
Zahl | ||||
/dateTime
|
String | ||||
/eventId
|
Zeichenfolge | ||||
/eventType
|
Zeichenfolge | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
Zahl | ||||
/startTime
|
String |
Zeitposition im ISO 8601-Sekunden-Format, relativ zum Beginn der Wiedergabe-Sitzung |
|||
/startTimeInSeconds
|
Zahl |
Zeitposition, im Sekundenformat, relativ zum Beginn der Wiedergabe-Sitzung |
|||
/dateTime
|
String |
Programmdatum und Uhrzeit im ISO 8601-Sekunden-Format für den Start der Anzeige verfügbar |
|||
/trackingEvents
|
Array |
Enthält alle Tracking-Event-Daten, die in der VAST Antwort empfangen wurden, zusammen mit Zeitinformationen |
|||
/adType
|
String | ||||
/availId
|
Zeichenfolge | ||||
/dateTime
|
Zeichenfolge | ||||
/duration
|
String | ||||
/durationInSeconds
|
Zahl | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
Zahl | ||||
Eigenschaften
In der folgenden Tabelle sind die Eigenschaften des clientseitigen TrackingsAPI, ihre Definitionen, Wertetypen und Beispiele aufgeführt.
| Eigenschaft | Definition | Werttyp | Beispiel |
|---|---|---|---|
adID
|
|
String | 10 |
adBreakTrackingEvents
|
Ein Array, das VMAP Tracking-Ereignisse aus der VAST Antwort enthält. Weitere Informationen finden Sie in Abschnitt 2.3.3 der VMAP1.0-Spezifikation |
String |
[]
|
adMarkerDuration
|
Die anhand der Werbemarkierung im Manifest festgestellte Gültigkeitsdauer. |
String |
30
|
adParameters
|
Eine Reihe von Anzeigenparametern, von VASTVPAID, die an den MediaTailor Player weitergegeben werden. |
String | |
adProgramDateTime
|
|
String | |
ads
|
Ein Array, das die Werbeobjekte enthält, aus denen sich die Anzeige zusammensetzt. Die Anzeigen werden in der Reihenfolge aufgeführt, in der sie im Manifest erscheinen. |
Array |
[]
|
adSystem
|
Der Name des Systems, das die Anzeige bereitstellt. WichtigStellen Sie sicher, dass Sie einen Wert angeben. Wenn Sie keinen Wert angeben, können Probleme auftreten. |
String |
myADS
|
adTitle
|
Der Titel der Anzeige. |
String |
ad1
|
adVerifications
|
Enthält die Ressourcen und Metadaten, die für die Ausführung von Messcode von Drittanbietern erforderlich sind, um die kreative Wiedergabe zu überprüfen. Weitere Informationen zu dieser Eigenschaft finden Sie in Abschnitt 3.16 der VAST4.2-Spezifikation MediaTailor unterstützt |
Array |
[]
|
altText
|
Der alternative Text für ein Bild einer Begleitanzeige. Dieser Text ermöglicht es Spielern mit beschreibender Audiounterstützung für sehbehinderte Personen, eine Beschreibung des Bildes vorzulesen. |
String |
video sequence advertising sneakers
|
attributes
|
Beinhaltet Schlüssel, die in der VAST Spezifikation für Begleitwerbung definiert sind |
Object |
{}
|
apiFramework
|
Stellen Sie auf ein |
String |
VPAID
|
availID
|
|
String |
|
avails
|
Ein Array, das Werbeblock-Objekte oder Avails enthält, die im aktiven Manifestfenster angezeigt werden. Die Avails werden in der Reihenfolge aufgeführt, in der sie im Manifest erscheinen. |
Array |
[]
|
beaconUrls
|
Die AdresseURL, an die der Ad Beacon MediaTailor gesendet wird. |
String | |
bitrate
|
Die Bitrate des Video-Assets. Diese Eigenschaft ist in der Regel nicht für ein ausführbares Asset enthalten. |
String |
2048
|
companionAds
|
Eine oder mehrere Spezifikationen für begleitende Anzeigeninhalte, von denen jede eine zu verwendende Ressourcendatei spezifiziert. Begleitanzeigen begleiten die Werbeanzeige und bieten Inhalte, wie z. B. einen Rahmen um die Anzeige oder ein Banner, der in der Nähe des Videos eingeblendet wird. |
Array |
[]
|
companionClickThrough
|
A URL zur Seite des Werbetreibenden, die der Media Player öffnet, wenn der Zuschauer auf die Begleitanzeige klickt. |
String |
https://aws.amazon.com/
|
companionClickTracking
|
Das Tracking URL für die |
String |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
Der |
String |
creative-1
|
creativeSequence
|
Die Reihenfolge, in der eine Anzeige abgespielt werden soll, entsprechend dem |
String |
1
|
dashAvailabilityStartTime
|
Bei Live/Dynamic DASH ist das |
String |
2022-10-05T19:38:39.263Z
|
delivery
|
Gibt an, ob ein |
String |
progressive
|
duration
|
Länge im ISO 8601-Sekunden-Format. Die Antwort umfasst die Dauer für die gesamte Anzeigenverfügbarkeit sowie für jede Anzeige und jedes Beacon, obwohl die Beacon-Dauer immer Null ist. |
Zahl |
15.015
|
eventId
|
|
String |
23
|
eventType
|
Die Art des Beacons. |
String |
impression
|
extensions
|
Benutzerdefinierte ErweiterungenVAST, die von Ad-Servern verwendet werden. Weitere Informationen zu Erweiterungen finden Sie in Abschnitt 3.18 der VAST4.2-Spezifikation |
Array |
[]
|
height
|
Die Höhe des Video-Assets in Pixeln. |
String |
360
|
hlsAnchorMediaSequenceNumber
|
Die Mediensequenznummer der ersten/ältesten Mediensequenz, die im Ursprungsmanifest zu finden ist. HLS |
String |
77
|
htmlResource
|
Die CDATA -kodierteHTML, die direkt in die Seite des Streaming-Anbieters eingefügt wird. HTML |
String |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
Das URL in eine HTML Ressourcendatei, die der Streaming-Anbieter in einen Iframe lädt. |
String | |
maintainAspectRatio
|
Gibt an, ob das Seitenverhältnis des Videos bei der Skalierung beibehalten werden soll. |
Boolesch |
true
|
mediaFilesList
|
Gibt das Video und andere Elemente an, die der Player für die Anzeigenbereitstellung benötigt. |
Array |
[]
|
mediaFileUri
|
URIdas verweist entweder auf ein ausführbares Asset oder ein Video-Asset. |
String |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
Der MIME Typ des kreativen Elements oder des Begleitelements. |
String |
video/mp4
|
meta
|
|||
mezzanine
|
Der URL des MP4 Mezzanine-Assets, angegeben, wenn die VPAID Anzeige eines enthält. |
String |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
Der Wert des Tokens, das auf die nächste Ergebnisseite verweist, sofern ein solcher Wert vorhanden ist. |
String |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
Array |
[]
|
|
nonLinearAdsList
|
Array |
[]
|
|
nonLinearAvails
|
Array | ||
scalable
|
Gibt an, ob das Video auf andere Dimensionen skaliert werden soll. |
Boolesch |
true
|
sequence
|
Der Sequenzwert, der in der VAST Antwort für das Creative angegeben wurde. |
String |
1
|
skipOffset
|
Der Zeitwert, der angibt, wann der Player dem Benutzer Steuerelemente zum Überspringen zur Verfügung stellt. |
String |
00:00:05
|
startTime
|
Die Zeitposition im ISO 8601-Sekunden-Format relativ zum Beginn der Wiedergabe-Sitzung. Die Antwort enthält Startzeiten für den gesamten Ad-Avail und für jede Werbung und jedes Beacon. |
String |
PT9.943S
|
startTimeInSeconds
|
Die Zeitposition im Sekundenformat relativ zum Beginn der Wiedergabesitzung. Die Antwort enthält Startzeiten für den gesamten Ad-Avail und für jede Werbung und jedes Beacon. |
Zahl |
9.943
|
staticResource
|
Das URL zu einer statischen kreativen Datei, die für die Werbekomponente verwendet wird. |
String |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
Der |
String |
ad1
|
width
|
Die Breite des Video-Assets in Pixeln. |
String |
640
|
