Show Menu
TOPICS×

Parámetros de solicitud

Datos de análisis

Clave de solicitud 
Requerido
Definir 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
Definir 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
Definir 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 de un sitio web, 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
Definir en...
 Descripción 
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 del episodio de la serie de TV, de la película o del evento en directo. Estos ID se derivan de autoridades de metadatos como EIDR, TMS/Gracenote o Rovi. Estos identificadores también pueden ser de otros sistemas privados 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
Tipo de contenido, expresado como 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
Definir 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
Definir 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
Definir 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
Definir en...
 Descripción 
media.qoe.bitrate
N
Cualquiera
Velocidad de bits de la emisión
media.qoe.droppedFrames
N
Cualquiera
El 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
La cantidad de tiempo (en milisegundos) entre el momento en que el usuario inicia la reproducción y la carga y comienzo del contenido

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

Clave de solicitud 
Requerido
Definir 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.
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.
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 transmite este parámetro, Adobe le asigna el valor 1 en el código. Esto es especialmente importante cuando los usuarios finales tienden a utilizar sus dispositivos en ubicaciones distantes geográficamente (por ejemplo, las costas de EE. UU., Europa, Asia). De lo contrario, los datos del usuario se esparcirán en varios límites 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
.