Présentation de l’implémentation d’Edge

Adobe Experience Platform Edge Network vous permet d’envoyer les données destinées à plusieurs produits à un seul point d’entrée, qui transmet ensuite les informations appropriées à chaque produit. Cela consolide les efforts d’implémentation sur plusieurs solutions de données et constitue la méthode recommandée pour implémenter la collecte de médias en flux continu pour Adobe Analytics et Customer Journey Analytics.

Quelle que soit la base de code que vous utilisez (Web SDK, Mobile SDK (iOS ou Android), Roku SDK ou l’API Media Edge), vous devez d’abord effectuer la configuration de la plateforme décrite sur cette page : créer un schéma, créer un jeu de données et configurer un flux de données.

Conditions préalables

  1. Remplir les conditions préalables générales. Voir les conditions préalables générales.

  2. Confirmez la compatibilité d’une solution Adobe. Vous devez disposer d’une implémentation Customer Journey Analytics, Adobe Analytics, Adobe Journey Optimizer ou Real-Time Customer Data Platform fonctionnelle :

Configurer le schéma dans Adobe Experience Platform

Afin de normaliser la collecte de données entre les applications qui utilisent Adobe Experience Platform, Adobe a créé la norme XDM (modèle de données d’expérience) ouverte et documentée publiquement.

  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 Détails du schéma , choisissez Événement d’expérience comme classe de base du schéma.

    Groupes de champs ajoutés

  3. Sélectionnez Suivant.

  4. Spécifiez un nom d’affichage et une description de 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 groupes de champs suivants au schéma :

    • End User ID Details
    • Implementation Details
    • MediaAnalytics Interaction Details

    Une fois les groupes de champs ajoutés, ils s’affichent dans la section Groupes de champs :

    Groupes de champs ajoutés

  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 du schéma, mais n’est pas obligatoire. Ces champs se rapportent uniquement à ceux du groupe de champs MediaAnalytics Interaction Details.

    accordion
    Développez pour afficher les 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.

      gérer les champs liés

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

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

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

      • Dans le champ Media Collection Details > Chapter Details , masquez les champs de reporting 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 la 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 reporting 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 reporting 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, Total Stalling Duration, et.

      • 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, Media Session Server Timeout, Media Time Spent, Pause Events, Pause Impacted Streams, Pev3, Pccr, Total Pause Duration, Unique Time Played, Video Segment, et.

    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 reporting 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 reporting suivant : Ad Break ID

      • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Chapter Details , masquez les champs de reporting 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 reporting 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 reporting 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, Total Stalling Duration, et.

      • Dans le champ List Of Media Collection Downloaded Content Events > Media Details > Session Details , masquez les champs de reporting 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, Video Segment, et.

      • 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 sélectionnez Gérer les 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 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.

  8. (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 pour des besoins ou des contextes spécifiques. Pour plus d’informations sur les métadonnées personnalisées avec l’API Media Edge, consultez Prise en charge des métadonnées personnalisées.

    accordion
    Développez pour afficher les 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 > client.

      Les champs personnalisés sont reçus via ce chemin d’accès. (Par exemple, nom du client : _dcbl → chemin myCustomField : _dcbl.myCustomField.)

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

      add-custom-metadata

    3. Ajoutez tous les champs personnalisés que vous souhaitez suivre au groupe de champs .

      add-custom-metadata

    4. Utilisez le chemin d’accès généré pour le champ personnalisé dans la payload de votre requête.

      add-custom-metadata

  9. Continuez avec Création d’un jeu de données dans Adobe Experience Platform.

Créer un jeu de données dans Adobe Experience Platform

  1. Veillez à configurer un schéma comme décrit dans la section Configurer le 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éé.

  3. Continuez avec Configurer un flux de données dans Adobe Experience Platform.

Configurer un flux de données dans Adobe Experience Platform

  1. Assurez-vous d’avoir créé un jeu de données comme décrit dans la section Créer un jeu de données dans Adobe Experience Platform.

  2. Créez un flux de données comme décrit dans la section Configurer un flux de données.

    Lors de la création du flux de données, effectuez les sélections suivantes :

    • Dans le champ Schéma d’événement, sélectionnez le schéma que vous avez créé dans Configurer le schéma dans Adobe Experience Platform. Sélectionnez Enregistrer.

      note important
      IMPORTANT
      Ne sélectionnez pas Enregistrer et ajouter un mappage, car cela génère des erreurs de mappage pour le champ Date et heure.

      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 :

      • ​(si vous utilisez Adobe Analytics)

        Si vous utilisez Adobe Analytics, définissez une suite de rapports comme décrit dans la section ​ Création d’une suite de rapports ​.

      • ​(si vous utilisez Customer Journey Analytics)

      Pour plus d’informations sur l’ajout d’un service à un flux de données, voir « Ajouter des services à un flux de données » dans Configurer un flux de données.

      Ajouter le service Adobe Analytics

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

      Option Media Analytics

Choisir la méthode d’implémentation

Une fois le schéma, le jeu de données et le flux de données en place, implémentez l’une des bases de code suivantes pour commencer à envoyer des données de médias en flux continu à Edge Network. Chaque page couvre la configuration spécifique aux médias en flux continu. Le code par événement et par variable réside dans Événements et Variables.

Base de code
In-code
Par Le Biais De Balises
Web
SDK Web
Extension de balise Web SDK
iOS
iOS
iOS (Balises)
Android
Android
Android (Balises)
Roku
Roku
API
​ API Media Edge ​

Étape suivante

Après avoir commencé à collecter des données, vous pouvez configurer les rapports suivants :

recommendation-more-help
media-analytics-help