DocumentaciónAnalyticsGuía de colección de medios de streaming

Parámetros de anuncio ad-parameters

Last update: Fri Oct 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario
  • Administrador
  • Desarrollador

En este tema se presenta una lista de datos de anuncios de vídeo, incluidos los valores de datos de contexto, que Adobe recopila a través de variables de solución.

Descripción de los datos de la tabla:

  • Implementación: Información sobre los valores y requisitos de implementación.

    • Clave: Variable establecida manualmente en la aplicación o automáticamente por el SDK de Adobe Media.
    • Obligatorio:  Indica si el parámetro es necesario para el seguimiento de vídeo básico.
    • Tipo: Especifica el tipo de la variable que se va a establecer, la cadena o el número.
    • Enviado con: indica cuándo se envían los datos: Inicio de contenidos es la llamada de análisis enviada al inicio del contenido, Inicio de publicidad es la llamada de análisis enviada al iniciar el anuncio, etc., las llamadas Cierre son llamadas de análisis compiladas enviadas directamente desde el servidor de latidos al servidor de análisis al final de la sesión de contenido, o al final del anuncio, capítulo, etc. Las llamadas Cierre no están disponibles en las llamadas a paquetes de red.
    • Mínima Versión del SDK: Indica la versión del SDK a la que debería acceder el parámetro.
    • Valor de muestra:  Proporciona un ejemplo del uso común de variables.

  • Parámetros de red: Muestra los valores que se pasan a los servidores de Adobe Analytics o Heartbeat. Esta columna muestra los nombres de los parámetros que se ven en las llamadas de red generadas por los Media SDK de Adobe.

  • Sistema de informes: Información sobre cómo ver y analizar datos de vídeo.

    • Disponible: Indica si los datos están disponibles en el sistema de informes de forma predeterminada (Sí) o si requieren una configuración personalizada (Personalizado)
    • Variable reservada:  Indica si los datos se capturan como un evento, una eVar, una propiedad o una clasificación en una variable reservada.
    • Nombre del informe:  Nombre del informe de Adobe Analytics para la variable
    • Datos de contexto:  Nombre de los datos de contexto de Adobe Analytics pasados al servidor de sistema de informes y utilizados en reglas de procesamiento.
    • Fuente de datos:  Nombre de columna para la variable que se encuentra en las fuentes de datos de flujo de navegación o flujo en directo.
    • Audience Manager: Nombre de la función de Adobe Audience Manager.
IMPORTANT
No cambie los nombres de clasificación de ninguna de las variables enumeradas a continuación que
se describan en Informes/Variables reservadas como “clasificación”.
Las clasificaciones de contenidos se definen cuando un grupo de informes está habilitado para los contenidos
seguimiento. De vez en cuando, Adobe agrega nuevas propiedades y, cuando esto sucede,
los clientes deben volver a habilitar sus grupos de informes para obtener acceso a las nuevas
propiedades de contenidos. Durante el proceso de actualización, Adobe determina si las
clasificaciones están habilitadas comprobando los nombres de las variables. Si alguna de ellas
falta, Adobe las agrega de nuevo.

Datos de vídeo de anuncio ad-video-data

ID de anuncio

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    adId
  • Clave de API:
    media.ad.id
  • Requerido:
    sí
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     “2125”
  • Descripción:
    ID del anuncio. (Cualquier combinación de cifras y/o letras)
  • Adobe Analytics:
    (a.media.ad.
    name)
  • Latido:
    (s:asset:ad_id)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según VISIT
  • Nombre del informe:
    Anuncio
  • Datos de contexto:
    (a.media.ad.
    name)
  • Fuente de datos:
    videoad
  • Audience Manager:
    (c_contextdata.
    a.media.ad.name)
  • Ruta de campo XDM:
    advertising.adAssetReference.@id
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.name
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.name

Posición del anuncio en la secuencia

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    position
  • Clave de API:
    media.ad.podPosition
  • Requerido:
    sí
  • Tipo:
    número
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     1
  • Descripción:
    La posición (índice) del anuncio dentro del salto de anuncio principal. El primer anuncio tiene el índice 0, el segundo tiene el índice 1, etc.
  • Adobe Analytics:
    (a.media.ad.
    podPosition)
  • Latido:
    (s:asset:pod_position)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Posición del anuncio en la secuencia
  • Datos de contexto:
    (a.media.ad.
    podPosition)
  • Fuente de datos:
    videoadinpod
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podPosition)
  • Ruta de campo XDM:
    advertising.adAssetViewDetails.index
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.podPosition
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.podPosition

Duración del anuncio

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    length
  • Clave de API:
    media.ad.length
  • Requerido:
    sí
  • Tipo:
    número
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.1
  • Valor de muestra:
     “15”
  • Descripción:
    Duración del anuncio de vídeo en segundos.
  • Adobe Analytics:
    (a.media.ad.
    length)
  • Latido:
    (l:asset:ad_length)
  • Disponible:
    sí
  • Variable reservada:
    eVar y clasificación
  • Caducidad:
    según HIT
  • Nombre del informe:
    Duración del anuncio y Duración del anuncio (variable)
  • Datos de contexto:
    (a.media.ad.
    length)
  • Fuente de datos:
    videoadlength
  • Audience Manager:
    (c_contextdata.
    a.media.ad.length)
  • Ruta del campo XDM:
    advertising.adAssetReference.
    xmpDM:duration
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.length
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.length

Nombre del reproductor del anuncio

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    playerName
  • Clave de API:
    media.ad.playerName
  • Requerido:
    sí
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     “Freewheel”
  • Descripción:
    Nombre del reproductor responsable de procesar el anuncio.
  • Adobe Analytics:
    (a.media.ad.
    playerName)
  • Heartbeat:
    (s:sp:player_name)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Nombre del reproductor del anuncio
  • Datos de contexto:
    (a.media.ad.
    playerName)
  • Fuente de datos:
    videoadplayername
  • Audience Manager:
    (c_contextdata.
    a.media.ad.playerName)
  • Ruta de campo XDM:
    advertising.adAssetViewDetails.playerName
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.
    playerName
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.
    playerName

Nombre del desglose de anuncios

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    name
  • Clave de API:
    media.ad.podFriendlyName
  • Obligatorio:
    SDK: Sí; API: No.
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     “anuncio previo a la emisión”
  • Descripción:
    Nombre descriptivo del desglose de anuncios.
  • Adobe Analytics:
    (a.media.ad.
    podFriendlyName)
  • Heartbeat:
    (s:asset:pod_name)
  • Disponible:
    sí
  • Variable reservada:
    clasificación
  • Nombre del informe:
    Nombre de secuencia
  • Datos de contexto:
    (a.media.ad.
    podFriendlyName)
  • Fuente de datos:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podFriendlyName)
  • Ruta del campo XDM:
    advertising.adAssetViewDetails.
    adBreak.dc:title
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingPodDetails.
    friendlyName
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingPodDetails.
    friendlyName

Índice del desglose de anuncios

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    position
  • Clave de API:
    media.ad.podIndex
  • Requerido:
    sí
  • Tipo:
    número
  • Enviado con:
  • Mínima mínima: cualquiera
  • Valor de muestra:
     1
  • Descripción:
    ​Índice de desglose de anuncios dentro del contenido que comienza en 1. Esta propiedad la utiliza  solo  el Media SDK para generar el ID de la secuencia.
  • Adobe Analytics:
  • Heartbeat:
  • Disponible:
    no
  • Variable reservada:
    N/D
  • Nombre del informe:
    N/D
  • Datos de contexto:
  • Fuente de datos:
    N/D
  • Audience Manager:
  • Ruta de campo XDM:
    advertising.adAssetViewDetails.index
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingPodDetails.index

Posición de desglose de anuncios

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    startTime
  • Clave de API:
    media.ad.podSecond
  • Requerido:
    sí
  • Tipo:
    número
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     90
  • Descripción:
    El desplazamiento del desglose de anuncios dentro del contenido, en segundos.
  • Adobe Analytics:
    (a.media.ad.
    podSecond)
  • Latido:
    (l:asset:pod_offset)
  • Disponible:
    sí
  • Variable reservada:
    clasificación
  • Nombre del informe:
    Posición de secuencia
  • Datos de contexto:
    (a.media.ad.
    podSecond)
  • Fuente de datos:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podSecond)
  • Ruta del campo XDM:
    advertising.adAssetViewDetails.adBreak.
    offset
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingPodDetails.
    offset
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingPodDetails.
    offset

ID de desglose de anuncios

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    establecida automáticamente
  • Clave de API:
    N/D
  • Requerido:
    sí
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     c4a577424c84067899b807c76722d495_1
  • Adobe Analytics:
    (a.media.ad.
    pod)
  • Latido:
    (s:asset:pod_id)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Pod de anuncios
  • Datos de contexto:
    (a.media.ad.
    pod)
  • Fuente de datos:
    videoadpod
  • Audience Manager:
  • Ruta de campo XDM:
    advertising.adAssetViewDetails.adBreak.@id
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingPodDetails.
    ID

Nombre de publicidad

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    name
  • Clave de API:
    media.ad.name
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.1
  • Valor de muestra:
     “Ford F-150”
  • Descripción:
    Nombre descriptivo del desglose de anuncios. En los informes, “Nombre del anuncio” es la clasificación y “Nombre del anuncio (variable)” es la eVar.
  • Adobe Analytics:
    (a.media.ad.
    friendlyName)
  • Latido:
    (s:asset:ad_name)
  • Disponible:
    sí
  • Variable reservada:
    eVar y clasificación
  • Caducidad:
    según HIT
  • Nombre del informe:
    Nombre del anuncio y Nombre del anuncio (variable)
  • Datos de contexto:
    (a.media.ad.
    friendlyName)
  • Fuente de datos:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.friendlyName)
  • Ruta de campo XDM:
    advertising.adAssetReference.dc:title
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.friendlyName
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.friendlyName

Metadatos de anuncio estándar standard-ad-metadata

Anunciante

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    ADVERTISER
  • Clave de API:
    media.ad.advertiser
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.7
  • Valor de muestra:
  • Descripción:
    Empresa/marca de cuyo producto se hace publicidad en el anuncio.
  • Adobe Analytics:
    (a.media.ad.
    advertiser)
  • Latido:
    (s:meta:
    a.media.ad.advertiser)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Anunciante
  • Datos de contexto:
    (a.media.ad.
    advertiser)
  • Fuente de datos:
    videoadvertiser
  • Audience Manager:
    (c_contextdata.
    a.media.ad.advertiser)
  • Ruta de campo XDM:
    advertising.adAssetReference.advertiser
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.advertiser
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.advertiser

ID de campaña

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    CAMPAIGN_ID
  • Clave de API:
    media.ad.campaignId
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.7
  • Valor de muestra:
     Total o nombre (cadena).
  • Descripción:
    ID de la campaña de publicidad.
  • Adobe Analytics:
    (a.media.ad.
    campaign)
  • Latido:
    (s:meta:
    a.media.ad.campaign)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    ID de campaña
  • Datos de contexto:
    (a.media.ad.
    campaign)
  • Fuente de datos:
    videocampaign
  • Audience Manager:
    (c_contextdata.
    a.media.ad.campaign)
  • Ruta de campo XDM:
    advertising.adAssetReference.campaign
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.
    campaignID
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.
    campaignID

ID del creativo

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    CREATIVE_ID
  • Clave de API:
    media.ad.creativeId
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.7
  • Valor de muestra:
     Total o nombre (cadena).
  • Descripción:
    ID del creativo de publicidad.
  • Adobe Analytics:
    (a.media.ad.
    creative)
  • Latido:
    (s:meta:
    a.media.ad.creative)
  • Disponible:
    sí
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    ID del creativo
  • Datos de contexto:
    (a.media.ad.
    creative)
  • Fuente de datos:
    adclassificationcreative
  • Audience Manager:
    (c_contextdata.
    a.media.ad.creative)
  • Ruta de campo XDM:
    advertising.adAssetReference.creativeID
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.creativeID
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.creativeID

ID del sitio

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    SITE_ID
  • Clave de API:
    media.ad.siteId
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.7
  • Valor de muestra:
  • Descripción:
    ID del sitio de publicidad.
  • Adobe Analytics:
    (a.media.ad.
    site)
  • Latido:
    (s:meta:
    a.media.ad.site)
  • Disponible:
    Utilizar regla de procesamiento personalizada
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Personalizado
  • Datos de contexto:
    (a.media.ad.
    site)
  • Fuente de datos:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.site)
  • Ruta de campo XDM:
    advertising.adAssetReference.siteID
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.siteID
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.siteID

URL del anuncio

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    CREATIVE_URL
  • Clave de API:
    media.ad.creativeURL
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.7
  • Valor de muestra:
  • Descripción:
    URL del creativo de publicidad.
  • Adobe Analytics:
    (a.media.ad.
    creativeURL)
  • Heartbeat:
    (s:meta:<c/ode> a.media.ad.creativeURL) ``
  • Disponible:
    Utilizar regla de procesamiento personalizada
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Personalizado
  • Datos de contexto:
    (a.media.ad.
    creativeURL)
  • Fuente de datos:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.creativeURL)
  • Ruta de campo XDM:
    advertising.adAssetReference.creativeURL
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.
    creativeURL
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.
    creativeURL

ID de colocación

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    PLACEMENT_ID
  • Clave de API:
    media.ad.placementId
  • Requerido:
    no
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad, cierre de publicidad
  • Mínima mínima: 1.5.7
  • Valor de muestra:
  • Descripción:
    ID de colocación de la publicidad.
  • Adobe Analytics:
    (a.media.ad.
    placement)
  • Latido:
    (s:meta:
    a.media.ad.placement)
  • Disponible:
    Utilizar regla de procesamiento personalizada
  • Variable reservada:
    eVar
  • Caducidad:
    según HIT
  • Nombre del informe:
    Personalizado
  • Datos de contexto:
    (a.media.ad.
    placement)
  • Fuente de datos:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.placement)
  • Ruta de campo XDM:
    advertising.adAssetReference.placementID
  • Ruta del campo XDM de recopilación:
    mediaCollection.advertisingDetails.
    placementID
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.
    placementID

Métricas del anuncio ad-metrics

Inicio del anuncio

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    establecida automáticamente
  • Clave de API:
    N/D
  • Requerido:
    sí
  • Tipo:
    cadena
  • Enviado con:
    inicio de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     “TRUE”
  • Descripción:
    Número de inicios de anuncios de vídeo.
  • Adobe Analytics:
    (a.media.ad.
    view)
  • Heartbeat:
    (s:event:type=start)
    (s:asset:type=ad) ``
  • Disponible:
    sí
  • Variable reservada:
    evento
  • Nombre del informe:
    Inicios de publicidad
  • Fuente de datos:
    N/D
  • Datos de contexto:
    (a.media.ad.
    view)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.view)
  • Ruta de campo XDM:
    advertising.starts.value > 0 => “TRUE”
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.isStarted

Publicidad completa

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    establecida automáticamente
  • Clave de API:
    N/D
  • Requerido:
    sí
  • Tipo:
    cadena
  • Enviado con:
    cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     “TRUE”
  • Descripción:
    Número de anuncios de vídeo completados.
  • Adobe Analytics:
    (a.media.ad.
    complete)
  • Heartbeat:
    (s:event:type=complete)
    (s:asset:type=ad)
  • Disponible:
    sí
  • Variable reservada:
    evento
  • Nombre del informe:
    Finalizaciones de publicidad
  • Fuente de datos:
    N/D
  • Datos de contexto:
    (a.media.ad.
    complete)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.complete)
  • Ruta de campo XDM:
    advertising.completes.value > 0 => “TRUE”
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.
    isCompleted

Tiempo invertido en publicidad

Implementación
Parámetros de red
Creación de informes
  • Clave de SDK:
    establecida automáticamente
  • Clave de API:
    N/D
  • Requerido:
    sí
  • Tipo:
    cadena
  • Enviado con:
    cierre de publicidad
  • Mínima mínima: cualquiera
  • Valor de muestra:
     15
  • Descripción:
    Cantidad total de tiempo, en segundos, que se emplea para mirar la publicidad (es decir, el número de segundos reproducidos). El valor se mostrará con formato de hora (HH:MM:SS) en Analysis Workspace y Reports & Analytics. En las fuentes de datos, el Data Warehouse y las API de informes, los valores se mostrarán en segundos.
    Fecha de la versión: 13/9/18
  • Adobe Analytics:
    (a.media.ad.
    timePlayed)
  • Heartbeat:
  • Disponible:
    sí
  • Variable reservada:
    evento
  • Nombre del informe:
    Tiempo invertido en publicidad
  • Fuente de datos:
    N/D
  • Datos de contexto:
    (a.media.ad.
    timePlayed)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.timePlayed)
  • Ruta de campo XDM:
    advertising.timePlayed.value
  • Ruta del campo XDM de creación de informes:
    mediaReporting.advertisingDetails.
    timePlayed

API createAdObject:

API createAdBreakObject:

API MediaHeartbeatConfig:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb