DocumentationAnalyticsGuide de collection des médias en streaming

Mise en oeuvre du module complémentaire Collection de médias en flux continu à l’aide de l’Edge Network

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration
  • Développeur

Le réseau Edge d'Adobe Experience Platform vous permet d’envoyer des données destinées à plusieurs produits vers un emplacement centralisé. Experience Edge transfère les informations appropriées aux produits souhaités. Ce concept vous permet de consolider les efforts de mise en œuvre, en particulier sur plusieurs solutions de données.

Le graphique suivant illustre la manière dont le module complémentaire de collecte de médias en flux continu Adobe peut être mis en oeuvre pour utiliser Edge Experience Platform afin de rendre les données disponibles dans Analysis Workspace, que ce soit dans Adobe Analytics ou dans Customer Journey Analytics :

Workflow CJA

Pour une présentation de toutes les options de mise en oeuvre, y compris les méthodes de mise en oeuvre qui n’utilisent pas Edge Experience Platform, voir Mise en oeuvre du module complémentaire de collecte de médias en flux continu.

Que vous utilisiez le SDK Web de Adobe Experience Platform, le SDK Mobile de Adobe Experience Platform, le SDK Roku de Adobe Experience Platform ou l’API pour mettre en oeuvre le module complémentaire de collecte de médias en flux continu avec Experience Edge, vous devez d’abord suivre les sections suivantes :

Configuration du schéma dans Adobe Experience Platform

Pour normaliser la collecte de données à utiliser dans les applications qui utilisent Adobe Experience Platform, Adobe a créé la norme ouverte et accessible au public, Modèle de données d’expérience (XDM).

Pour créer et configurer un schéma :

  1. Dans Adobe Experience Platform, commencez à créer le schéma comme décrit dans Création et modification de schémas dans l’interface utilisateur.

  2. Sur la page des détails du schéma lors de la création du schéma, sélectionnez Experience Event lors du choix de la classe de base pour le schéma.

    Ajout de groupes de champs

  3. Sélectionnez Suivant.

  4. Indiquez un nom d’affichage et une description du schéma, puis sélectionnez Terminer.

  5. Dans la zone Composition, dans la section Groupes de champs, sélectionnez Ajouter, puis recherchez et ajoutez les nouveaux groupes de champs suivants au schéma :

    • Adobe Analytics ExperienceEvent Template
    • Implementation Details
    • MediaAnalytics Interaction Details

    Une fois les groupes de champs ajoutés, ils doivent s’afficher dans la section Groupes de champs, comme suit :

    Ajout de groupes de champs

  6. Sélectionnez Enregistrer pour enregistrer vos modifications.

  7. (Facultatif) Vous pouvez masquer certains champs qui ne sont pas utilisés par l’API Media Edge. Le masquage de ces champs facilite la lecture et la compréhension du schéma, mais il n’est pas obligatoire. Ces champs font uniquement référence à ceux du groupe de champs MediaAnalytics Interaction Details.

Développez ici pour afficher des instructions sur les champs que vous pouvez masquer.

  1. Dans la zone Structure, sélectionnez le champ Media Collection Details, puis sélectionnez Gérer les champs associés.

    manage-related-fields

  2. Activez l’option Afficher les noms d’affichage pour les champs, puis mettez à jour le schéma comme suit :

    • Dans le champ Media Collection Details > Advertising Details , masquez les champs de création de rapports suivants : Ad Completed, Ad Started et Ad Time Played.

    • Dans le champ Media Collection Details > Advertising Pod Details , masquez le champ de rapport suivant : Ad Break ID

    • Dans le champ Media Collection Details > Chapter Details , masquez les champs de création de rapports suivants : Chapter Completed, Chapter ID, Chapter Started et Chapter Time Played.

    • Dans le champ Media Collection Details , masquez le champ List Of States.

      masquer les états de collection de médias

    • Dans le champ Media Collection Details > List Of States End et Media Collection Details > List Of States Start , masquez les champs de création de rapports suivants : Player State Count, Player State Set et Player State Time.

      champs à masquer

    • Dans le champ Media Collection Details > Qoe Data Details, masquez les champs de création de rapports suivants : Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Impacted Streams, Buffer Events, Dropped Frame Impacted Streams, Drops Before Starts, Errors, External Error IDs, Error Impacted Streams, Media SDK Error IDs, Player SDK Error IDs, Stalling Impacted Streams, Stalling Events, Total Buffer Duration et Total Stalling Duration 8}.

    • Dans le champ Media Collection Details > Session Details, masquez les champs de création de rapports suivants : 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Content Completes, Chapter Count, Content Starts, Content Time Spent, Estimated Streams, Federated Data, Media Segment Views, Media Downloaded Flag, Media Starts, Media Session ID 8}, Media Session Server Timeout, Media Time Spent, Pause Events, Pause Impacted Streams, Pev3, Pccr, Total Pause Duration, Unique Time Played et Video Segment.

  3. Sélectionnez Confirmer pour enregistrer vos modifications.

  4. Dans la zone Structure, activez l’option Afficher les noms d’affichage des champs, puis sélectionnez le champ List Of Media Collection Downloaded Content Events.

  5. Sélectionnez Gérer les champs associés, puis mettez à jour le schéma comme suit :

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Advertising Details , masquez les champs de création de rapports suivants : Ad Completed, Ad Started et Ad Time Played.

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Advertising Pod Details , masquez le champ de création de rapports suivant : Ad Break ID

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Chapter Details , masquez les champs de création de rapports suivants : Chapter Completed, Chapter ID, Chapter Started et Chapter Time Played.

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details , masquez le champ List Of States .

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > List Of States End et Media Collection Details > List Of States Start , masquez les champs de création de rapports suivants : Player State Count, Player State Set et Player State Time.

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details, masquez les champs de création de rapports suivants : Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Events, Buffer Impacted Streams, Drops Before Starts, Dropped Frame Impacted Streams, Error Impacted Streams, Errors, External Error IDs, Media SDK Error IDs, Player SDK Error IDs, Stalling Events, Stalling Impacted Streams, Total Buffer Duration 8} et Total Stalling Duration.

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Session Details, masquez les champs de création de rapports suivants : 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Chapter Count, Content Completes, Content Starts, Content Time Spent, Estimated Streams, Federated Data, Media Downloaded Flag, Media Segment Views, Media Session ID 8}, Media Session Server Timeout, Media Starts, Media Time Spent, Pause Events, Pause Impacted Streams, Pccr, Pev3, Total Pause Duration, Unique Time Played et Video Segment.

    • Dans le champ List Of Media Collection Downloaded Content Events > Media Details , masquez le champ Media Session ID .

  6. Sélectionnez Confirmer pour enregistrer vos modifications.

  7. Dans la zone Structure, sélectionnez le champ Media Reporting Details, puis Gérer les champs associés.

  8. Activez l’option Afficher les noms d’affichage pour les champs, puis mettez à jour le schéma comme suit :

    • Dans le champ Media Reporting Details , masquez les champs suivants : Error Details, List Of States End, List of States Start et Media Session ID.

  9. Sélectionnez Confirmer > Enregistrer pour enregistrer vos modifications.

  1. (Facultatif) Vous pouvez ajouter des métadonnées personnalisées à votre schéma. Vous pouvez ainsi inclure des métadonnées supplémentaires définies par l’utilisateur qui peuvent être personnalisées en fonction de besoins ou de contextes spécifiques. Cette flexibilité est utile dans les cas où les schémas existants ne couvrent pas les points de données souhaités. (Vous pouvez également utiliser des métadonnées personnalisées avec les API Media Edge. Pour plus d’informations, voir Création de métadonnées personnalisées avec les API Media Edge.)
Développez ici pour afficher des instructions sur l’ajout de métadonnées personnalisées à votre schéma.

  1. Recherchez le nom du client de l’organisation en sélectionnant Informations sur le compte > Organisations affectées > nom de l’organisation > tenant.

    Ces champs personnalisés seront reçus par ce chemin d’accès. (Par exemple, le nom du client : _dcbl → myCustomField path: _dcbl.myCustomField.)

  2. Ajoutez un groupe de champs personnalisé à votre schéma multimédia défini.

    add-custom-metadata

  3. Ajoutez les champs personnalisés dont vous souhaitez effectuer le suivi au groupe de champs.

    add-custom-metadata

  4. Utilisez le chemin généré pour le champ personnalisé dans le payload de votre requête.

    add-custom-metadata

  1. Poursuivez en créant un jeu de données dans Adobe Experience Platform.

Création d’un jeu de données dans Adobe Experience Platform

  1. Assurez-vous de configurer un schéma comme décrit dans Configuration du schéma dans Adobe Experience Platform.

  2. Dans Adobe Experience Platform, commencez à créer le jeu de données comme décrit dans le guide de l’interface utilisateur des jeux de données.

    Lors de la sélection d’un schéma pour votre jeu de données, choisissez le schéma que vous avez précédemment créé, comme décrit dans la section Configuration du schéma dans Adobe Experience Platform.

  3. Passez à Configuration d’un flux de données en Customer Journey Analytics.

Configuration d’un flux de données dans Adobe Experience Platform

  1. Veillez à créer un jeu de données comme décrit dans Création d’un jeu de données dans Adobe Experience Platform.

  2. Créez un flux de données comme décrit dans Configuration d’un flux de données.

    Lors de la création du flux de données, veillez à effectuer les sélections de configuration suivantes :

    • Dans le champ Event Schema lors de la création de la banque de données, veillez à sélectionner le schéma que vous avez créé dans Configuration du schéma dans Adobe Experience Platform. Sélectionnez Enregistrer.

      note important
      IMPORTANT
      Ne sélectionnez pas Enregistrer et ajouter le mappage, car cela entraînera des erreurs de mappage pour le champ Horodatage.

      Créer un flux de données et sélectionner un schéma

    • Ajoutez l’un des services suivants au flux de données, selon que vous utilisez Adobe Analytics ou Customer Journey Analytics :

      • Adobe Analytics (si vous utilisez Adobe Analytics)

        Si vous utilisez Adobe Analytics, veillez à définir une suite de rapports, comme décrit dans la section Créer une suite de rapports.

      • Adobe Experience Platform (en cas d’utilisation de Customer Journey Analytics)

      Pour plus d’informations sur l’ajout d’un service à un flux de données, reportez-vous à la section "Ajout de services à un flux de données" dans Configuration d’un flux de données.

      Ajout du service Adobe Analytics

      • Développez Options avancées, puis activez l’option Media Analytics.

      Option Media Analytics

  3. Vous êtes maintenant prêt à mettre en oeuvre l’ API Media Edge ou le SDK Media Edge pour commencer à collecter des données d’analyse multimédia.

    Une fois que vous avez collecté certaines données, vous pouvez créer une connexion dans Customer Journey Analytics.

Créer une connexion dans Customer Journey Analytics

NOTE
La procédure suivante n’est requise que si vous utilisez Customer Journey Analytics.

  1. Veillez à créer un flux de données comme décrit dans Configuration d’un flux de données dans Customer Journey Analytics.

  2. Dans Customer Journey Analytics, créez une connexion comme décrit dans Créer une connexion.

    Lors de la création de la connexion, les sélections de configuration suivantes sont requises pour la mise en oeuvre du module complémentaire Collection de médias en flux continu :

    1. Sélectionnez le jeu de données que vous avez précédemment créé, comme décrit dans Création d’un jeu de données dans Adobe Experience Platform.

    2. Assurez-vous que le paramètre Importer toutes les nouvelles données est activé.

  3. Poursuivez en créant une vue de données dans Customer Journey Analytics.

Création d’une vue de données dans Customer Journey Analytics

NOTE
La procédure suivante n’est requise que si vous utilisez Customer Journey Analytics.

  1. Vérifiez que vous avez créé une connexion en Customer Journey Analytics comme décrit dans Création d’une connexion en Customer Journey Analytics.

  2. Dans Customer Parcours Analytics, créez une vue de données comme décrit dans Création ou modification d’une vue de données.

    Lors de la création de la vue de données, les sélections de configuration suivantes sont requises pour la mise en oeuvre du module complémentaire Collection de médias en flux continu :

    1. Dans le champ Connexion , sélectionnez la connexion que vous avez créée précédemment, comme décrit dans la section Créer une connexion dans Customer Journey Analytics.

      La sélection de la connexion que vous avez créée peut prendre jusqu’à 15 minutes.

    2. Sur l’onglet Composants, dans la section Champs de schéma, recherchez chaque composant répertorié dans les tableaux ci-dessous et faites-le glisser dans le panneau Mesures. S’il existe plusieurs champs portant le même nom, utilisez le chemin XDM pour vous assurer qu’il s’agit bien du champ.

      Contenu principal - Mesures de contenu

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
      Nom du composant Chemin XDM
      Démarrage du contenu multimédia mediaReporting.sessionDetails.isViewed
      Vues de segments du fichier multimédia mediaReporting.sessionDetails.hasSegmentView
      Démarrages de contenu mediaReporting.sessionDetails.isPlayed
      Le contenu se termine mediaReporting.sessionDetails.isCompleted
      Temps passé sur le contenu mediaReporting.sessionDetails.timePlayed
      Passé sur le média mediaReporting.sessionDetails.totalTimePlayed
      Durée de lecture unique mediaReporting.sessionDetails.uniqueTimePlayed
      Marqueur de progression de 10% mediaReporting.sessionDetails.hasProgress10
      Audience moyenne par minute mediaReporting.sessionDetails.averageMinuteAudience

      Chapitre et publicités - Mesures de chapitre et publicités

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
      Nom du composant Chemin XDM
      Démarrage du chapitre mediaReporting.chapterDetails.isStarted
      Chapitre terminé mediaReporting.chapterDetails.isCompleted
      Durée de lecture des chapitres mediaReporting.chapterDetails.timePlayed
      Publicité lancée mediaReporting.advertisingDetails.isStarted
      Publicité terminée mediaReporting.advertisingDetails.isCompleted
      Durée de lecture des publicités mediaReporting.advertisingDetails.timePlayed

      QoE - mesures QoE

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2
      Nom du composant Chemin XDM
      Temps jusqu’au début mediaReporting.qoeDataDetails.timeToStart
      Pertes avant le début mediaReporting.qoeDataDetails.isDroppedBeforeStart
      Flux touchés par la mémoire tampon mediaReporting.qoeDataDetails.hasBufferImpactedStreams
      Flux touchés par les changements de débit mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
      Changements de débit mediaReporting.qoeDataDetails.bitrateChangeCount
      Débit moyen mediaReporting.qoeDataDetails.bitrateAverage
      Perte d’images mediaReporting.qoeDataDetails.droppedFrames
      Erreurs mediaReporting.qoeDataDetails.errorCount
      Flux touchés par les erreurs mediaReporting.qoeDataDetails.hasErrorImpactedStreams
      Flux touchés par la perte d’images mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

      État du lecteur - Mesures d’état du lecteur

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Nom du composant Chemin XDM
      Jeu d’états du lecteur mediaReporting.states.isSet
      Nombre d’états du lecteur mediaReporting.states.count
      Heure d’état du lecteur mediaReporting.states.time

    3. Mettez à jour les libellés (dans le menu déroulant Étiquettes contextuelles) pour les composants du tableau suivant. Recherchez et faites glisser des composants qui ne se trouvent pas déjà dans le panneau des mesures dans le panneau.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
      Nom du composant Libellé de contexte
      Délai d’expiration du serveur de session multimédia Média : secondes depuis le dernier appel
      Passé sur le média Média : temps passé sur le média
      Durée totale de la mémoire tampon Média : durée totale de la mémoire tampon
      Temps jusqu’au début Média : temps jusqu’au début
      Durée totale de pause Média : durée totale de pause

    4. Pour ajouter des ventilations à votre projet Customer Journey Analytics, ajoutez les dimensions suivantes au panneau Dimensions :

      table 0-row-2 1-row-2 2-row-2
      Chemin XDM Nom du composant
      mediaReporting.states.name Nom de l’état du lecteur
      mediaReporting.sessionDetails.ID ID de session multimédia

      Outre les dimensions de ce tableau, vous pouvez ajouter toute autre dimension que vous souhaitez rendre disponible pour filtrer les données par dans les projets Customer Journey Analytics.

  3. Sélectionnez Enregistrer et continuer > Enregistrer et terminer pour enregistrer vos modifications.

  4. Passez à Créer et configurer un projet en Customer Journey Analytics.

Création et configuration d’un projet dans Customer Journey Analytics

  1. Vérifiez que vous avez créé une vue de données dans Customer Journey Analytics comme décrit dans Création d’une vue de données dans Customer Journey Analytics.

  2. Dans Customer Journey Analytics, dans l’onglet Workspace, dans la zone Projets, sélectionnez Créer un projet.

  3. Sélectionnez Projet vierge > Créer.

  4. Dans le nouveau projet, sélectionnez la vue de données que vous avez créée précédemment.

    Lors de la création de panneaux dans votre projet, vous pouvez utiliser tous les composants que vous avez ajoutés à votre vue de données, comme décrit dans la section Création d’une vue de données dans Customer Journey Analytics.

    Les 4 panneaux suivants constituent des exemples de panneaux que vous pouvez créer :

    Panneau Contenu principal

    Panneau Chapitre et publicités

    Panneau QoE

    Panneau d’état Plater

  5. Sélectionnez l’icône Panneaux dans le rail de gauche, puis faites glisser le curseur dans le panneau Visionneuses simultanées de médias et le panneau Durée de lecture de médias.

    Les deux panneaux doivent se présenter comme suit :

    Panneau des visionneuses simultanées de médias

    Durée de lecture du média dans le panneau

  6. (Conditionnel) Si vous avez ajouté des métadonnées personnalisées à votre schéma, comme décrit à l’étape 8 de Configuration du schéma dans Adobe Experience Platform, vous devez définir la persistance des champs personnalisés, comme décrit dans la section Paramètres du composant de persistance du guide du Customer Journey Analytics.

    Lorsque des données arrivent dans Customer Journey Analytics, la dimension Identifiant utilisateur personnalisé est disponible.

    setup-custom-metadata

    note note
    NOTE
    Si vous configurez Adobe Analytics en amont pour votre flux de données, les métadonnées personnalisées sont également présentes dans ContextData, avec le nom que vous avez défini dans le schéma (sans le préfixe du client, par exemple myCustomField). Cela permet d’utiliser toutes les fonctionnalités Adobe Analytics disponibles pour ContextData, telles que la création d’une règle de traitement.

  7. Partagez le projet comme décrit dans Partager les projets.

    note note
    NOTE
    Si les utilisateurs avec lesquels vous souhaitez partager du contenu ne sont pas disponibles, assurez-vous qu’ils disposent d’un accès utilisateur et administrateur à Customer Journey Analytics dans Adobe Admin Console.

  8. Passez à Envoyer des données à Edge Experience Platform.

Envoi de données à Experience Platform Edge

Selon le type de données à envoyer à Experience Platform Edge, vous pouvez utiliser l’une des méthodes suivantes :

Web : utilisation du SDK Web de Adobe Experience Platform

Mobile : utilisation du SDK Mobile Adobe Experience Platform

Utilisez les ressources de documentation suivantes pour terminer la mise en oeuvre pour iOS et Android :

Roku : SDK Adobe Experience Platform Roku

API : Web et autres

L’API est actuellement la seule méthode prise en charge pour envoyer des données web à Edge Experience Platform.

L’API est également disponible si vous souhaitez utiliser une implémentation personnalisée des API Edge.

Pour plus d’informations sur l’API Media Edge, voir les ressources suivantes :

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb