Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Esquema y propiedades del seguimiento de anuncios del lado del cliente
Con la función de seguimiento de anuncios MediaTailor del lado del cliente, puedes integrar datos detallados del seguimiento de anuncios del lado del cliente en tu entorno de jugador. En las siguientes secciones se describe el esquema general de seguimiento de anuncios, así como las propiedades y valores específicos que lo componen.
Contenido
Esquema
En la siguiente tabla se describe el esquema de seguimiento de anuncios del MediaTailor lado del cliente. Cuando proceda, la tabla asigna el esquema a los datos. VAST
| Clave | Tipo de datos | Llaves secundarias | Mapeo desde la versión VAST 2.0/3.0 | Mapeo desde la versión 4.0 VAST | Descripción |
|---|---|---|---|---|---|
| Respuesta JSON | |||||
| - | Objeto | avails, nonLinearAvails | |||
/avails
|
Matriz |
||||
| MediaTailor crea un objeto para cada descarga (pausa publicitaria) dentro de la ventana del manifiesto. | ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime | ||||
/ads
|
Matriz | ||||
| MediaTailor crea un objeto para cada anuncio dentro del período de disponibilidad. | Objeto | adID,adType,adParameters,adVerifications,companionAds,duration, durationInSeconds, iconosextensions,,mediaFile,startTime,startTimeInSeconds, dateTime adBreakTrackingEvents | |||
/adId
|
Cadena |
|
|||
/adParameters
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
Cadena de parámetros del anuncio VAST VPAID que se MediaTailor transmite al reproductor |
||
/adVerifications
|
Matriz |
VAST/Ad/InLine/AdVerifications
|
Contiene los recursos y los metadatos necesarios para ejecutar el código de medición de terceros a fin de verificar la reproducción creativa |
||
| MediaTailor crea un objeto para cada elemento de verificación de anuncios. | Objeto | executableResource javaScriptResource, proveedor, verificationParameters | |||
/executableResource
|
Matriz |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor crea un objeto para cada executableResource elemento. |
Objeto | apiFrameworkadType, uri, idioma | |||
/apiFramework
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
Cadena | ||||
/uri
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
Matriz |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor crea un objeto para cada javaScriptResource elemento. |
Objeto | apiFramework,browserOptional, uri | |||
/apiFramework
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
Matriz |
||||
| MediaTailor crea un objeto para cada tipo de evento de seguimiento de elementos de verificación de anuncios. | Objeto | evento, uri | |||
/event
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
Cadena |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
Matriz |
Los anuncios complementarios, que acompañan al anuncio, ofrecen contenido como un marco alrededor del anuncio o un banner para mostrarlo cerca del vídeo. |
|||
| MediaTailor crea un objeto para cada elemento del anuncio complementario. | Objeto | adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
Cadena | ||||
/altText
|
Cadena | ||||
/attributes
|
Objeto |
adSlotId,apiFramework,,assetHeight,assetWidth,expandedHeight, id expandedWidthheight, pxratio,, renderingMode width | |||
/adSlotId
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
Cadena |
||||
/renderingMode
|
Cadena |
||||
/width
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
Cadena |
||||
/staticResource
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
Matriz |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
|
MediaTailor crea un objeto para cada tipo de evento de seguimiento de elementos publicitarios complementarios. |
|||||
/tracking
|
Objeto |
>evento, uri | |||
/event
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
Cadena |
Duración, en formato de ISO 8601 segundos |
|||
/durationInSeconds
|
Número |
Longitud, en formato de segundos |
|||
/extensions
|
Matriz |
Los servidores de anuncios pueden usar VAST extensiones personalizadas |
|||
|
MediaTailor crea un objeto para cada extensión secundaria del |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
Objeto | tipo, contenido |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
Cadena |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
Cadena | ||||
/icons
|
Matriz |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
|
MediaTailor crea un objeto para cada |
Objeto | attributes, dateTime, duration, durationInSeconds, htmlResource, iconClicks, iconViewTracking, iFrameResource, staticResource, startTime, startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
Objeto | apiFramework,duration, offsetheight, program, pxratio,,, width xPosition yPosition | |||
/apiFramework
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
Cadena | ||||
/duration
|
Cadena | ||||
/durationInSeconds
|
Número | ||||
/htmlResource
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
Objeto | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
Cadena | ||||
/iconClickFallbackImages
|
Matriz |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
|
MediaTailor crea un objeto para cada nodo de imagen alternativa al que se hace clic en un icono. |
|||||
/altText
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@height
|
|||
/width
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@width
|
|||
/staticResource
|
Objeto | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource
|
||
/creativeType
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/@creativeType
|
|||
/uri
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
Objeto | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
Cadena |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
Cadena | ||||
/startTimeInSeconds
|
Número | ||||
/mediaFiles
|
Objeto | adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents |
Aprovecha el vídeo y otros recursos que el jugador necesita para el anuncio |
||
/adParameters
|
Cadena | ||||
/duration
|
Cadena | ||||
/durationInSeconds
|
Número | ||||
/mediaFilesList
|
Matriz | ||||
|
MediaTailor crea un objeto para cada tipo de evento de seguimiento de elementos publicitarios complementarios |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
Cadena | ||||
/delivery
|
Cadena | ||||
/height
|
Cadena | ||||
/maintainAspectRatio
|
Cadena | ||||
/mediaFileUri
|
Cadena | ||||
/mediaType
|
Cadena | ||||
/scalable
|
Cadena | ||||
/width
|
Cadena | ||||
/mezzanine
|
Cadena | ||||
/startTime
|
Cadena | ||||
/startTimeInSeconds
|
Cadena | ||||
/trackingEvents
|
Matriz | ||||
|
MediaTailor crea un objeto para cada evento de seguimiento de la creatividad |
beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds | ||||
/beaconUrls
|
Matriz | ||||
|
Una lista separada por comas de todo el seguimiento URLs de este evento |
|||||
/duration
|
Cadena | ||||
/durationInSeconds
|
Número | ||||
/dateTime
|
Cadena | ||||
/eventId
|
Cadena | ||||
/eventType
|
Cadena | ||||
/startTime
|
Cadena | ||||
/startTimeInSeconds
|
Número | ||||
/startTime
|
Cadena |
Posición temporal, en formato de ISO 8601 segundos, relativa al inicio de la sesión de reproducción |
|||
/startTimeInSeconds
|
Número |
Posición temporal, en formato de segundos, relativa al inicio de la sesión de reproducción |
|||
/dateTime
|
Cadena |
Programe la fecha y hora, en formato de ISO 8601 segundos, para el inicio del anuncio |
|||
/trackingEvents
|
Matriz |
Contiene todos los datos del evento de seguimiento que se recibieron en la VAST respuesta, junto con la información sobre el tiempo |
|||
/adType
|
Cadena | ||||
/availId
|
Cadena | ||||
/dateTime
|
Cadena | ||||
/duration
|
Cadena | ||||
/durationInSeconds
|
Número | ||||
/startTime
|
Cadena | ||||
/startTimeInSeconds
|
Número | ||||
Propiedades
En la siguiente tabla se enumeran las propiedades del seguimiento del lado del clienteAPI, sus definiciones, tipos de valores y ejemplos.
| Propiedad | Definición | Tipo de valor | Ejemplo |
|---|---|---|---|
adID
|
|
Cadena | 10 |
adBreakTrackingEvents
|
Matriz que contiene los eventos de VMAP seguimiento de la VAST respuesta. Para obtener más información, consulte la sección 2.3.3 de la especificación VMAP 1.0 |
Cadena |
[]
|
adMarkerDuration
|
El tiempo de disponibilidad observado a partir del marcador publicitario del manifiesto. |
Cadena |
30
|
adParameters
|
Cadena de parámetros del anuncio, desde el VASTVPAID, que se MediaTailor transfiere al reproductor. |
Cadena | |
adProgramDateTime
|
|
Cadena | |
ads
|
Matriz que contiene los objetos publicitarios que componen el anuncio. Los anuncios se muestran en el orden en que aparecen en el manifiesto. |
Matriz |
[]
|
adSystem
|
El nombre del sistema que publica el anuncio. importanteAsegúrese de proporcionar un valor. Si no proporciona un valor, pueden surgir problemas. |
Cadena |
myADS
|
adTitle
|
El título del anuncio. |
Cadena |
ad1
|
adVerifications
|
Contiene los recursos y los metadatos necesarios para ejecutar el código de medición de terceros a fin de verificar la reproducción creativa. Para obtener más información sobre esta propiedad, consulte la sección 3.16 de la especificación VAST 4.2 MediaTailor admite |
Matriz |
[]
|
altText
|
El texto alternativo de una imagen de un anuncio complementario. Este texto permite a los jugadores con soporte de audio descriptivo para personas con discapacidad visual leer una descripción de la imagen. |
Cadena |
video sequence advertising sneakers
|
attributes
|
Incluye las claves definidas en la VAST especificación de los anuncios complementarios, como |
Objeto |
{}
|
apiFramework
|
Se configura |
Cadena |
VPAID
|
availID
|
|
Cadena |
|
avails
|
Matriz que contiene objetos publicitarios, o paquetes, que aparecen en la ventana del manifiesto activa. Los artículos disponibles se muestran en el orden en que aparecen en el manifiesto. |
Matriz |
[]
|
beaconUrls
|
El URL lugar al que se MediaTailor envía la baliza publicitaria. |
Cadena | |
bitrate
|
La velocidad de bits del recurso de vídeo. Esta propiedad no suele incluirse en los activos ejecutables. |
Cadena |
2048
|
companionAds
|
Una o varias especificaciones complementarias de contenido publicitario, cada una de las cuales especifica el archivo de recursos que se va a utilizar. Los anuncios complementarios acompañan al anuncio y proporcionan contenido, como un marco alrededor del anuncio o un banner, para mostrarlo cerca del vídeo. |
Matriz |
[]
|
companionClickThrough
|
A: URL a la página del anunciante que el reproductor multimedia abre cuando el espectador hace clic en el anuncio complementario. |
Cadena |
https://aws.amazon.com/
|
companionClickTracking
|
El seguimiento URL de la |
Cadena |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
El valor del |
Cadena |
creative-1
|
creativeSequence
|
La secuencia en la que debe reproducirse un anuncio, según el |
Cadena |
1
|
dashAvailabilityStartTime
|
En el caso del manifiesto en directo/dinámicoDASH, el |
Cadena |
2022-10-05T19:38:39.263Z
|
delivery
|
Indica si se está utilizando un |
Cadena |
progressive
|
duration
|
Duración, en formato de ISO 8601 segundos. La respuesta incluye la duración de todo el anuncio disponible y de cada anuncio y baliza, aunque la duración de las balizas siempre es cero. |
Número |
15.015
|
eventId
|
|
Cadena |
23
|
eventType
|
El tipo de baliza. |
Cadena |
impression
|
extensions
|
Las extensiones personalizadas VAST que utilizan los servidores de anuncios. Para obtener más información sobre las extensiones, consulta la sección 3.18 de la especificación VAST 4.2 |
Matriz |
[]
|
height
|
La altura, en píxeles, del recurso de vídeo. |
Cadena |
360
|
hlsAnchorMediaSequenceNumber
|
El número de secuencia multimedia de la primera secuencia multimedia o la más antigua que se ve en el manifiesto de origen. HLS |
Cadena |
77
|
htmlResource
|
El código CDATA -codificado HTML que se inserta directamente en la página del proveedor de streaming. HTML |
Cadena |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
URLA un archivo HTML de recursos que el proveedor de streaming carga en un iframe. |
Cadena | |
maintainAspectRatio
|
Indica si se debe mantener la relación de aspecto del vídeo mientras se escala. |
Booleano |
true
|
mediaFilesList
|
Especifica el vídeo y otros recursos que el reproductor necesita para que el anuncio esté disponible. |
Matriz |
[]
|
mediaFileUri
|
URIque apunta a un activo ejecutable o a un activo de vídeo. |
Cadena |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
El MIME tipo de activo creativo o complementario. |
Cadena |
video/mp4
|
meta
|
|||
mezzanine
|
El URL del MP4 recurso intermedio, especificado si el VPAID anuncio incluye uno. |
Cadena |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
El valor del token que apunta a la siguiente página de resultados, cuando ese valor existe. |
Cadena |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
Matriz |
[]
|
|
nonLinearAdsList
|
Matriz |
[]
|
|
nonLinearAvails
|
Matriz | ||
scalable
|
Indica si se debe escalar el vídeo a otras dimensiones. |
Booleano |
true
|
sequence
|
El valor de secuencia especificado para la creatividad en la VAST respuesta. |
Cadena |
1
|
skipOffset
|
El valor de tiempo que identifica el momento en que el reproductor pone los controles de salto a disposición del usuario. |
Cadena |
00:00:05
|
startTime
|
La posición temporal, en formato de ISO 8601 segundos, relativa al inicio de la sesión de reproducción. La respuesta incluye las horas de inicio de todo el espacio publicitario y de cada anuncio y baliza. |
Cadena |
PT9.943S
|
startTimeInSeconds
|
La posición temporal, en formato de segundos, relativa al inicio de la sesión de reproducción. La respuesta incluye las horas de inicio de todo el espacio publicitario y de cada anuncio y baliza. |
Número |
9.943
|
staticResource
|
URLA un archivo creativo estático que se utiliza para el componente publicitario. |
Cadena |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
El valor del |
Cadena |
ad1
|
width
|
El ancho, en píxeles, del recurso de vídeo. |
Cadena |
640
|
