DocumentaciónExperience PlatformGuía del modelo de datos (XDM) de Experience

Detalles de Advertising grupo de campos de esquema

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador

Detalles de Advertising es un grupo de campos de esquema estándar para la XDM ExperienceEvent clase. El grupo de campos proporciona un único objeto advertising a un esquema, que captura información relacionada con las impresiones publicitarias, los clics y la atribución.

Estructura del grupo de campos

Propiedad
Tipo de datos
Descripción
adAssetReference
Objeto
Registra información de recursos sobre el anuncio. Vea la subsección debajo de para obtener más información sobre la estructura de este objeto.
adAssetViewDetails
Objeto
Registra los detalles de vista de la reproducción del anuncio. Vea la subsección debajo de para obtener más información sobre la estructura de este objeto.
adViewability
Objeto
Registra el número de impresiones que ven los usuarios finales, como el volumen del reproductor, la versión de la biblioteca, el estado de la ventana y las dimensiones de la ventanilla de publicidad. Vea la subsección debajo de para obtener más información sobre la estructura de este objeto.
clicks
Medida
Número de acciones de clic en el anuncio.
completes
Medida
El número de veces que un recurso de medios cronometrados se vio hasta su finalización. Esto no significa necesariamente que el usuario final haya visto todo el vídeo, ya que puede haberse saltado algunas partes.
conversions
Medida
El número de veces que una acción predefinida (o acciones) activó un evento para la evaluación del rendimiento.
federated
Medida
Indica si se creó un evento de experiencia mediante federación de datos, como el intercambio de datos entre clientes.
firstQuartiles
Medida
El número de veces que un anuncio de vídeo digital se ha reproducido al 25 % a velocidad normal.
impressions
Medida
El número de impresiones de publicidad enviadas a un usuario final con el potencial de ser visto.
midpoints
Medida
El número de veces que un anuncio de vídeo digital se ha reproducido al 50 % a velocidad normal.
starts
Medida
Número de veces que ha comenzado a reproducirse un anuncio de vídeo digital.
thirdQuartiles
Medida
El número de veces que un anuncio de vídeo digital se ha reproducido al 75 % a velocidad normal.
timePlayed
Medida
Cantidad de tiempo que un usuario final dedica a un recurso de medios cronometrados específico.
downloadedPlayback
Booleano
Cuando se establece en true, indica que la visita se genera debido a la reproducción de una sesión de anuncio descargado.

adAssetReference adAssetReference

El objeto adAssetReference captura información de recursos acerca del anuncio.

estructura adAssetReference

Propiedad
Tipo de datos
Descripción
_dc.title
Cadena
El nombre descriptivo y en lenguaje natural del recurso publicitario.
_xmpDM.duration
Entero
La duración del recurso en segundos.
_id
Cadena
Un identificador único del recurso de publicidad, que sigue el estándar de Ad-ID.
advertiser
Cadena
La compañía o marca cuyo producto aparece en el anuncio.
campaign
Cadena
El ID de la campaña de publicidad.
creativeID
Cadena
El ID de creatividad publicitaria.
creativeURL
Cadena
El URL de creatividad publicitaria.
placementID
Cadena
ID de colocación de la publicidad.
siteID
Cadena
El ID del sitio de publicidad.

adAssetViewDetails adAssetViewDetails

El objeto adAssetViewDetails captura los detalles de vista para la reproducción del anuncio.

estructura adAssetViewDetails

Propiedad
Tipo de datos
Descripción
adBreak
Pausa para anuncios
Describe cómo se inserta un anuncio cronometrado en medios cronometrados.
index
Entero
Índice de la publicidad dentro de la pausa para anuncios principal. Por ejemplo, el primer anuncio tiene el índice 0 y el segundo tiene el índice 1.
playerName
Cadena
El nombre del reproductor responsable de reproducir el anuncio.

adViewability adViewability

El objeto adViewability captura el número de impresiones que ven los usuarios finales, como el volumen del reproductor, la versión de la biblioteca, el estado de la ventana y las dimensiones de la ventanilla de publicidad.

estructura adViewability

Propiedad
Tipo de datos
Descripción
implementationDetails
Detalles de implementación
El nombre y la versión de la biblioteca instrumentada para medir las métricas de visibilidad.
measuredAdNotVisible
Medida
Indica que el anuncio no es visible según lo medido por una biblioteca de visibilidad en el momento de la impresión.
measuredMuted
Medida
Indica que el anuncio se silencia según lo medido por una biblioteca de visibilidad en el momento de la impresión.
unmeasurableIframe
Medida
Indica que el anuncio se muestra en una ventana inactiva según lo medido por una biblioteca de visibilidad en el momento de la impresión.
unmeasurableOther
Medida
Indica que la biblioteca de visibilidad no puede ejecutar las mediciones correctamente debido a que el anuncio se está mostrando dentro de un iframe.
viewabilityEligibleImpressions
Medida
Impresiones de un anuncio para un usuario final con biblioteca de visibilidad instrumentada.
viewabilityCompletes
Medida
Finalizaciones de un anuncio para un usuario final que una biblioteca de visibilidad considera que este puede ver a la hora de finalización.
viewableFirstQuartiles
Medida
Primer/os cuartil/es de un anuncio para un usuario final que una biblioteca de visibilidad considera que este puede ver en el primer cuartil.
viewableImpressions
Medida
Impresiones de un anuncio para un usuario final que una biblioteca de visibilidad considera que este puede tras dos segundos de reproducción.
viewableMidpoints
Medida
Puntos intermedios de un anuncio para un usuario final que una biblioteca de visibilidad considera que este puede ver a mitad del juego.
viewableThirdQuartiles
Medida
Tercer/os cuartil/es de un anuncio para un usuario final que una biblioteca de visibilidad considera que este puede ver en el tercer cuartil.
activeWindow
Booleano
Indica si el anuncio se mostró en la ventana activa del dispositivo del usuario.
adHeight
Entero
El número de píxeles verticales del reproductor, medidos en tiempo de ejecución. Este puede ser más grande que el tamaño del anuncio si el reproductor tiene controles o miniaturas adicionales.
adUnitDepth
Entero
Los editores pueden insertar bloques de anuncios en contenedores (iFrames) para limitar el acceso del anuncio únicamente al código de la página. Este valor describe en cuántos contenedores se muestra la unidad publicitaria.
adWidth
Entero
El número de píxeles horizontales del reproductor, medidos en tiempo de ejecución. Este puede ser más grande que el tamaño del anuncio si el reproductor tiene controles o miniaturas adicionales.
measurementEligible
Booleano
Si el anuncio se podía incluir o no en la medición de la visibilidad. Un anuncio tiene opciones si la unidad tiene un formato de creatividad y un tipo de etiqueta compatibles.
percentViewable
Entero
Porcentaje de píxeles del anuncio que se consideran visibles en el momento de tomar la medida.
playerVolume
Entero
Porcentaje de volumen del reproductor medido en tiempo de ejecución, donde 0 está en silencio y 100 es el volumen máximo.
viewable
Booleano
Indica si el anuncio se pudo ver durante la ejecución. Los anuncios de visualización se consideran visibles cuando al menos el 50 % del anuncio es visible durante un segundo. Los anuncios de vídeo se consideran visibles cuando al menos el 50 % del anuncio es visible mientras el vídeo se reproduce durante al menos dos segundos consecutivos.
viewportHeight
Entero
El tamaño vertical (en píxeles) de la ventana en la que se mostró la experiencia, medido en tiempo de ejecución. Para un evento de visualización web, este valor indica la altura de la ventana del explorador.
viewportWidth
Entero
El tamaño horizontal (en píxeles) de la ventana en la que se mostró la experiencia, medido en tiempo de ejecución. Para un evento de visualización web, este valor indica la anchura de la ventanilla del explorador.

Para obtener más información sobre el grupo de campos, consulte el repositorio XDM público.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07