Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Schéma et propriétés de suivi des publicités côté client
Grâce à la fonction de suivi des publicités MediaTailor côté client, vous pouvez intégrer des données détaillées de suivi des publicités côté client dans votre environnement de jeu. Les sections suivantes couvrent le schéma global de suivi des publicités, ainsi que les propriétés et valeurs spécifiques qui le composent.
Table des matières
Schema
Le tableau suivant décrit le schéma de suivi des publicités MediaTailor côté client. Le cas échéant, le tableau met en correspondance le schéma avec les VAST données.
| Clé | Type de données | Clés pour enfants | Cartographie à partir de la version VAST 2.0/3.0 | Cartographie depuis la VAST version 4.0 | Description |
|---|---|---|---|---|---|
| Réponse JSON | |||||
| - | Objet | avails, nonLinearAvails | |||
/avails
|
Tableau |
||||
| MediaTailor crée un objet pour chaque publication (pause publicitaire) dans la fenêtre du manifeste. | ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime | ||||
/ads
|
Tableau | ||||
| MediaTailor crée un objet pour chaque annonce pendant la période de validité. | Objet | adID,adType,adParameters,adVerifications,companionAds, duration durationInSeconds,extensions, icônes,mediaFile,startTime,startTimeInSeconds,dateTime, adBreakTrackingEvents | |||
/adId
|
Chaîne |
|
|||
/adParameters
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
Chaîne de paramètres publicitaires MediaTailor transmise au joueur VAST VPAID |
||
/adVerifications
|
Tableau |
VAST/Ad/InLine/AdVerifications
|
Contient les ressources et les métadonnées nécessaires pour exécuter un code de mesure tiers afin de vérifier une lecture créative |
||
| MediaTailor crée un objet pour chaque élément de vérification des publicités. | Objet | executableResource javaScriptResource, vendeur, verificationParameters | |||
/executableResource
|
Tableau |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor crée un objet pour chaque executableResource élément. |
Objet | apiFramework,adType, uri, langue | |||
/apiFramework
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
Chaîne | ||||
/uri
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
Tableau |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor crée un objet pour chaque javaScriptResource élément. |
Objet | apiFramework,browserOptional, uri | |||
/apiFramework
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
Tableau |
||||
| MediaTailor crée un objet pour chaque type d'événement de suivi d'un élément de vérification publicitaire. | Objet | événement, uri | |||
/event
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
Chaîne |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
Tableau |
Les publicités associées, qui accompagnent la publicité, fournissent du contenu tel qu'un cadre autour de l'annonce ou une bannière à afficher à côté de la vidéo. |
|||
| MediaTailor crée un objet pour chaque élément publicitaire complémentaire. | Objet | adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
Chaîne | ||||
/altText
|
Chaîne | ||||
/attributes
|
Objet |
adSlotId,apiFramework,assetHeight,assetWidth,expandedHeight,expandedWidth,height, identifiant, ratio de pixels, renderingMode width | |||
/adSlotId
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
Chaîne |
||||
/renderingMode
|
Chaîne |
||||
/width
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
Chaîne |
||||
/staticResource
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
Tableau |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
|
MediaTailor crée un objet pour chaque type d'événement de suivi des éléments publicitaires associés. |
|||||
/tracking
|
Objet |
>événement, uri | |||
/event
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
Chaîne |
Durée, au format ISO 8601 secondes |
|||
/durationInSeconds
|
Nombre |
Durée, en secondes |
|||
/extensions
|
Tableau |
Les serveurs publicitaires peuvent utiliser des VAST extensions personnalisées |
|||
|
MediaTailor crée un objet pour chaque extension enfant de l' |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
Objet | type, contenu |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
Chaîne |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
Chaîne | ||||
/icons
|
Tableau |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
|
MediaTailor crée un objet pour chaque |
Objet | attributes, dateTime, duration, durationInSeconds, htmlResource, iconClicks, iconViewTracking, iFrameResource, staticResource, startTime, startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
Objet | apiFramework,duration,height, offset, programme, pxratio,,, width xPosition yPosition | |||
/apiFramework
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
Chaîne | ||||
/duration
|
Chaîne | ||||
/durationInSeconds
|
Nombre | ||||
/htmlResource
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
Objet | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
Chaîne | ||||
/iconClickFallbackImages
|
Tableau |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
|
MediaTailor crée un objet pour chaque nœud d'image de remplacement cliqué sur une icône. |
|||||
/altText
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@height
|
|||
/width
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@width
|
|||
/staticResource
|
Objet | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource
|
||
/creativeType
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/@creativeType
|
|||
/uri
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
Objet | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
Chaîne |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
Chaîne | ||||
/startTimeInSeconds
|
Nombre | ||||
/mediaFiles
|
Objet | adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents |
Vidéos et autres ressources dont le joueur a besoin pour profiter de la publicité |
||
/adParameters
|
Chaîne | ||||
/duration
|
Chaîne | ||||
/durationInSeconds
|
Nombre | ||||
/mediaFilesList
|
Tableau | ||||
|
MediaTailor crée un objet pour chaque type d'événement de suivi des éléments publicitaires associés |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
Chaîne | ||||
/delivery
|
Chaîne | ||||
/height
|
Chaîne | ||||
/maintainAspectRatio
|
Chaîne | ||||
/mediaFileUri
|
Chaîne | ||||
/mediaType
|
Chaîne | ||||
/scalable
|
Chaîne | ||||
/width
|
Chaîne | ||||
/mezzanine
|
Chaîne | ||||
/startTime
|
Chaîne | ||||
/startTimeInSeconds
|
Chaîne | ||||
/trackingEvents
|
Tableau | ||||
|
MediaTailor crée un objet pour chaque événement de suivi de la création |
beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds | ||||
/beaconUrls
|
Tableau | ||||
|
Liste séparée par des virgules de tous les suivis de URLs cet événement |
|||||
/duration
|
Chaîne | ||||
/durationInSeconds
|
Nombre | ||||
/dateTime
|
Chaîne | ||||
/eventId
|
Chaîne | ||||
/eventType
|
Chaîne | ||||
/startTime
|
Chaîne | ||||
/startTimeInSeconds
|
Nombre | ||||
/startTime
|
Chaîne |
Position temporelle, au format ISO 8601 secondes, par rapport au début de la session de lecture |
|||
/startTimeInSeconds
|
Nombre |
Position temporelle, au format secondes, par rapport au début de la session de lecture |
|||
/dateTime
|
Chaîne |
Date et heure du programme, au format ISO 8601 secondes, pour le début de la diffusion de la publicité |
|||
/trackingEvents
|
Tableau |
Contient toutes les données relatives aux événements de suivi reçues dans la VAST réponse, ainsi que les informations temporelles |
|||
/adType
|
Chaîne | ||||
/availId
|
Chaîne | ||||
/dateTime
|
Chaîne | ||||
/duration
|
Chaîne | ||||
/durationInSeconds
|
Nombre | ||||
/startTime
|
Chaîne | ||||
/startTimeInSeconds
|
Nombre | ||||
Propriétés
Le tableau suivant répertorie les propriétés du suivi côté clientAPI, leurs définitions, leurs types de valeurs et des exemples.
| Propriété | Définition | Type de la valeur | Exemple |
|---|---|---|---|
adID
|
|
Chaîne | 10 |
adBreakTrackingEvents
|
Un tableau qui contient les événements de VMAP suivi issus de la VAST réponse. Pour plus d'informations, consultez la section 2.3.3 de la spécification VMAP 1.0 |
Chaîne |
[]
|
adMarkerDuration
|
Durée de validité observée à partir du marqueur publicitaire dans le manifeste. |
Chaîne |
30
|
adParameters
|
Chaîne de paramètres publicitaires, provenant du VASTVPAID, MediaTailor transmise au lecteur. |
Chaîne | |
adProgramDateTime
|
|
Chaîne | |
ads
|
Tableau contenant les objets publicitaires qui constituent l'offre. Les annonces sont répertoriées dans l'ordre dans lequel elles apparaissent dans le manifeste. |
Tableau |
[]
|
adSystem
|
Nom du système qui diffuse l'annonce. ImportantAssurez-vous de fournir une valeur. Si vous ne fournissez pas de valeur, des problèmes peuvent survenir. |
Chaîne |
myADS
|
adTitle
|
Le titre de l'annonce. |
Chaîne |
ad1
|
adVerifications
|
Contient les ressources et les métadonnées requises pour exécuter un code de mesure tiers afin de vérifier une lecture créative. Pour plus d'informations sur cette propriété, consultez la section 3.16 de la spécification VAST 4.2 MediaTailor prend |
Tableau |
[]
|
altText
|
Texte alternatif pour l'image d'une annonce associée. Ce texte permet aux joueurs disposant d'un support audio descriptif pour malvoyants de relire une description de l'image. |
Chaîne |
video sequence advertising sneakers
|
attributes
|
Inclut les clés définies dans la VAST spécification pour les publicités associées |
Objet |
{}
|
apiFramework
|
Réglez |
Chaîne |
VPAID
|
availID
|
|
Chaîne |
|
avails
|
Tableau contenant des objets publicitaires, ou outils, présentés dans la fenêtre de manifeste active. Les options sont répertoriées dans l'ordre dans lequel elles apparaissent dans le manifeste. |
Tableau |
[]
|
beaconUrls
|
Le URL where MediaTailor envoie la balise publicitaire. |
Chaîne | |
bitrate
|
Débit de la ressource vidéo. Cette propriété n'est généralement pas incluse pour un actif exécutable. |
Chaîne |
2048
|
companionAds
|
Une ou plusieurs spécifications de contenu publicitaire complémentaires, chacune d'entre elles spécifiant un fichier de ressources à utiliser. Des publicités complémentaires accompagnent la publicité et fournissent du contenu, comme un cadre autour de l'annonce ou une bannière, à afficher à côté de la vidéo. |
Tableau |
[]
|
companionClickThrough
|
A URL vers la page de l'annonceur que le lecteur multimédia ouvre lorsque le spectateur clique sur l'annonce associée. |
Chaîne |
https://aws.amazon.com/
|
companionClickTracking
|
Le suivi URL de la |
Chaîne |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
La valeur d' |
Chaîne |
creative-1
|
creativeSequence
|
Séquence dans laquelle une annonce doit être diffusée, en fonction de la |
Chaîne |
1
|
dashAvailabilityStartTime
|
Pour live/dynamicDASH, le manifeste |
Chaîne |
2022-10-05T19:38:39.263Z
|
delivery
|
Indique si un |
Chaîne |
progressive
|
duration
|
Durée, au format ISO 8601 secondes. La réponse inclut les durées pour l'ensemble de la publicité et pour chaque annonce et balise, bien que les durées des balises soient toujours nulles. |
Nombre |
15.015
|
eventId
|
|
Chaîne |
23
|
eventType
|
Le type de balise. |
Chaîne |
impression
|
extensions
|
Extensions personnalisées utilisées par les serveurs publicitaires. VAST Pour plus d'informations sur les extensions, consultez la section 3.18 de la spécification VAST 4.2 |
Tableau |
[]
|
height
|
Hauteur, en pixels, de la ressource vidéo. |
Chaîne |
360
|
hlsAnchorMediaSequenceNumber
|
Le numéro de séquence multimédia de la première/de la plus ancienne séquence multimédia vue dans le manifeste d'origine. HLS |
Chaîne |
77
|
htmlResource
|
Le CDATA code -encodé HTML qui est inséré directement dans la HTML page du fournisseur de streaming. |
Chaîne |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
Le URL vers un fichier de HTML ressources que le fournisseur de streaming charge dans un iframe. |
Chaîne | |
maintainAspectRatio
|
Indique s'il faut conserver le rapport hauteur/largeur de la vidéo lors de la mise à l'échelle. |
Booléen |
true
|
mediaFilesList
|
Spécifie la vidéo et les autres ressources dont le joueur a besoin pour bénéficier de la publicité. |
Tableau |
[]
|
mediaFileUri
|
URIqui pointe vers une ressource exécutable ou une ressource vidéo. |
Chaîne |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
Le MIME type de ressource créative ou complémentaire. |
Chaîne |
video/mp4
|
meta
|
|||
mezzanine
|
Le bien URL de la MP4 mezzanine, précisé si l'VPAIDannonce en inclut un. |
Chaîne |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
La valeur du jeton qui pointe vers la page de résultats suivante, lorsqu'une telle valeur existe. |
Chaîne |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
Tableau |
[]
|
|
nonLinearAdsList
|
Tableau |
[]
|
|
nonLinearAvails
|
Tableau | ||
scalable
|
Indique s'il faut redimensionner la vidéo à d'autres dimensions. |
Booléen |
true
|
sequence
|
La valeur de séquence spécifiée pour la création dans la VAST réponse. |
Chaîne |
1
|
skipOffset
|
La valeur temporelle qui identifie le moment où le joueur met les commandes de saut à la disposition de l'utilisateur. |
Chaîne |
00:00:05
|
startTime
|
Position temporelle, au format ISO 8601 secondes, par rapport au début de la session de lecture. La réponse inclut les heures de début pour l'ensemble de la diffusion de publicités, et pour chaque publicité et balise beacon. |
Chaîne |
PT9.943S
|
startTimeInSeconds
|
Position temporelle, au format secondes, par rapport au début de la session de lecture. La réponse inclut les heures de début pour l'ensemble de la diffusion de publicités, et pour chaque publicité et balise beacon. |
Nombre |
9.943
|
staticResource
|
Le URL vers un fichier créatif statique utilisé pour le composant publicitaire. |
Chaîne |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
La valeur d' |
Chaîne |
ad1
|
width
|
Largeur, en pixels, de la ressource vidéo. |
Chaîne |
640
|
