Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
analytics.trackingServer |
O | string | sessionStart |
URL de votre serveur Adobe Analytics |
analytics.reportSuite |
O | string | sessionStart |
ID identifiant vos données de rapport d’Analytics |
analytics.enableSSL |
N | booléen | sessionStart |
True ou false pour activer SSL |
analytics.visitorId |
N | string | sessionStart |
L’identifiant visiteur Adobe est un ID personnalisé que vous pouvez utiliser dans plusieurs applications Adobe. La pulsation visitorId est égale au VID. Analytics |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
visitor.marketingCloudOrgId |
O | string | sessionStart |
Identifiant d’entreprise Experience Cloud ; identifie votre organisation dans l’écosystème Adobe Experience Cloud |
visitor.marketingCloudUserId |
N | string | sessionStart |
Il s’agit de l’identifiant utilisateur Experience Cloud (ECID). Dans la plupart des cas, il s’agit de l’identifiant que vous devez utiliser pour identifier un utilisateur. La pulsation marketingCloudUserId est égale au MID dans Adobe Analytics. Bien que cela ne soit pas techniquement requis, ce paramètre est nécessaire pour accéder à la famille d’applications Experience Cloud. |
visitor.aamLocationHint |
N | entier | sessionStart |
Fournit des données Adobe Audience Manager Edge : si aucune valeur nʼest saisie, la valeur est nulle. |
appInstallationId |
N | string | sessionStart |
L’ID appInstallationId identifie de manière unique l’application et l’appareil |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
media.id |
O | string | sessionStart |
Identifiant unique du contenu |
media.name |
N | string | sessionStart |
Nom du contenu lisible par l’homme |
media.length |
O | number | sessionStart |
Durée du contenu (secondes) |
media.contentType |
O | string | sessionStart |
Format de la diffusion (peut correspondre à n’importe quelle chaîne ; quelques valeurs recommandées sont "live", "VOD" ou "Linear") |
media.playerName |
O | string | sessionStart |
Nom du lecteur responsable du rendu du contenu |
media.channel |
O | string | sessionStart |
Chaîne de distribution du contenu. Il peut s’agir du nom d’une application, d’un site web, d’un nom de propriété, etc. |
media.resume |
N | booléen | sessionStart |
Indique si un utilisateur reprend ou non une session précédente (au lieu de commencer une nouvelle session). |
media.sdkVersion |
N | string | sessionStart |
Version SDK utilisée par le lecteur |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
media.streamFormat |
N | string | sessionStart |
Format du flux, par exemple « HD » |
media.show |
N | string | sessionStart |
Nom du programme ou de la série |
media.season |
N | string | sessionStart |
Numéro de la saison à laquelle le programme ou la série appartient |
media.episode |
N | string | sessionStart |
Numéro de l’épisode |
media.assetId |
N | string | sessionStart |
L’identifiant unique du contenu de la ressource vidéo, tel que l’identifiant d’épisode de la série télévisée, l’identifiant de la ressource de film ou l’identifiant d’événement en direct. En règle générale, ces identifiants sont issus des autorités de métadonnées telles que EIDR, TMS/Gracenote ou Rovi. Ces identifiants peuvent également provenir d’autres systèmes propriétaires ou internes. |
media.genre |
N | string | sessionStart |
Type de contenu tel que défini par le producteur de contenu |
media.firstAirDate |
N | string | sessionStart |
Date à laquelle le contenu a été diffusé à la télévision pour la première fois |
media.firstDigitalDate |
N | string | sessionStart |
Date à laquelle le contenu a été diffusé pour la première fois sur une chaîne ou une plateforme numérique |
media.rating |
N | string | sessionStart |
Évaluation telle que définie par les directives parentales de la télévision |
media.originator |
N | string | sessionStart |
Créateur du contenu |
media.network |
N | string | sessionStart |
Nom du réseau/canal |
media.showType |
N | string | sessionStart |
Type de contenu, exprimé sous la forme d’un nombre entier compris entre 0 et 3 :
|
media.adLoad |
N | string | sessionStart |
Type de publicité chargée |
media.pass.mvpd |
N | string | sessionStart |
MVPD fourni par l’authentification Adobe |
media.pass.auth |
N | string | sessionStart |
Indique que l’utilisateur a été autorisé par l’authentification Adobe (peut uniquement avoir la valeur true si défini) |
media.dayPart |
N | string | sessionStart |
Heure de la journée à laquelle le contenu a été diffusé |
media.feed |
N | string | sessionStart |
Type de flux, tel que "West-HD" |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
media.ad.podFriendlyName |
N | string | adBreakStart |
Nom convivial de la coupure publicitaire |
media.ad.podIndex |
O | entier | adBreakStart |
Index de la capsule publicitaire dans la vidéo |
media.ad.podSecond |
O | number | adBreakStart |
Seconde à laquelle la capsule a commencé |
media.ad.podPosition |
O | entier | adStart |
Index de la publicité dans la coupure publicitaire commençant à 1 |
media.ad.name |
N | string | adStart |
Nom convivial de la publicité |
media.ad.id |
O | string | adStart |
Nom de la publicité |
media.ad.length |
O | number | adStart |
Durée de la publicité vidéo en secondes |
media.ad.playerName |
O | string | adStart |
Nom du lecteur responsable du rendu de la publicité |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
media.ad.advertiser |
N | string | adStart |
Entreprise ou marque dont le produit apparaît dans la publicité |
media.ad.campaignId |
N | string | adStart |
ID de la campagne publicitaire |
media.ad.creativeId |
N | string | adStart |
ID de l’élément créatif publicitaire |
media.ad.siteId |
N | string | adStart |
ID du site publicitaire |
media.ad.creativeURL |
N | string | adStart |
URL de l’élément créatif publicitaire |
media.ad.placementId |
N | string | adStart |
Identifiant de référencement de la publicité |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
media.chapter.index |
O | entier | chapterStart |
Identifie la position du chapitre dans le contenu |
media.chapter.offset |
O | number | chapterStart |
Seconde dans la lecture à laquelle le chapitre commence |
media.chapter.length |
O | number | chapterStart |
Durée du chapitre en secondes |
media.chapter.friendlyName |
N | string | chapterStart |
Nom convivial du chapitre |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
media.qoe.bitrate |
N | entier | Tous | Le débit moyen (en bits/s). Ce débit moyen correspond à la valeur moyenne pondérée de toutes les valeurs de débit liées à la durée des lectures au cours d’une session de lecture. |
media.qoe.droppedFrames |
N | entier | Tous | Nombre d’images perdues dans la diffusion |
media.qoe.framesPerSecond |
N | entier | Tous | Nombre d’images par seconde |
media.qoe.timeToStart |
N | entier | Tous | Durée (en millisecondes) écoulée entre le moment où l’utilisateur lance la lecture et le contenu se charge et commence à être lu |
Clé de requête | Obligatoire | Clé de type de requête | Définir sur… | Description |
---|---|---|---|---|
analytics.optOutServerSideForwarding |
N | booléen | sessionStart |
Définissez cette variable sur « true » lorsque l’utilisateur final a choisi de ne pas partager ses données entre Adobe Analytics et d’autres solutions Experience Cloud (par exemple, Audience Manager). |
analytics.optOutShare |
N | booléen | sessionStart |
Définissez cette variable sur « true » lorsque l’utilisateur final a choisi de ne pas utiliser ses données pour la fédération (par exemple, pour d’autres clients Adobe Analytics). |
Transmettez l’identifiant utilisateur Experience Cloud (également appelé MID
ou MCID
) sur l’appel sessionStart
en l’incluant dans la carte params
à l’aide de la clé suivante : visitor.marketingCloudUserId. Cette fonctionnalité est utile si vous intégrez déjà d’autres produits Experience Cloud et avez déjà obtenu le MCID.
Media Analytics (MA) est intégré à la gamme d’applications Experience Cloud (Adobe Analytics, Audience Manager, Target, etc.). Vous avez besoin d’un Experience Cloud ID pour accéder à ces applications. L’ECID est ce que vous devez utiliser pour identifier les utilisateurs dans la plupart des scénarios.
Si vous ne transmettez pas de valeur appInstallationId
: Le serveur principal MA ne générera plus de MCID, mais à la place s’en remettra à Adobe Analytics pour cela. La recommandation d’Adobe est d’envoyer un MCID s’il est disponible, ou une valeur appInstallationId
(ainsi que la valeur marketingCloudOrgId
encore obligatoire) pour que l’API Media Collection génère le MCID et l’envoie sur tous les appels.
Si vous transmettez une valeur appInstallationId
: Le MCID peut être généré par le serveur principal MA, si vous transmettez des valeurs pour les paramètres appInstallationId
et marketingCloudOrgId
(obligatoire). Si vous transmettez la valeur appInstallationId
vous-même, vous devez conserver sa valeur côté client. Elle doit être propre à l’application sur un appareil et doit être permanente tant que l’application n’est pas réinstallée.
Le appInstallationId
identifie de manière unique l’application et l’appareil. Elle doit être unique pour chaque application sur chaque appareil : deux utilisateurs utilisant la même version d’une même application sur différents appareils doivent chacun envoyer une valeur appInstallationId
différente (unique).
En plus d’être nécessaire à la génération du MCID lorsqu’il n’est pas fourni, ce paramètre est également utilisé comme valeur de l’identifiant d’éditeur (en fonction de l’instance multimédia Analytics qui procède à l’association des règles de fédération).
analytics.aid :
La valeur de cette clé doit être une chaîne représentant l’identifiant utilisateur Analytics existant
visitor.customerIDs :
La valeur de cette clé doit être un objet au format suivant :
"<<insert your ID name here>>": {
"id": " <<insert your id here>>",
"authState": <<insert one of 0, 1, 2>>
}
Notez que la valeur visitor.customerIDs
peut avoir un nombre quelconque d’objets au format présenté.
Ce paramètre indique quel edge Adobe Audience Manager (AAM) serait affecté lorsqu’Adobe Analytics envoie les données client à Audience Manager. Si aucune valeur n’est saisie, la valeur est nulle. Cela est particulièrement important lorsque les utilisateurs finaux tendent à utiliser leurs appareils à des emplacements géographiquement distants (par exemple, l’Est ou l’Ouest des États-Unis, l’Europe, l’Asie). Dans le cas contraire, les données utilisateur seront diffusées sur plusieurs edges AAM.
Si l’application détermine qu’une session a été fermée et reprise ultérieurement (par exemple, l’utilisateur a quitté la vidéo puis est revenu et le lecteur a repris la vidéo au curseur de lecture où il s’était arrêté), vous pouvez envoyer un paramètre media.resume booléen facultatif dans l’intervalle de paramètres de l’appel sessionStart
.