Paramètres de publicité

Cette rubrique présente une liste des données de publicité vidéo, y compris les valeurs de données contextuelles, qu’Adobe collecte via les variables de solution.

Description des données de tableau :

  • Mise en œuvre : informations sur les valeurs et les exigences de mise en œuvre.
    • Clé : variable, définie soit manuellement dans votre application, soit automatiquement par le SDK Adobe Media.
    • Obligatoire : indique si le paramètre est requis pour le suivi vidéo de base.
    • Type : indique le type de variable à définir, chaîne ou nombre.
    • Envoyé avec : Indique le moment où les données sont envoyées : Démarrage du média est l’appel d’analyse envoyé au début du média, Démarrage de la publicité est l’appel d’analyse envoyé au début de la publicité, etc. Fermer est l’appel d’analyse compilé envoyé directement du serveur de pulsation au serveur d’analyse à la fin de la session multimédia ou de la publicité, du chapitre, etc. Les appels Fermer ne sont pas disponibles dans les appels de paquets réseau.
    • Version minimum du SDK : indique la version du SDK dont vous aurez besoin pour accéder au paramètre.
    • Exemple de valeur : fournit un exemple d’utilisation de variables courantes.
  • Paramètres réseau : affiche les valeurs transmises aux serveurs Adobe Analytics ou Heartbeat. Cette colonne indique les noms des paramètres affichés dans les appels réseau générés par les SDK Adobe Media.
  • Reporting : informations sur la manière de visualiser et d’analyser les données vidéo.
    • Disponible : indique si les données sont disponibles par défaut dans les rapports (Oui) ou nécessitent une configuration personnalisée (Personnalisé).
    • Variable réservée : indique si les données sont capturées sous la forme d’un événement, d’une eVar, d’une prop ou d’une classification dans une variable réservée.
    • Nom du rapport : nom du rapport Adobe Analytics pour la variable.
    • Données contextuelles : nom des données contextuelles Adobe Analytics transmises au serveur de reporting et utilisées dans les règles de traitement.
    • Flux de données : nom de colonne de la variable trouvée dans les flux de données du parcours de navigation ou du flux de données en direct.
    • Audience Manager : nom de caractéristique trouvé dans Adobe Audience Manager.
IMPORTANT

Ne modifiez pas les noms de classification des variables répertoriées ci-dessous qui sont
décrits sous Variable de création de rapports/réservée comme « classification ».
Les classifications des médias sont définies lorsqu’une suite de rapports est activée pour les médias.
Suivi. De temps à autre, Adobe ajoute de nouvelles propriétés et, dans ce cas,
les clients doivent réactiver leurs suites de rapports pour accéder aux nouvelles propriétés
du média. Au cours du processus de mise à jour, Adobe détermine si les
classifications sont activées en vérifiant les noms des variables. Si l’un d’eux manque,
Adobe l’ajoute à nouveau.

Données de publicité vidéo

Identifiant de publicité

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    adId
  • Clé API :
    media.ad.id
  • Obligatoire :
    Oui
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     « 2125 »
  • Description :
    identifiant de la publicité. (Nombre entier et/ou combinaison de lettres)
  • Adobe Analytics :
    (a.media.ad.
    name)
  • Heartbeat :
    (s:asset:ad_id)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À la fin de la VISITE
  • Nom du rapport :
    Publicité
  • Données contextuelles :
    (a.media.ad.
    name)
  • Flux de données :
    videoad
  • Audience Manager :
    (c_contextdata.
    a.media.ad.name)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.@id
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.ID
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.ID

Position de la publicité dans la capsule

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    position
  • Clé API :
    media.ad.podPosition
  • Obligatoire :
    Oui
  • Type :
    Nombre
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     1
  • Description :
    Position (index) de la publicité dans la coupure publicitaire parente. La première publicité comporte l’index 0, la deuxième publicité l’index 1, etc.
  • Adobe Analytics :
    (a.media.ad.
    podPosition)
  • Heartbeat :
    (s:asset:pod_position)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Position de la publicité dans la capsule
  • Données contextuelles :
    (a.media.ad.
    podPosition)
  • Flux de données :
    videoadinpod
  • Audience Manager :
    (c_contextdata.
    a.media.ad.podPosition)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetViewDetails.index
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.index
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.index

Longueur de la publicité

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    length
  • Clé API :
    media.ad.length
  • Obligatoire :
    Oui
  • Type :
    Nombre
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.1
  • Exemple de valeur :
     « 15 »
  • Description :
    longueur de la publicité vidéo en secondes.
  • Adobe Analytics :
    (a.media.ad.
    length)
  • Heartbeat :
    (l:asset:ad_length)
  • Disponible :
    Oui
  • Variable réservée :
    eVar et classification
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Longueur de la publicité et Longueur de la publicité (variable)
  • Données contextuelles :
    (a.media.ad.
    length)
  • Flux de données :
    videoadlength
  • Audience Manager :
    (c_contextdata.
    a.media.ad.length)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.xmpDM:duration
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.length
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.length

Nom du lecteur de publicités

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    playerName
  • Clé API :
    media.ad.playerName
  • Obligatoire :
    Oui
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     « Freewheel »
  • Description :
    nom du lecteur responsable du rendu de la publicité.
  • Adobe Analytics :
    (a.media.ad.
    playerName)
  • Heartbeat :
    (s:sp:player_name)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Nom du lecteur de publicités
  • Données contextuelles :
    (a.media.ad.
    playerName)
  • Flux de données :
    videoadplayername
  • Audience Manager :
    (c_contextdata.
    a.media.ad.playerName)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetViewDetails.playerName
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.playerName
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.playerName

Nom de la coupure publicitaire

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    name
  • Clé API :
    media.ad.podFriendlyName
  • Obligatoire :
    SDK : Oui ; API : Non.
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     « pre-roll »
  • Description :
    nom convivial de la coupure publicitaire.
  • Adobe Analytics :
    (a.media.ad.
    podFriendlyName)
  • Heartbeat :
    (s:asset:pod_name)
  • Disponible :
    Oui
  • Variable réservée :
    Classification
  • Nom du rapport :
    Nom de la capsule
  • Données contextuelles :
    (a.media.ad.
    podFriendlyName)
  • Flux de données :
    S.O.
  • Audience Manager :
    (c_contextdata.
    a.media.ad.podFriendlyName)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetViewDetails.adBreak.dc:title
  • Collection XDM Field Path :
    mediaCollection.advertisingPodDetails.friendlyName
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingPodDetails.friendlyName

Index de la coupure publicitaire

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    position
  • Clé API :
    media.ad.podPosition
  • Obligatoire :
    Oui
  • Type :
    Nombre
  • Envoyé avec :
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     1
  • Description :
    index de la coupure publicitaire dans le contenu commençant à 1. Cette propriété est utilisée uniquement par le SDK Media pour générer l’identifiant de la capsule.
  • Adobe Analytics :
  • Heartbeat :
  • Disponible :
    Non
  • Variable réservée :
    S.O.
  • Nom du rapport :
    S.O.
  • Données contextuelles :
  • Flux de données :
    S.O.
  • Audience Manager :
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetViewDetails.index
  • Collection XDM Field Path :
    mediaCollection.advertisingPodDetails.index

Position de la coupure publicitaire

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    startTime
  • Clé API :
    media.ad.podSecond
  • Obligatoire :
    Oui
  • Type :
    Nombre
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     90
  • Description :
    décalage de la coupure publicitaire dans le contenu, en secondes.
  • Adobe Analytics :
    (a.media.ad.
    podSecond)
  • Heartbeat :
    (l:asset:pod_offset)
  • Disponible :
    Oui
  • Variable réservée :
    Classification
  • Nom du rapport :
    Position de la capsule
  • Données contextuelles :
    (a.media.ad.
    podSecond)
  • Flux de données :
    S.O.
  • Audience Manager :
    (c_contextdata.
    a.media.ad.podSecond)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetViewDetails.adBreak.offset
  • Collection XDM Field Path :
    mediaCollection.advertisingPodDetails.second
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingPodDetails.second

ID de coupure de publicité

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    Définie automatiquement
  • Clé API :
    S.O.
  • Obligatoire :
    Oui
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     c4a577424c84067899b807c76722d495_1
  • Adobe Analytics :
    (a.media.ad.
    pod)
  • Heartbeat :
    (s:asset:pod_id)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Capsule publicitaire
  • Données contextuelles :
    (a.media.ad.
    pod)
  • Flux de données :
    videoadpod
  • Audience Manager :
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetViewDetails.adBreak.@id
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingPodDetails.adBreakID

Nom de la publicité

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    name
  • Clé API :
    media.ad.name
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.1
  • Exemple de valeur :
     « Ford F-150 »
  • Description :
    nom convivial de la publicité. Dans la création de rapports, « Nom de la publicité » est la classification et « Nom de la publicité (variable) » la variable eVar.
  • Adobe Analytics :
    (a.media.ad.
    friendlyName)
  • Heartbeat :
    (s:asset:ad_name)
  • Disponible :
    Oui
  • Variable réservée :
    eVar et classification
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Nom de la publicité et Nom de la publicité (variable)
  • Données contextuelles :
    (a.media.ad.
    friendlyName)
  • Flux de données :
    S.O.
  • Audience Manager :
    (c_contextdata.
    a.media.ad.friendlyName)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.dc:title
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.name
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.name

Métadonnées de publicité standard

Annonceur

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    ADVERTISER
  • Clé API :
    media.ad.advertiser
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.7
  • Exemple de valeur :
  • Description :
    entreprise ou marque dont le produit apparaît dans la publicité.
  • Adobe Analytics :
    (a.media.ad.
    advertiser)
  • Heartbeat :
    (s:meta:
    a.media.ad.advertiser)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Annonceur
  • Données contextuelles :
    (a.media.ad.
    advertiser)
  • Flux de données :
    videoadvertiser
  • Audience Manager :
    (c_contextdata.
    a.media.ad.advertiser)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.advertiser
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.advertiser
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.advertiser

ID de campagne

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    CAMPAIGN_ID
  • Clé API :
    media.ad.campaignId
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.7
  • Exemple de valeur :
     Nombre entier ou nom (chaîne).
  • Description :
    ID de la campagne publicitaire.
  • Adobe Analytics :
    (a.media.ad.
    campaign)
  • Heartbeat :
    (s:meta:
    a.media.ad.campaign)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    ID de campagne
  • Données contextuelles :
    (a.media.ad.
    campaign)
  • Flux de données :
    videocampaign
  • Audience Manager :
    (c_contextdata.
    a.media.ad.campaign)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.campaign
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.campaignID
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.campaignID

ID d’élément créatif

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    CREATIVE_ID
  • Clé API :
    media.ad.creativeId
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.7
  • Exemple de valeur :
     Nombre entier ou nom (chaîne).
  • Description :
    ID de l’élément créatif publicitaire.
  • Adobe Analytics :
    (a.media.ad.
    creative)
  • Heartbeat :
    (s:meta:
    a.media.ad.creative)
  • Disponible :
    Oui
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    ID d’élément créatif
  • Données contextuelles :
    (a.media.ad.
    creative)
  • Flux de données :
    adclassificationcreative
  • Audience Manager :
    (c_contextdata.
    a.media.ad.creative)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.creativeID
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.creativeID
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.creativeID

ID du site

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    SITE_ID
  • Clé API :
    media.ad.siteId
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.7
  • Exemple de valeur :
  • Description :
    ID du site de la publicité.
  • Adobe Analytics :
    (a.media.ad.
    site)
  • Heartbeat :
    (s:meta:
    a.media.ad.site)
  • Disponible :
    Utiliser la règle de traitement personnalisée
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Personnalisé
  • Données contextuelles :
    (a.media.ad.
    site)
  • Flux de données :
    S.O.
  • Audience Manager :
    (c_contextdata.
    a.media.ad.site)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.siteID
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.siteID
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.siteID

URL de l’élément créatif

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    CREATIVE_URL
  • Clé API :
    media.ad.creativeURL
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.7
  • Exemple de valeur :
  • Description :
    URL de l’élément créatif publicitaire.
  • Adobe Analytics :
    (a.media.ad.
    creativeURL)
  • Heartbeat :
    (s:meta:
    a.media.ad.creativeURL)
  • Disponible :
    Utiliser la règle de traitement personnalisée
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Personnalisé
  • Données contextuelles :
    (a.media.ad.
    creativeURL)
  • Flux de données :
    S.O.
  • Audience Manager :
    (c_contextdata.
    a.media.ad.creativeURL)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.creativeURL
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.creativeURL
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.creativeURL

Identifiant de référencement

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    PLACEMENT_ID
  • Clé API :
    media.ad.placementId
  • Obligatoire :
    Non
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de publicité, Fermeture de publicité
  • Version minimum du SDK : 1.5.7
  • Exemple de valeur :
  • Description :
    identifiant de référencement de la publicité.
  • Adobe Analytics :
    (a.media.ad.
    placement)
  • Heartbeat :
    (s:meta:
    a.media.ad.placement)
  • Disponible :
    Utiliser la règle de traitement personnalisée
  • Variable réservée :
    eVar
  • Expiration :
    ​À l’ACCÈS
  • Nom du rapport :
    Personnalisé
  • Données contextuelles :
    (a.media.ad.
    placement)
  • Flux de données :
    S.O.
  • Audience Manager :
    (c_contextdata.
    a.media.ad.placement)
  • Chemin dʼaccès du champ XDM :
    advertising.adAssetReference.placementID
  • Collection XDM Field Path :
    mediaCollection.advertisingDetails.placementID
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.placementID

Mesures publicitaires

Démarrage de publicité

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    Définie automatiquement
  • Clé API :
    S.O.
  • Obligatoire :
    Oui
  • Type :
    Chaîne
  • Envoyé avec :
    Démarrage de la publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     TRUE
  • Description :
    nombre de démarrages de publicité vidéo.
  • Adobe Analytics :
    (a.media.ad.
    view)
  • Heartbeat :
    (s:event:type=start)
    (s:asset:type=ad)
  • Disponible :
    Oui
  • Variable réservée :
    event
  • Nom du rapport :
    Démarrages de publicité
  • Flux de données :
    S.O.
  • Données contextuelles :
    (a.media.ad.
    view)
  • Audience Manager :
    (c_contextdata.
    a.media.ad.view)
  • Chemin dʼaccès du champ XDM :
     advertising.starts.value > 0 => "TRUE"
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.isStarted

Publicité terminée

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    Définie automatiquement
  • Clé API :
    S.O.
  • Obligatoire :
    Oui
  • Type :
    Chaîne
  • Envoyé avec :
    Fermeture de la publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     TRUE
  • Description :
    nombre de publicités vidéo terminées.
  • Adobe Analytics :
    (a.media.ad.
    complete)
  • Heartbeat :
    (s:event:type=complete)
    (s:asset:type=ad)
  • Disponible :
    Oui
  • Variable réservée :
    event
  • Nom du rapport :
    Fins de publicité
  • Flux de données :
    S.O.
  • Données contextuelles :
    (a.media.ad.
    complete)
  • Audience Manager :
    (c_contextdata.
    a.media.ad.complete)
  • Chemin dʼaccès du champ XDM :
    advertising.completes.value > 0 => "TRUE"
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.isCompleted

Passé sur la publicité

Mise en œuvre Paramètres réseau Création de rapports
  • Clé SDK :
    Définie automatiquement
  • Clé API :
    S.O.
  • Obligatoire :
    Oui
  • Type :
    Chaîne
  • Envoyé avec :
    Fermeture de la publicité
  • Version minimum du SDK : Tous
  • Exemple de valeur :
     15
  • Description :
    le temps total, en secondes, passé à regarder la publicité (c.-à-d., le nombre de secondes lues). La valeur s’affichera au format horaire (HH:MM:SS) dans Analysis Workspace et Reports & Analytics. Dans les API Flux de données, Data Warehouse et Création de rapports, les valeurs seront exprimées en secondes.
    Date de publication : 13/09/18
  • Adobe Analytics :
    (a.media.ad.
    timePlayed)
  • Heartbeat :
  • Disponible :
    Oui
  • Variable réservée :
    event
  • Nom du rapport :
    Temps passé sur la publicité
  • Flux de données :
    S.O.
  • Données contextuelles :
    (a.media.ad.
    timePlayed)
  • Audience Manager :
    (c_contextdata.
    a.media.ad.timePlayed)
  • Chemin dʼaccès du champ XDM :
    advertising.timePlayed.value
  • Chemin du champ XDM de création de rapports :
    mediaReporting.advertisingDetails.timePlayed

API createAdObject :

API createAdBreakObject :

API MediaHeartbeatConfig :

Sur cette page