Parámetros de solicitud

Datos de análisis

Clave de solicitud Requerido Establecer en… Descripción
analytics.trackingServer Y sessionStart La URL del servidor de Adobe Analytics
analytics.reportSuite Y sessionStart El ID que identifica los datos de los informes de Analytics
analytics.enableSSL N sessionStart Verdadero o falso para activar SSL
analytics.visitorId N sessionStart El ID de visitante de Adobe es un ID personalizado que se puede utilizar en varias aplicaciones de Adobe. Heartbeat visitorId es igual a Analytics VID.

Datos del visitante

Clave de solicitud Requerido Establecer en… Descripción
visitor.marketingCloudOrgId Y sessionStart El ID de organización de Experience Cloud indentifica su organización en el sistema de Adobe Experience Cloud
visitor.marketingCloudUserId N sessionStart Este es el ID de usuario de Experience Cloud (ECID). En la mayoría de los casos, este es el ID que debe utilizar para identificar a un usuario. Heartbeat marketingCloudUserId es igual a MID en Adobe Analytics. Aunque técnicamente no es obligatorio, este parámetro es necesario para acceder a la familia de aplicaciones de Experience Cloud.
visitor.aamLocationHint N sessionStart Proporciona datos de Adobe Audience Manager Edge
appInstallationId N sessionStart La clase appInstallationId identifica exclusivamente la aplicación y el dispositivo

Datos de contenido

Clave de solicitud Requerido Establecer en… Descripción
media.id Y sessionStart Identificador único para el contenido
media.name N sessionStart Nombre reconocible para el contenido
media.length Y sessionStart Longitud del contenido (segundos)
media.contentType Y sessionStart Formato de la emisión (puede ser cualquier cadena, algunos valores recomendados son "en directo", "VOD" o "Lineal")
media.playerName Y sessionStart Nombre del reproductor responsable de la renderización del contenido
media.channel Y sessionStart Canal de distribución del contenido. Podría ser un nombre de aplicación móvil o un nombre de sitio Web, un nombre de propiedad
media.resume N sessionStart Indica si un usuario está reanudando o no una sesión anterior (en lugar de iniciar una nueva)
media.sdkVersion N sessionStart La versión de SDK utilizada por el reproductor

Metadatos de contenido estándar

Clave de solicitud Requerido Establecer en… Descripción
media.streamFormat N sessionStart Formato del flujo, por ejemplo "HD"
media.show N sessionStart El nombre del programa o serie
media.season N sessionStart La temporada a la que pertenece el programa o la serie
media.episode N sessionStart El número del episodio
media.assetId N sessionStart El identificador exclusivo del contenido del recurso de vídeo, como el identificador de episodio de series de TV, el identificador de recursos de una película o el identificador de eventos en directo. Normalmente, estos ID se derivan de autoridades de metadatos como EIDR, TMS/Gracenote o Rovi. Estos identificadores también pueden proceder de otros sistemas propietarios o internos.
media.genre N sessionStart El tipo de contenido definido por el productor de contenido
media.firstAirDate N sessionStart La fecha en la que el contenido se emitió por primera vez en televisión
media.firstDigitalDate N sessionStart La fecha en la que el contenido se emitió por primera vez en cualquier plataforma digital
media.rating N sessionStart Clasificación según las pautas de clasificación por edades de la TV
media.originator N sessionStart El creador del contenido
media.network N sessionStart Nombre de la plataforma o canal
media.showType N sessionStart El tipo de contenido, expresado con un número entero entre 0 y 3:
  • 0 - Episodio completo
  • 1 - Vista previa
  • 2 - Clip
  • 3 - Otros
media.adLoad N sessionStart El tipo de publicidad cargada
media.pass.mvpd N sessionStart La MVPD proporcionada por la autentificación de Adobe
media.pass.auth N sessionStart Indica que Adobe ha autorizado el usuario (solo puede ser verdadero si está configurado)
media.dayPart N sessionStart Hora del día en que se emite el contenido
media.feed N sessionStart El tipo de fuente, por ejemplo, "West-HD"

Datos de publicidad

Clave de solicitud Requerido Establecer en… Descripción
media.ad.podFriendlyName N adBreakStart Nombre reconocible de la pausa publicitaria
media.ad.podIndex Y adBreakStart Índice de pod de anuncios en el vídeo
media.ad.podSecond Y adBreakStart El segundo en el que comenzó el pod
media.ad.podPosition Y adStart Índice de la publicidad dentro de la pausa publicitaria comenzando en 1
media.ad.name N adStart Nombre descriptivo del anuncio
media.ad.id Y adStart Nombre de la publicidad
media.ad.length Y adStart Longitud del vídeo publicitario, en segundos
media.ad.playerName Y adStart Nombre del reproductor responsable de procesar el anuncio

Metadatos estándar de publicidad

Clave de solicitud Requerido Establecer en… Descripción
media.ad.advertiser N adStart Empresa o marca cuyo producto aparece en el anuncio
media.ad.campaignId N adStart ID de la campaña de publicidad
media.ad.creativeId N adStart El ID del creador de la publicidad
media.ad.siteId N adStart ID del sitio de publicidad
media.ad.creativeURL N adStart La dirección URL del creador de la publicidad
media.ad.placementId N adStart ID de colocación de la publicidad

Datos de capítulo

Clave de solicitud Requerido Establecer en… Descripción
media.chapter.index Y chapterStart Identifica la posición del capítulo en el contenido
media.chapter.offset Y chapterStart El segundo de la reproducción en el que comienza el capítulo
media.chapter.length Y chapterStart Duración del capítulo en segundos
media.chapter.friendlyName N chapterStart Nombre reconocible del capítulo

Datos de calidad

Clave de solicitud Requerido Establecer en… Descripción
media.qoe.bitrate N Cualquiera Velocidad de bits de la emisión
media.qoe.droppedFrames N Cualquiera Número de fotogramas perdidos en la emisión
media.qoe.framesPerSecond N Cualquiera Número de fotogramas por segundo
media.qoe.timeToStart N Cualquiera Cantidad de tiempo (en milisegundos) transcurrido entre el momento en que el usuario pulsa el botón Reproducir y el momento en que se carga el contenido y se reproduce

Parámetros de la Ley de privacidad del consumidor de California (CCPA)

Clave de solicitud Requerido Establecer en… Descripción
analytics.optOutServerSideForwarding N sessionStart Se establece en true cuando el usuario final ha optado por no compartir sus datos entre Adobe Analytics y otras soluciones de Experience Cloud (por ejemplo, Audience Manager)
analytics.optOutShare N sessionStart Se establece en true cuando el usuario final ha optado por no publicar sus datos (por ejemplo, para otros clientes de Adobe Analytics).

Detalles adicionales

visitor.marketingCloudUserId

Pase el ID de usuario de Experience Cloud (también conocido como MID o MCID) en la llamada a sessionStart, incluyéndolo en el mapa de params mediante la siguiente clave: visitor.marketingCloudUserId. Esta función es útil si ya se integra con otros productos de Experience Cloud y ya se ha obtenido el MCID.

NOTA

Media Analytics (MA) está integrado con la gama de aplicaciones de Experience Cloud (Adobe Analytics, Audience Manager, Target, etc.). Necesita un Experience Cloud ID para acceder a estas aplicaciones. El ECID es lo que debe utilizarse para identificar a los usuarios en la mayoría de los casos.

appInstallationId

  • Si no transmite appInstallationId como un valor: El servidor back-end de MA dejará de generar una MCID y, en su lugar, dependerá de Adobe Analytics para hacerlo. La recomendación de Adobe es enviar una MCID si está disponible, o bien una appInstallationId (junto con la marketingCloudOrgId obligatoria) para que la API de Media Collection genere la MCID y la envíe en todas las llamadas.

  • Si transmite el valor appInstallationId: El MCID puede generarse en el final de MA si transmite valores para los parámetros appInstallationId y marketingCloudOrgId (obligatorios). Si transmite appInstallationId usted mismo, debe mantener su valor en el lado del cliente. Debe ser exclusivo de la aplicación en un dispositivo y persistente durante todo el tiempo en que la aplicación no se reinstale.

NOTA

appInstallationId identifica exclusivamente la aplicación y el dispositivo. Debe ser exclusivo para cada aplicación en cada dispositivo, es decir, dos usuarios que utilicen la misma versión de la misma aplicación en distintos dispositivos deben enviar un appInstallationId diferente (exclusivo).

visitor.marketingCloudOrgId

Además de ser necesario para generar MCID cuando no se proporciona, este parámetro se utiliza también como el valor del ID del editor (en los que Media Analytics lleva a cabo la coincidencia de reglas de federación.)

ID de usuario heredado de Analytics (ayuda) e ID de usuario declarado (customerIDs)

  • analytics.aid:

    el valor de esta clave debe ser una cadena que represente el ID de usuario heredado de Analytics

  • visitor.customerIDs:

    el valor de esta clave debe ser un objeto con el formato siguiente:

    "<<insert your ID name here>>": {  
      "id": " <<insert your id here>>",  
       "authState": <<insert one of 0, 1, 2>>
    }
    

Tenga en cuenta que el valor de visitor.customerIDs puede tener cualquier número de objetos en el formato presentado.

visitor.aamLocationHint

Este parámetro indica qué Adobe Audience Manager (AAM) se inicia cuando Adobe Analytics envía los datos del cliente a Audience Manager. Si no pasa este parámetro, Adobe lo codifica como 1. Esto es particularmente importante cuando los usuarios finales tienden a utilizar sus dispositivos en ubicaciones geográficamente distantes (por ejemplo, EE. UU.-Este, EE. UU.-Oeste, Europa o Asia). De lo contrario, los datos de usuario se distribuirán en varios perímetros de AAM.

media.resume

Si la aplicación determina que se ha cerrado una sesión y después se reanuda, por ejemplo, cuando el usuario abandonó el vídeo pero regresa y el reproductor reanuda el vídeo desde la última posición del cabezal, puede enviar un parámetro booleano media.resume opcional dentro del bloque de parámetros de la llamada sessionStart.

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now