DocumentationAnalyticsGuide de collection des médias en streaming

Paramètres d’état du lecteur player-state-parameters

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration
  • Développeur

Cette rubrique présente une liste de données concernant l’état du lecteur collectées par Adobe au moyen de 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écrites 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 le suivi multimédia. De temps à autre, Adobe ajoute de nouvelles propriétés. 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.

Propriétés de l’état du lecteur player-state-properties

Les capacités de suivi de l’état du lecteur peuvent être associées à un flux audio ou vidéo. Les mesures de suivi standard de l’état du lecteur sont stockées en tant que variables de solution. Les états standard sont les suivants : fullScreen, mute, closeCaption, pictureInPicture et inFocus.

Propriétés du plein écran

Diffusions affectées par le plein écran

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de diffusions affectées par le plein écran. Cette mesure est définie sur 1 uniquement si au moins un passage en plein écran s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, la seule valeur possible est TRUE. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.fullscreen.set
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Diffusions affectées par le plein écran
  • Données contextuelles :
     a.media.states.fullscreen.set
  • Flux de données :
     videostatefullscreen
  • Audience Manager :
     c_contextdata.a.media.states.fullscreen.set
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateSet
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.isSet

Nombre de plein écrans

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de passages en plein écran. Cette mesure est définie sur 1 uniquement si au moins un passage en plein écran s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, le nombre est égal au nombre de fois où la vidéo est passée en plein écran. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.fullscreen.count
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Nombre de plein écrans
  • Données contextuelles :
     a.media.states.fullscreen.count
  • Flux de données :
     videostatefullscreencount
  • Audience Manager :
     c_contextdata.media.states.fullscreen.count
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateCount
  • Chemin du champ XDM de création de rapports :
    mediaReporting.playerStateData.count

Durée totale en plein écran

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     La durée du passage en plein écran. Cette mesure est définie sur 1 uniquement si au moins un passage en plein écran s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, la durée correspond à la durée pendant laquelle la vidéo se trouvait en plein écran. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.fullscreen.time
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
    Durée totale du plein écran
  • Données contextuelles :
     a.media.states.fullscreen.time
  • Flux de données :
     videostatefullscreentime
  • Audience Manager :
     c_contextdata.media.states.fullscreen.time
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateTime
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.time

Propriétés du sous-titrage codé

Diffusions affectées par le sous-titrage codé

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de diffusions affectées par le sous-titrage codé. Cette mesure est définie sur 1 uniquement si au moins un affichage du sous-titrage codé s’est produit au cours de la session de lecture.
    Important :
     Si cet événement est défini, la seule valeur possible est TRUE. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.closedcaptioning.set
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Diffusions affectées par le sous-titrage codé
  • Données contextuelles :
     a.media.states.closedcaptioning.set
  • Flux de données :
     videostateclosedcaptioning
  • Audience Manager :
     c_contextdata.a.media.states.
    closedcaptioning.set
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateSet
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.isSet

Nombre de sous-titrages codés

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre d’affichages du sous-titrage codé. Cette mesure est définie sur 1 uniquement si au moins un affichage du sous-titrage codé s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, le nombre est égal au nombre de fois où le sous-titrage codé a été affiché. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics:
    a.media.states.closedcaptioning.count
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Nombre de sous-titrages codés
  • Données contextuelles :
     a.media.states.closedcaptioning.count
  • Flux de données :
     videostateclosedcaptioningcount
  • Audience Manager :
     c_contextdata.media.states.
    closedcaptioning.count
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateCount
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.count

Durée totale du sous-titrage codé

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     La durée de l’affichage du sous-titrage codé. Cette mesure est définie sur 1 uniquement si au moins un passage en plein écran s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, la durée est égale à la durée pendant laquelle le sous-titrage codé a été affiché. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.closedcaptioning.time
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Durée totale du sous-titrage codé
  • Données contextuelles :
     a.media.states.closedcaptioning.time
  • Flux de données :
     videostateclosedcaptioningtime
  • Audience Manager :
     c_contextdata.media.states.
    closedcaptioning.time
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateTime
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.time

Propriétés du mode muet

Diffusions affectées par le mode muet

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de diffusions affectées par le mode muet. Cette mesure est définie sur 1 uniquement si au moins un passage en mode muet s’est produit au cours de la session de lecture.
    Important :
     Si cet événement est défini, la seule valeur possible est TRUE. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.mute.set
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Diffusions affectées par le mode muet
  • Données contextuelles :
     a.media.states.mute.set
  • Flux de données :
     videostatemute
  • Audience Manager :
     c_contextdata.a.media.states.mute.set
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateSet
  • < Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.isSet

Nombre d’instances muettes

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
    Le nombre de passages en mode muet. Cette mesure est définie sur 1 uniquement si au moins un passage en mode muet s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, le nombre est égal au nombre de passages en mode muet. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.mute.count
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Nombre d’instances muettes
  • Données contextuelles :
     a.media.states.mute.count
  • Flux de données :
     videostatemutecount
  • Audience Manager :
     c_contextdata.media.states.mute.count
  • Chemin dʼaccès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.mute.playerStateCount
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.count

Durée totale du mode muet

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     La durée du passage en mode muet. Cette mesure est définie sur 1 uniquement si au moins un passage en mode muet s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, la durée est égale à la durée du passage en mode muet. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.mute.time
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Durée totale du mode muet
  • Données contextuelles :
     a.media.states.mute.time
  • Flux de données :
     videostatemutetime
  • Audience Manager :
     c_contextdata.media.states.mute.time
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateTime
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.time

Propriétés du mode « Image dans l’Image »

Diffusions affectées par le mode « Image dans l’Image »

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de diffusions affectées par le mode « Image dans l’Image ». Cette mesure est définie sur 1 uniquement si au moins un passage en mode « Image dans l’Image » s’est produit au cours de la session de lecture.
    Important :
     Si cet événement est défini, la seule valeur possible est TRUE. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.pictureinpicture.set
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Diffusions affectées par le mode « Image dans l’Image »
  • Données contextuelles :
     a.media.states.pictureinpicture.set
  • Flux de données :
     videostatepictureinpicture
  • Audience Manager :
     c_contextdata.a.media.states.
    pictureinpicture.set
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateSet
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.isSet

Nombre d’instances en mode « Image dans l’Image »

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de passages en mode « Image dans l’Image ». Cette mesure est définie sur 1 uniquement si au moins un passage en mode « Image dans l’Image » s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, le nombre est égal au nombre de passages en mode « Image dans l’Image ». Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.pictureinpicture.count
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Nombre d’instances en mode « Image dans l’Image »
  • Données contextuelles :
     a.media.states.pictureinpicture.count
  • Flux de données :
     videostatepictureinpicturecount
  • Audience Manager :
    c_contextdata.media.states.
    pictureinpicture.count
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateCount
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.count

Durée totale du mode « Image dans l’Image »

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     La durée du passage en mode « Image dans l’Image ». Cette mesure est définie sur 1 uniquement si au moins un passage en mode « Image dans l’Image » s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, la durée est égale à la durée du passage en mode « Image dans l’Image ». Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.pictureinpicture.time
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Durée totale du mode « Image dans l’Image »
  • Données contextuelles :
     a.media.states.pictureinpicture.time
  • Flux de données :
     videostatepictureinpicturetime
  • Audience Manager :
     c_contextdata.media.states.
    pictureinpicture.time
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateTime
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.time

Propriétés du mode « En point de mires »

Diffusions affectées par le mode « En point de mires »

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de diffusions affectées par le mode « En point de mires ». Cette mesure est définie sur 1 uniquement si au moins un passage en mode « En point de mires » s’est produit au cours de la session de lecture.
    Important :
     Si cet événement est défini, la seule valeur possible est TRUE. Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.infocus.set
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Diffusions affectées par le mode « En point de mires »
  • Données contextuelles :
     a.media.states.infocus.set
  • Flux de données :
     videostateinfocus
  • Audience Manager :
     c_contextdata.a.media.states.infocus.set
  • Chemin dʼaccès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateSet
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.isSet

Nombre d’instances en mode « En point de mires »

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     Le nombre de passages en mode « En point de mires ». Cette mesure est définie sur 1 uniquement si au moins un passage en mode « En point de mires » s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, le nombre est égal au nombre de passages en mode « En point de mires ». Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.infocus.count
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Nombre d’instances en mode « En point de mires »
  • Données contextuelles :
     a.media.states.infocus.count
  • Flux de données :
     videostateinfocuscount
  • Audience Manager :
     c_contextdata.media.states.infocus.count
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateCount
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.count

Durée totale du mode « En point de mires »

Mise en œuvre
Paramètres réseau
Création de rapports
  • Clé SDK :
     Définie automatiquement
  • Clé API :
     S.O.
  • Obligatoire :
     Non
  • Type :
     nombre
  • Envoyé avec :
     Fermeture du média
  • Version SDK min.
     3.0
  • Exemple de valeur :
     TRUE
  • Description :
     La durée du passage en mode « En point de mires ». Cette mesure est définie sur 1 uniquement si au moins un passage en mode « En point de mires » s’est produit au cours de la session de lecture.
    Important :
    Si cet événement est défini, la durée est égale à la durée du passage en Mode « En point de mires ». Si cet événement n’est pas défini, aucune valeur n’est envoyée.
  • Adobe Analytics :
     a.media.states.infocus.time
  • Heartbeat :
     S.O.
  • Disponible :
     Oui
  • Variable réservée :
     event
  • Nom du rapport :
     Durée totale du mode « En point de mires »
  • Données contextuelles :
     a.media.states.infocus.time
  • Flux de données :
     videostateinfocustime
  • Audience Manager :
     c_contextdata.media.states.infocus.time
  • Chemin d’accès du champ XDM :
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateTime
  • Chemin d’accès du champ XDM de création de rapports :
    mediaReporting.playerStateData.time
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb