DocumentationCustomer Journey AnalyticsGuide de Customer Journey Analytics

Ingestion de données via l’API du serveur Edge Network

Last update: Fri Oct 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

Ce guide de démarrage rapide explique comment ingérer des données de suivi à partir de périphériques tels que des périphériques IoT, des décodeurs, des consoles de jeux, des applications de bureau directement dans Adobe Experience Platform à l’aide de l’API Adobe Experience Platform Edge Network Server et de l’Edge Network. Utilisez ensuite ces données en Customer Journey Analytics.

Pour ce faire, vous devez :

  • Configurer un schéma et un jeu de données dans Adobe Experience Platform pour définir le modèle (schéma) des données que vous souhaitez collecter et l’emplacement de la collecte effective des données (jeu de données).

  • Définir un flux de données pour configurer Adobe Experience Platform Edge Network afin d’acheminer les données collectées vers le jeu de données que vous avez configuré dans Adobe Experience Platform.

  • Utilisez l’API serveur pour envoyer directement des données à partir de votre application ou jeu s’exécutant sur un ordinateur de bureau, une console de jeux, un appareil IoT ou un décodeur vers votre flux de données.

  • Déployer et valider. disposer d’un environnement dans lequel vous pouvez effectuer une itération sur votre développement ; une fois que tout est validé, le publier en ligne sur votre environnement de production ;

  • Configurer une connexion dans Customer Journey Analytics. Cette connexion doit (au moins) inclure le jeu de données Adobe Experience Platform.

  • Configurer une vue de données dans Customer Journey Analytics pour définir les mesures et les dimensions à utiliser dans Analysis Workspace.

  • Configurer un projet dans Customer Journey Analytics pour créer des rapports et des visualisations.

NOTE
Ce guide de démarrage rapide est un guide simplifié sur la manière d’ingérer dans Adobe Experience Platform les données collectées à partir d’une application ou d’un jeu s’exécutant sur un périphérique IoT, un décodeur, une console de jeux ou un ordinateur de bureau. Il est ensuite utilisé dans Customer Journey Analytics. Il est vivement recommandé d’étudier les informations supplémentaires lorsqu’elles sont mentionnées.

Configurer un schéma et un jeu de données

Pour ingérer des données dans Adobe Experience Platform, vous devez d’abord définir les données à collecter. Toutes les données ingérées dans Adobe Experience Platform doivent être conformes à une structure standard dénormalisée pour être reconnues et utilisées par les fonctionnalités et fonctions en aval. Le modèle de données d’expérience (XDM) est la structure standard qui fournit une structure sous la forme de schémas.

Une fois que vous avez défini un schéma, vous utilisez un ou plusieurs jeux de données pour stocker et gérer la collecte de données. Un jeu de données est une structure de stockage et de gestion pour une collecte de données (généralement sous la forme d’un tableau) contenant un schéma (des colonnes) et des champs (des lignes).

Toutes les données ingérées par Adobe Experience Platform doivent être conformes à un schéma prédéfini avant de pouvoir être conservées sous la forme d’un jeu de données.

Configurer un schéma

Vous souhaitez effectuer le suivi de certaines données minimales provenant des profils qui jouent à votre jeu sur une console, par exemple l’identification, les scores, l’avancement et d’autres informations.
Vous devez d’abord définir un schéma qui modélise ces données.

Configurer le schéma :

  1. Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Schémas sous GESTION DES DONNÉES.

  2. Sélectionnez Créer un schéma.
    .

  3. Dans l’étape Sélectionner une classe de l’assistant Créer un schéma :

    1. Sélectionnez Experience Event.

      Créer un schéma

      note info
      INFO
      Un schéma d’événement d’expérience est utilisé pour modéliser le comportement d’un profil (comme le nom de la scène, le bouton Push à ajouter au panier). Un schéma de profil individuel est utilisé pour modéliser les attributs de profil (nom, e-mail, sexe, etc.).

    2. Sélectionnez Suivant.

  4. Dans l’ étape de nom et de révision de l’assistant Créer un schéma :

    1. Saisissez un nom d’affichage de schéma pour votre schéma et (facultatif) une description.

      Nommer le schéma

    2. Sélectionnez Terminer.

  5. Dans l’onglet Structure de l’exemple de schéma :

    1. Sélectionnez + Ajouter dans Groupes de champs.

      Ajouter un groupe de champs

      Les groupes de champs sont des collections d’objets et d’attributs réutilisables permettant d’étendre facilement le schéma.

    2. Dans la boîte de dialogue Ajouter des groupes de champs, sélectionnez le groupe de champs ​ ​dans la liste. Ce groupe de champs est créé pour suivre la progression des utilisateurs jouant à un jeu fictif intitulé Aveugles sur une console.

      Blinding Light fieldgroup

      Vous pouvez sélectionner le bouton Aperçu pour afficher un aperçu des champs qui font partie de ce groupe de champs, comme scores > afterMatch.

      Aperçu du groupe de champs de lumière aveugle

      Sélectionnez Précédent pour fermer l’aperçu.

    3. Sélectionnez Ajouter des groupes de champs.

  6. Sélectionnez + en regard du nom de votre schéma.

    Exemple du bouton Ajouter un champ de schéma

  7. Dans le panneau Propriétés du champ, saisissez identification comme Nom du champ, Identification comme Nom d’affichage, sélectionnez Objet comme Type et ExperienceEvent Core v2.1 comme Groupe 6}.

    note note
    NOTE
    Si ce groupe de champs n’est pas disponible, recherchez un autre groupe contenant des champs d’identité. Ou créez un groupe de champset ajoutez de nouveaux champs d’identité (comme ecid, crmId et d’autres dont vous avez besoin) au groupe de champs et sélectionnez ce nouveau groupe de champs.

    Objet d’identification

    L’objet d’identification ajoute des fonctionnalités d’identification à votre schéma. Dans votre cas, vous souhaitez identifier les profils qui jouent à votre jeu à l’aide de l’identifiant Experience Cloud et de l’adresse électronique qu’ils utilisent pour se connecter à leur console de jeux. De nombreux autres attributs sont disponibles pour suivre l’identification de votre personne.

    Sélectionnez Appliquer pour ajouter cet objet au schéma.

  8. Sélectionnez le champ ecid dans l’objet d’identification que vous venez d’ajouter, puis sélectionnez Identité, Identité principale et ECID dans la liste Espace de noms d’identité du panneau de droite.

    Spécifier l’ECID comme identité

    Vous spécifiez Experience Cloud Identity comme identité principale qu’Adobe Experience Platform Identity Service peut utiliser pour combiner (regrouper) le comportement des profils avec le même ECID.

    Sélectionnez Appliquer. Une icône d’empreinte digitale apparaît dans l’attribut ecid.

  9. Sélectionnez le champ e-mail dans l’objet d’identification que vous venez d’ajouter, puis sélectionnez Identité et E-mail dans la liste Espace de noms d’identité du panneau Propriétés du champ.

    Spécifier l’e-mail comme identité

    Vous spécifiez l’adresse e-mail en tant qu’autre identité qu’Adobe Experience Platform Identity Service peut utiliser pour combiner (regrouper) le comportement des profils.

    Sélectionnez Appliquer. Une icône d’empreinte digitale apparaît dans l’attribut d’e-mail.

    Sélectionnez Enregistrer.

  10. Sélectionnez l’élément racine du schéma qui affiche le nom du schéma, puis sélectionnez le sélecteur de Profil.

    Vous êtes invité à activer le schéma pour le profil. Une fois activé, lorsque les données sont ingérées dans des jeux de données basés sur ce schéma, ces données sont fusionnées dans le profil client en temps réel.

    Consultez Activer le schéma à utiliser dans le profil client en temps réel pour plus d’informations.

    note important
    IMPORTANT
    Une fois que vous avez enregistré un schéma activé pour le profil, il ne peut plus être désactivé pour le profil.

    Activer un schéma pour le profil

  11. Sélectionnez Enregistrer pour enregistrer le schéma.

Vous avez créé un schéma minimal qui modélise les données que vous pouvez capturer à partir de votre jeu. Le schéma permet d’identifier les profils à l’aide d’Experience Cloud Identity et de l’adresse e-mail. En activant le schéma pour le profil, vous vous assurez que les données capturées à partir de votre jeu de console sont ajoutées au profil client en temps réel.

En regard des données de comportement, vous pouvez également capturer les données d’attribut de profil à partir de votre console (par exemple, les détails des profils connectés à la console).

Pour capturer des données de profil, vous devez :

  • Créer un schéma basé sur la classe Profil XDM individuel ;

  • Ajouter le groupe de champs Profil principal v2 au schéma ;

  • Ajouter un objet d’identification basé sur le groupe de champs Profil principal v2 ;

  • Définissez l’ID d’Experience Cloud comme identifiant principal et l’e-mail comme identifiant.

  • Activer le schéma pour le profil.

Consultez Créer et modifier des schémas dans l’interface utilisateur pour plus d’informations sur l’ajout et la suppression de groupes de champs et de champs individuels dans un schéma.

Configurer un jeu de données

Le schéma vous a permis de définir le modèle de données. Vous devez maintenant définir le concept pour stocker et gérer ces données à l’aide de jeux de données.

Configurer le jeu de données :

  1. Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Jeux de données sous GESTION DES DONNÉES.

  2. Sélectionnez Créer un jeu de données.

    Créer un jeu de données

  3. Sélectionnez Créer un jeu de données à partir d’un schéma.

    Créer un jeu de données à partir d’un schéma

  4. Sélectionnez le schéma que vous avez créé précédemment et sélectionnez Suivant.

  5. Nommez le jeu de données et (facultatif) fournissez une description.

    Nom du jeu de données

  6. Sélectionnez Terminer.

  7. Sélectionnez le sélecteur de Profil.

    Vous êtes invité à activer le jeu de données pour le profil. Une fois activé, le jeu de données enrichit les profils clients en temps réel avec ses données ingérées.

    note important
    IMPORTANT
    Vous ne pouvez activer un jeu de données pour le profil que si le schéma, auquel le jeu de données adhère, est également activé pour le profil.

    Activer un schéma pour le profil

Consultez Guide de l’interface utilisateur des jeux de données pour plus d’informations sur l’affichage, la prévisualisation, la création et la suppression d’un jeu de données. Ainsi que l’activation d’un jeu de données pour le profil client en temps réel.

Configurer un flux de données

Un flux de données représente la configuration côté serveur lors de l’implémentation des SDK Web et Mobile Adobe Experience Platform et de l’API Adobe Experience Platform Edge Network Server. Lors de la collecte de données avec les SDK Adobe Experience Platform et les API de serveur Edge Network, les données sont envoyées à l’Edge Network Adobe Experience Platform. Il s’agit du flux de données qui détermine les services vers lesquels les données sont transférées.

Dans votre configuration, vous souhaitez que les données que vous collectez du jeu soient envoyées à votre jeu de données dans Adobe Experience Platform.

Configurer le flux de données :

  1. Dans l’interface utilisateur d’Adobe Experience Platform, sélectionnez Flux de données sous COLLECTE DE DONNÉES dans le rail de gauche.

  2. Sélectionnez Nouveau flux de données.

  3. Nommez et décrivez le flux de données. Sélectionnez le schéma dans la liste Schéma d’événement.

    Nouveau flux de données

  4. Sélectionnez Enregistrer.

  5. Sélectionnez Ajouter un service.

  6. Sur l’écran Ajouter un service :

    1. Sélectionnez Adobe Experience Platform dans la liste Service.

    2. Assurez-vous que l’option Activé est sélectionnée.

    3. Sélectionnez le jeu de données dans la liste Jeu de données d’événement.

      Service AEP de flux de données

    4. Gardez les autres paramètres et sélectionnez Enregistrer pour enregistrer le flux de données.

Votre flux de données est maintenant configuré pour transférer les données collectées à partir de votre jeu vers votre jeu de données dans Adobe Experience Platform.

Consultez Présentation des flux de données pour plus d’informations sur la configuration d’un flux de données et la gestion des données sensibles.

Utilisation de l’API du serveur Edge Network

Dans le développement de votre jeu, vous pouvez ajouter des appels pertinents à l’API du serveur Adobe Experience Platform Edge Network, le cas échéant.

Par exemple, pour mettre à jour le score du lecteur, utilisez :

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "primary": true
               }
            ]
         },
         "eventType": "game.scoreUpdate",
         "{sandbox}": {
            "scores": {
               "afterMatch": 132391",
            }
         },
         "timestamp": "2021-08-09T14:09:20.859Z"
      }
   }
}'

Dans l’exemple de requête de POST, {DATASTREAM_ID} pointe vers l’identifiant de l’exemple de flux de données que vous avez configuré précédemment. {sandbox} est le nom unique de votre environnement de test qui identifie le chemin d’accès au groupe de champs Lumière d’aveuglement personnalisé.

Pour plus d’informations sur l’utilisation de l’API du serveur Edge Network, voir Collecte de données interactive et pour plus d’informations sur l’utilisation de l’API du serveur non interactif.

Configurer une connexion

Pour utiliser les données Adobe Experience Platform dans Customer Journey Analytics, vous devez créer une connexion comprenant les données issues de la configuration du schéma, du jeu de données et du workflow.

Une connexion vous permet d’intégrer des jeux de données d’Adobe Experience Platform dans Espace de travail. Pour créer des rapports sur ces jeux de données, vous devez d’abord établir une connexion entre les jeux de données dans Adobe Experience Platform et Workspace.

Créer une connexion :

  1. Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Connexions dans la barre de navigation supérieure.

  2. Sélectionnez Créer une connexion.

  3. Sur l’écran Connexion sans titre :

    Nommez et décrivez la connexion dans Paramètres de connexion.

    Sélectionnez la sandbox appropriée dans la liste Sandbox des Paramètres des données et sélectionnez le nombre d’événements quotidiens dans la liste Nombre moyen d’événements quotidiens.

    Paramètres de connexion

    Sélectionnez Ajouter des jeux de données.

    À l’étape Sélectionner des jeux de données dans Ajouter des jeux de données :

    • Sélectionnez les jeux de données que vous avez créés précédemment et/ou d’autres jeux de données pertinents que vous souhaitez inclure dans votre connexion.

    • Sélectionnez Suivant.

    À l’étape Paramètres des jeux de données dans Ajouter des jeux de données :

    • Pour chaque jeu de données :

      • Sélectionnez un ID de personne parmi les identités disponibles et définies dans les schémas du jeu de données d’Adobe Experience Platform.

      • Sélectionnez la source de données appropriée dans la liste Type de source de données. Si vous spécifiez Autre, ajoutez une description pour la source de données.

      • Définissez Importer toutes les nouvelles données et Données existantes de renvoi du jeu de données selon vos préférences.

    • Sélectionnez Ajouter des jeux de données.

    Sélectionnez Enregistrer.

Consultez Présentation des connexions pour plus d’informations sur la création et la gestion d’une connexion, ainsi que sur la sélection et la combinaison de jeux de données.

Configurer une vue de données

Une vue de données est un conteneur spécifique à Customer Journey Analytics qui vous permet de déterminer comment interpréter les données d’une connexion. Elle spécifie toutes les dimensions et mesures disponibles dans Analysis Workspace et les colonnes dont ces dimensions et mesures obtiennent leurs données. Les vues de données sont définies en vue de la création de comptes rendus des performances dans Analysis Workspace.

Créer une vue de données :

  1. Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Vues de données dans la barre de navigation supérieure.

  2. Sélectionnez Créer une vue de données.

  3. À l’étape Configurer :

    Sélectionnez la connexion dans la liste Connexion.

    Nommez et décrivez (facultatif) la connexion.

    Configuration de la vue de données

    Sélectionnez Enregistrer et continuer.

  4. À l’étape Composants :

    Ajoutez n’importe quel champ de schéma et/ou composant standard que vous voulez inclure dans les zones de composant MESURES ou DIMENSIONS.

    Sélectionnez Enregistrer et continuer.

  5. À l’étape Paramètres :

    Paramètres de la vue de données

    Ne modifiez pas les paramètres et sélectionnez Enregistrer et terminer.

Consultez Présentation des vues de données pour plus d’informations sur la création et la modification d’une vue de données, sur les composants que vous pouvez utiliser dans votre vue de données et sur l’utilisation des paramètres de filtre et de session.

Configurer un projet

Analysis Workspace est un outil de navigation flexible qui vous permet de créer rapidement des analyses et de partager des informations sur la base des données. Les projets Espace de travail vous permettent de combiner des composants de données, des tableaux et des visualisations afin d’élaborer une analyse et de la partager avec tous les membres de l’entreprise.

Créer un projet :

  1. Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Projets dans la barre de navigation supérieure.

  2. Sélectionnez Projets dans la barre de navigation de gauche.

  3. Sélectionnez Créer un projet.

    Projet Espace de travail

    Sélectionnez Projet vierge.

    Espace de travail - Projet vierge

  4. Sélectionnez la vue de données dans la liste.

    Sélectionner la vue de données Espace de travail .

  5. Pour créer votre premier rapport, commencez à faire glisser et à déposer des dimensions et des mesures sur la ​ table à structure libre ​ dans le panneau.

Consultez Présentation d’Analysis Workspace pour plus d’informations sur la création de projets et d’une analyse à l’aide de composants, de visualisations et de panneaux.

SUCCESS
Vous avez terminé toutes les étapes. En commençant par définir les données à collecter (schéma) et l’emplacement de stockage (jeu de données) dans Adobe Experience Platform. Vous avez configuré un flux de données sur l’Edge Network pour vous assurer que les données peuvent être transférées vers ce jeu de données. Vous avez ensuite utilisé l’API Edge Network Server pour envoyer ces données à votre flux de données. Vous avez défini une connexion dans Customer Journey Analytics pour utiliser les données de votre jeu et d’autres données. Votre définition de vue de données vous a permis de spécifier la dimension et les mesures à utiliser. Vous avez enfin créé votre premier projet qui visualise et analyse vos données de jeu.
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79