Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Schema e proprietà di tracciamento degli annunci sul lato client
Con la funzionalità di tracciamento degli annunci MediaTailor lato client, puoi integrare dati dettagliati di tracciamento degli annunci lato client nel tuo ambiente di gioco. Le sezioni seguenti trattano lo schema generale di tracciamento degli annunci, nonché le proprietà e i valori specifici che lo compongono.
Schema
La tabella seguente descrive lo schema di tracciamento degli annunci sul lato client. MediaTailor Ove applicabile, la tabella associa lo schema ai dati. VAST
| Chiave | Tipo di dati | Chiavi per bambini | Mappatura da 2.0/3.0 VAST | Mappatura a partire dalla versione 4.0 VAST | Descrizione |
|---|---|---|---|---|---|
| Risposta JSON | |||||
| - | Oggetto | avails, nonLinearAvails | |||
/avails
|
Array |
||||
| MediaTailor crea un oggetto per ogni avail (ad break) all'interno della finestra del manifesto. | ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime | ||||
/ads
|
Array | ||||
| MediaTailor crea un oggetto per ogni annuncio entro il periodo di disponibilità. | Oggetto | adID,adType,adParameters,adVerifications,companionAds,duration, durationInSeconds,extensions, icone,mediaFile,startTime,startTimeInSeconds, dateTime adBreakTrackingEvents | |||
/adId
|
Stringa |
|
|||
/adParameters
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
Una stringa di parametri dell'annuncio VAST VPAID che MediaTailor viene trasmessa al giocatore |
||
/adVerifications
|
Array |
VAST/Ad/InLine/AdVerifications
|
Contiene le risorse e i metadati necessari per eseguire il codice di misurazione di terze parti al fine di verificare la riproduzione creativa |
||
| MediaTailor crea un oggetto per ogni elemento di verifica degli annunci. | Oggetto | executableResource, fornitore javaScriptResource, verificationParameters | |||
/executableResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor crea un oggetto per ogni executableResource elemento. |
Oggetto | apiFrameworkadType, uri, lingua | |||
/apiFramework
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
Stringa | ||||
/uri
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor crea un oggetto per ogni javaScriptResource elemento. |
Oggetto | apiFrameworkbrowserOptional, uri | |||
/apiFramework
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
Array |
||||
| MediaTailor crea un oggetto per ogni tipo di evento di tracciamento degli elementi di verifica degli annunci. | Oggetto | evento, uri | |||
/event
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
Stringa |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
Array |
Gli annunci complementari, che accompagnano l'annuncio, forniscono contenuti come una cornice attorno all'annuncio o un banner da visualizzare vicino al video. |
|||
| MediaTailor crea un oggetto per ogni elemento dell'annuncio complementare. | Oggetto | adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
Stringa | ||||
/altText
|
Stringa | ||||
/attributes
|
Oggetto |
adSlotId,apiFramework,,assetHeight,assetWidth,expandedHeight, id expandedWidthheight, pxratio, renderingMode width | |||
/adSlotId
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
Stringa |
||||
/renderingMode
|
Stringa |
||||
/width
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
Stringa |
||||
/staticResource
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
Array |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
|
MediaTailor crea un oggetto per ogni tipo di evento di tracciamento degli elementi dell'annuncio complementare. |
|||||
/tracking
|
Oggetto |
>evento, uri | |||
/event
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
Stringa |
Lunghezza, nel formato ISO 8601 secondi |
|||
/durationInSeconds
|
Numero |
Lunghezza, in formato secondi |
|||
/extensions
|
Array |
I server pubblicitari possono utilizzare VAST estensioni personalizzate |
|||
|
MediaTailor crea un oggetto per ogni estensione secondaria dell' |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
Oggetto | tipo, contenuto |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
Stringa |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
Stringa | ||||
/icons
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
|
MediaTailor crea un oggetto per ogni |
Oggetto | attributes, dateTime, duration, durationInSeconds, htmlResource, iconClicks, iconViewTracking, iFrameResource, staticResource, startTime, startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
Oggetto | apiFramework,duration,height, offset, programma, pxratio,, width xPosition yPosition | |||
/apiFramework
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
Stringa | ||||
/duration
|
Stringa | ||||
/durationInSeconds
|
Numero | ||||
/htmlResource
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
Oggetto | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
Stringa | ||||
/iconClickFallbackImages
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
|
MediaTailor crea un oggetto per ogni nodo di immagine fallback-click con un clic su icona. |
|||||
/altText
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@height
|
|||
/width
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@width
|
|||
/staticResource
|
Oggetto | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource
|
||
/creativeType
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/@creativeType
|
|||
/uri
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
Oggetto | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
Stringa |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
Stringa | ||||
/startTimeInSeconds
|
Numero | ||||
/mediaFiles
|
Oggetto | adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents |
Sono disponibili video e altre risorse di cui il giocatore ha bisogno per l'annuncio |
||
/adParameters
|
Stringa | ||||
/duration
|
Stringa | ||||
/durationInSeconds
|
Numero | ||||
/mediaFilesList
|
Array | ||||
|
MediaTailor crea un oggetto per ogni tipo di evento di tracciamento degli elementi dell'annuncio complementare |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
Stringa | ||||
/delivery
|
Stringa | ||||
/height
|
Stringa | ||||
/maintainAspectRatio
|
Stringa | ||||
/mediaFileUri
|
Stringa | ||||
/mediaType
|
Stringa | ||||
/scalable
|
Stringa | ||||
/width
|
Stringa | ||||
/mezzanine
|
Stringa | ||||
/startTime
|
Stringa | ||||
/startTimeInSeconds
|
Stringa | ||||
/trackingEvents
|
Array | ||||
|
MediaTailor crea un oggetto per ogni evento di tracciamento per la creatività |
beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds | ||||
/beaconUrls
|
Array | ||||
|
Un elenco separato da virgole di tutti i URLs tracciamenti relativi a questo evento |
|||||
/duration
|
Stringa | ||||
/durationInSeconds
|
Numero | ||||
/dateTime
|
Stringa | ||||
/eventId
|
Stringa | ||||
/eventType
|
Stringa | ||||
/startTime
|
Stringa | ||||
/startTimeInSeconds
|
Numero | ||||
/startTime
|
Stringa |
Posizione temporale, nel formato ISO 8601 secondi, rispetto all'inizio della sessione di riproduzione |
|||
/startTimeInSeconds
|
Numero |
Posizione temporale, in formato secondi, rispetto all'inizio della sessione di riproduzione |
|||
/dateTime
|
Stringa |
Data e ora del programma, nel formato ISO 8601 secondi, per l'inizio dell'annuncio disponibile |
|||
/trackingEvents
|
Array |
Contiene tutti i dati sugli eventi di tracciamento ricevuti nella VAST risposta, insieme alle informazioni sulla tempistica |
|||
/adType
|
Stringa | ||||
/availId
|
Stringa | ||||
/dateTime
|
Stringa | ||||
/duration
|
Stringa | ||||
/durationInSeconds
|
Numero | ||||
/startTime
|
Stringa | ||||
/startTimeInSeconds
|
Numero | ||||
Proprietà
La tabella seguente elenca le proprietà del tracciamento lato client, le relative definizioniAPI, i tipi di valore e gli esempi.
| Proprietà | Definizione | Value type (Tipo di valore) | Esempio |
|---|---|---|---|
adID
|
|
Stringa | 10 |
adBreakTrackingEvents
|
Un array che trasporta gli eventi di VMAP tracciamento della VAST risposta. Per ulteriori informazioni, vedere la sezione 2.3.3 della specifica VMAP 1.0 |
Stringa |
[]
|
adMarkerDuration
|
La durata della disponibilità osservata dal marker dell'annuncio nel manifesto. |
Stringa |
30
|
adParameters
|
Una stringa di parametri dell'annuncio, da VASTVPAID, che MediaTailor passa al giocatore. |
Stringa | |
adProgramDateTime
|
|
Stringa | |
ads
|
Un array contenente gli oggetti pubblicitari che compongono l'avail. Gli annunci sono elencati nell'ordine in cui appaiono nel manifesto. |
Array |
[]
|
adSystem
|
Il nome del sistema che pubblica l'annuncio. ImportanteAssicurati di fornire un valore. Se non fornisci un valore, possono sorgere problemi. |
Stringa |
myADS
|
adTitle
|
Il titolo dell'annuncio. |
Stringa |
ad1
|
adVerifications
|
Contiene le risorse e i metadati necessari per eseguire il codice di misurazione di terze parti al fine di verificare la riproduzione creativa. Per ulteriori informazioni su questa proprietà, vedere la sezione 3.16 della VAST specifica 4.2. MediaTailor supporta |
Array |
[]
|
altText
|
Il testo alternativo per l'immagine di un annuncio complementare. Questo testo consente ai giocatori con supporto audio descrittivo per non vedenti di rileggere una descrizione dell'immagine. |
Stringa |
video sequence advertising sneakers
|
attributes
|
Include le chiavi definite nelle VAST specifiche per gli annunci complementari, come |
Oggetto |
{}
|
apiFramework
|
Imposta |
Stringa |
VPAID
|
availID
|
|
Stringa |
|
avails
|
Un array contenente oggetti ad-break, o avail, che vengono presentati nella finestra del manifesto attiva. Gli avail sono elencati nell'ordine in cui appaiono nel manifesto. |
Array |
[]
|
beaconUrls
|
Il URL where MediaTailor invia l'ad beacon. |
Stringa | |
bitrate
|
Il bitrate della risorsa video. Questa proprietà non è in genere inclusa per una risorsa eseguibile. |
Stringa |
2048
|
companionAds
|
Una o più specifiche relative ai contenuti pubblicitari, ognuna delle quali specifica un file di risorse da utilizzare. Gli annunci complementari accompagnano l'annuncio e forniscono contenuti, come una cornice attorno all'annuncio o un banner, da visualizzare vicino al video. |
Array |
[]
|
companionClickThrough
|
A URL alla pagina dell'inserzionista che il lettore multimediale apre quando lo spettatore fa clic sull'annuncio complementare. |
Stringa |
https://aws.amazon.com/
|
companionClickTracking
|
Il tracciamento URL della proprietà. |
Stringa |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
Il valore dell' |
Stringa |
creative-1
|
creativeSequence
|
La sequenza in cui deve essere riprodotto un annuncio, in base al |
Stringa |
1
|
dashAvailabilityStartTime
|
Per live/dynamicDASH, il |
Stringa |
2022-10-05T19:38:39.263Z
|
delivery
|
Indica se viene |
Stringa |
progressive
|
duration
|
Lunghezza, nel formato ISO 8601 secondi. La risposta include le durate per l'intero annuncio disponibile e per ogni annuncio e beacon, sebbene la durata del beacon sia sempre zero. |
Numero |
15.015
|
eventId
|
|
Stringa |
23
|
eventType
|
Il tipo di faro. |
Stringa |
impression
|
extensions
|
Estensioni personalizzate utilizzate dai server pubblicitari. VAST Per ulteriori informazioni sulle estensioni, consulta la sezione 3.18 della specifica VAST 4.2 |
Array |
[]
|
height
|
L'altezza, in pixel, della risorsa video. |
Stringa |
360
|
hlsAnchorMediaSequenceNumber
|
Il numero della sequenza multimediale della prima/sequenza multimediale più vecchia visualizzata nel manifesto di origine. HLS |
Stringa |
77
|
htmlResource
|
La CDATA codifica -codificata HTML che viene inserita direttamente nella pagina del provider di streaming. HTML |
Stringa |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
Il URL verso un file di HTML risorse che il provider di streaming carica in un iframe. |
Stringa | |
maintainAspectRatio
|
Indica se mantenere le proporzioni del video durante il ridimensionamento. |
Booleano |
true
|
mediaFilesList
|
Speciifica il video e le altre risorse di cui il giocatore ha bisogno per la pubblicazione dell'annuncio. |
Array |
[]
|
mediaFileUri
|
URIche indica una risorsa eseguibile o una risorsa video. |
Stringa |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
Il MIME tipo di risorsa creativa o complementare. |
Stringa |
video/mp4
|
meta
|
|||
mezzanine
|
La URL MP4 risorsa soppalcata, specificata se l'VPAIDannuncio ne include una. |
Stringa |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
Il valore del token che rimanda alla pagina successiva dei risultati, quando tale valore esiste. |
Stringa |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
Array |
[]
|
|
nonLinearAdsList
|
Array |
[]
|
|
nonLinearAvails
|
Array | ||
scalable
|
Indica se ridimensionare il video in base ad altre dimensioni. |
Booleano |
true
|
sequence
|
Il valore della sequenza specificato per la creatività nella VAST risposta. |
Stringa |
1
|
skipOffset
|
Il valore temporale che identifica quando il giocatore mette a disposizione dell'utente i controlli di salto. |
Stringa |
00:00:05
|
startTime
|
La posizione temporale, nel formato ISO 8601 secondi, rispetto all'inizio della sessione di riproduzione. La risposta include gli orari di inizio per l'intero spazio pubblicitario e per ogni annuncio e beacon. |
Stringa |
PT9.943S
|
startTimeInSeconds
|
La posizione temporale, in formato secondi, rispetto all'inizio della sessione di riproduzione. La risposta include gli orari di inizio per l'intero spazio pubblicitario e per ogni annuncio e beacon. |
Numero |
9.943
|
staticResource
|
Quindi URL a un file creativo statico utilizzato per il componente pubblicitario. |
Stringa |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
Il valore dell' |
Stringa |
ad1
|
width
|
La larghezza, in pixel, della risorsa video. |
Stringa |
640
|
