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

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 Collection 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 la section Création et modification de schémas dans l’interface utilisateur.

  2. Sur la page Détails du schéma lors de la création du schéma, sélectionnez Événement d’expérience lors du choix de la classe de base pour le schéma.

    Ajout de groupes de champs

  3. Sélectionnez Suivant.

  4. Spécifiez un nom d’affichage et une description de schéma, puis sélectionnez Terminer.

  5. Dans le Composition , dans la zone 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 le Groupes de champs , comme suit :

    Ajout de groupes de champs

  6. Sélectionner 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 ne font référence qu’à ceux de la section MediaAnalytics Interaction Details fieldgroup

Développez ici pour afficher des instructions sur les champs que vous pouvez masquer.
  1. Dans le Structure , sélectionnez la zone Media Collection Details champ, puis sélectionnez Gestion des champs associés.

    manage-related-fields

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

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

    • Dans le Media Collection Details > Advertising Pod Details masquez le champ de création de rapports suivant : Ad Break ID

    • Dans le 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 Media Collection Details , masquez la variable List Of States champ .

      masquer les états de collection de médias

    • Dans le 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 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.

    • Dans le 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, 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électionner Confirmer pour enregistrer vos modifications.

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

  5. Sélectionner Gestion des champs associés, puis mettez à jour le schéma comme suit :

    • Dans le 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 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 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 List Of Media Collection Downloaded Content Events > Media Details , masquez la variable List Of States champ .

    • Dans le 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 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, et Total Stalling Duration.

    • Dans le 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, 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 List Of Media Collection Downloaded Content Events > Media Details , masquez la variable Media Session ID champ .

  6. Sélectionner Confirmer pour enregistrer vos modifications.

  7. Dans le Structure , sélectionnez la zone Media Reporting Details champ, sélectionnez Gestion des champs associés.

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

    • Dans le Media Reporting Details masquez les champs suivants : Error Details, List Of States End, List of States Start, et Media Session ID.
  9. Sélectionner Confirmer > Enregistrer pour enregistrer vos modifications.

  10. Passez à la Création d’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 la section 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 la section 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 à la section Configuration du schéma dans Adobe Experience Platform.

  3. Passez à la Configuration d’un flux de données dans 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 la section Création d’un jeu de données dans Adobe Experience Platform.

  2. Créez un flux de données comme décrit dans la section 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 Schéma d’événement lors de la création du flux 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 pas sélectionner Enregistrement et ajout d’un 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 à la section Création d’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, voir la section "Ajout de services à un flux de données" dans Configuration d’un flux de données.

      Ajout du service Adobe Analytics

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

      Option Media Analytics

  3. Vous êtes maintenant prêt à mettre en oeuvre le API Media Edge ou SDK Media Edge pour commencer à collecter des données media analytics.

    Après avoir collecté certaines données, vous pouvez Création d’une connexion dans Customer Journey Analytics.

Créer une connexion dans Customer Journey Analytics

note note
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 la section Configuration d’un flux de données dans Customer Journey Analytics.

  2. Dans Customer Journey Analytics, créez une connexion comme décrit dans la section Création d’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 la section Création d’un jeu de données dans Adobe Experience Platform.

    2. Assurez-vous que la variable Importer toutes les nouvelles données est activé.

  3. Passez à la Création d’une vue de données dans Customer Journey Analytics.

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

note note
NOTE
La procédure suivante n’est requise que si vous utilisez Customer Journey Analytics.
  1. Veillez à créer une connexion en Customer Journey Analytics, comme décrit dans la section Création d’une connexion dans Customer Journey Analytics.

  2. Dans Customer Parcours Analytics, créez une vue de données comme décrit dans la section 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 Connexion , sélectionnez la connexion que vous avez créée précédemment, comme décrit dans la section Création d’une connexion dans Customer Journey Analytics.

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

    2. Sur le Composants , dans le Champs de schéma , recherchez chaque composant répertorié dans les tableaux ci-dessous et faites-le glisser dans la section Mesures du panneau. 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 de publicité

      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 étiquettes (dans la variable Étiquettes contextuelles menu déroulant) pour les composants dans le 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 Dimensions panel :

      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électionner Enregistrer et continuer > Enregistrer et terminer pour enregistrer vos modifications.

  4. Passez à la Création et configuration d’un projet dans Customer Journey Analytics.

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

  1. Veillez à créer une vue de données en Customer Journey Analytics, comme décrit dans la section Création d’une vue de données dans Customer Journey Analytics.

  2. En Customer Journey Analytics, dans la variable Workspace , dans le Projets zone, sélectionnez Créer un projet.

  3. Sélectionner 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 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 de chapitres et d’annonces

    Panneau QoE

    Panneau d’état Plate

  5. Sélectionnez la variable Panneaux dans le rail de gauche, puis effectuez un glisser-déposer dans la Visionneuses simultanées de médias et le panneau Durée de lecture du média du panneau.

    Les deux panneaux doivent se présenter comme suit :

    Panneau des visionneuses simultanées de médias

    Panneau Durée de lecture du média

  6. Partagez le projet, comme décrit dans la section Partage de 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.
  7. Passez à la Envoi de données à Experience Platform Edge.

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