Ingestion de données via le SDK Mobile Adobe Experience Platform
Ce guide de démarrage rapide explique comment ingérer directement des données de suivi d’applications mobiles dans Adobe Experience Platform à l’aide du SDK Adobe Experience Platform Mobile et de l’Edge Network. Utilisez ensuite ces données en Customer Journey Analytics.
Pour ce faire, effectuez les opérations suivantes :
-
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 les balises pour configurer facilement des règles et des éléments de données par rapport aux données de votre application mobile. Ensuite, assurez-vous que les données sont envoyées au flux de données configuré sur Adobe Experience Platform Edge Network.
-
Déployer et valider. Mettez en place un environnement dans lequel vous pouvez itérer sur le développement des balises puis, une fois que tout est validé, procédez à la publication dans l’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.
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 de profils utilisant votre application mobile, par exemple le nom de la scène, l’identification.
Vous devez d’abord définir un schéma qui modélise ces données.
Configurer le schéma :
-
Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Schémas sous GESTION DES DONNÉES.
-
Sélectionnez Créer un schéma.
. -
Dans l’étape Sélectionner une classe de l’assistant Créer un schéma :
-
Sélectionnez Experience Event.
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.). -
Sélectionnez Suivant.
-
-
Dans l’ étape de nom et de révision de l’assistant Créer un schéma :
-
Saisissez un nom d’affichage de schéma pour votre schéma et (facultatif) une description.
-
Sélectionnez Terminer.
-
-
Dans l’onglet Structure de l’exemple de schéma :
-
Sélectionnez + Ajouter dans Groupes de champs.
Les groupes de champs sont des collections d’objets et d’attributs réutilisables permettant d’étendre facilement le schéma.
-
Dans la boîte de dialogue Ajouter des groupes de champs, sélectionnez le groupe de champs AEP Mobile SDK ExperienceEvent dans la liste.
Vous pouvez sélectionner le bouton Aperçu pour afficher un aperçu des champs qui font partie de ce groupe de champs, comme
application > name
.Sélectionnez Précédent pour fermer l’aperçu.
-
Sélectionnez Ajouter des groupes de champs.
-
-
Sélectionnez + en regard du nom du schéma dans le panneau Structure.
-
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.L’objet d’identification ajoute des fonctionnalités d’identification à votre schéma. Dans votre cas, vous souhaitez identifier les profils utilisant votre application mobile à l’aide de l’identifiant Experience Cloud et de l’adresse électronique. De nombreux autres attributs sont disponibles pour effectuer le suivi de l’identification de votre personne (par exemple, l’ID de client, l’ID de fidélité).
Sélectionnez Appliquer pour ajouter cet objet au schéma.
-
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.
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.
-
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.
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.
-
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. -
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 application mobile. 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 application mobile sont ajoutées au profil client en temps réel.
En plus des données de comportement, vous pouvez également capturer les données d’attribut de profil de votre application mobile (par exemple, les détails des profils s’abonnant à une newsletter).
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 :
-
Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Jeux de données sous GESTION DES DONNÉES.
-
Sélectionnez Créer un jeu de données.
-
Sélectionnez Créer un jeu de données à partir d’un schéma.
-
Sélectionnez le schéma que vous avez créé précédemment et sélectionnez Suivant.
-
Nommez le jeu de données et (facultatif) fournissez une description.
-
Sélectionnez Terminer.
-
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.
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 la mise en œuvre des SDK Web et Mobile Adobe Experience Platform. Lors de la collecte de données avec les SDK Adobe Experience Platform, les données sont envoyées à Adobe Experience Platform Edge Network. 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 à partir de l’application mobile soient envoyées à votre jeu de données dans Adobe Experience Platform.
Configurer le flux de données :
-
Dans l’interface utilisateur d’Adobe Experience Platform, sélectionnez Flux de données sous COLLECTE DE DONNÉES dans le rail de gauche.
-
Sélectionnez Nouveau flux de données.
-
Nommez et décrivez le flux de données. Sélectionnez le schéma dans la liste Schéma d’événement.
-
Sélectionnez Enregistrer.
-
Sélectionnez Ajouter un service.
-
Sur l’écran Ajouter un service :
-
Sélectionnez Adobe Experience Platform dans la liste Service.
-
Assurez-vous que l’option Activé est sélectionnée.
-
Sélectionnez le jeu de données dans la liste Jeu de données d’événement.
-
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 application mobile 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.
Utiliser des balises
Pour implémenter du code sur votre site afin de collecter des données, utilisez la fonction Balises dans Adobe Experience Platform. Cette solution de gestion des balises vous permet de déployer le code parallèlement à d’autres exigences de balisage. Les balises offrent une intégration transparente avec Adobe Experience Platform à l’aide de l’extension SDK Adobe Experience Platform Mobile.
Créer une balise
-
Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Balises sous COLLECTE DE DONNÉES.
-
Sélectionnez Nouvelle propriété.
Nommez la balise, sélectionnez Mobile. Sélectionnez Enregistrer pour continuer.
Configurer la balise
Après avoir créé la balise, vous devez la configurer avec les extensions correctes et configurer les éléments de données et les règles en fonction de la manière dont vous souhaitez effectuer le suivi de votre site et envoyer des données à Adobe Experience Platform.
Pour configurer, sélectionnez la balise que vous venez de créer dans la liste Propriétés de balise.
Extensions
Ajoutez l’extension Adobe Platform Edge Network à votre balise pour vous assurer que vous pouvez envoyer des données à Adobe Experience Platform (via votre flux de données).
Pour créer et configurer l’extension du SDK Mobile Adobe Experience Platform :
-
Sélectionnez Extensions dans le rail de gauche. Les extensions Mobile Core et Profil sont déjà disponibles.
-
Sélectionnez Catalogue dans la barre supérieure.
-
Recherchez ou faites défiler l’extension Adobe Experience Platform Edge Network et sélectionnez Installer dans le volet de droite pour l’installer.
-
Sélectionnez la sandbox et le flux de données créé précédemment pour l’Environnement de production, (facultatif) l’Environnement d’évaluation et l’Environnement de développement.
-
Saisissez votre domaine Edge Network sous Configuration de domaine. En règle générale, utilisez
<organizationName>.data.adobedc.net
. -
Sélectionnez Enregistrer.
Pour plus d’informations, voir Configuration de l’extension Adobe Experience Platform Edge Network .
Vous souhaitez également configurer les extensions supplémentaires suivantes à partir du catalogue :
- Identité.
- Assurance AEP.
- Consentement.
Pour plus d’informations sur les extensions et leur configuration, voir Configuration d’une propriété de balise dans le tutoriel de l’application mobile pour Experience Platform.
Éléments de données
Les éléments de données sont les blocs de construction de votre dictionnaire de données (ou mappage de données). Utilisez des éléments de données pour recueillir, organiser et diffuser des données dans les technologies marketing et publicitaires. Vous configurez des éléments de données dans votre balise qui lisent des données ou des événements d’application mobile et qui peuvent être utilisés pour diffuser des données dans Adobe Experience Platform.
Par exemple, vous souhaitez collecter le nom de l’opérateur à partir de l’application mobile.
Pour définir un élément de données de nom de l’opérateur :
-
Sélectionnez Éléments de données dans le rail de gauche.
-
Sélectionnez Ajouter un élément de données.
-
Dans la boîte de dialogue Créer un élément de données :
-
Nommez l’élément de données, par exemple
Carrier Name
. -
Sélectionnez Mobile Core dans la liste Extension.
-
Sélectionnez Carrier Name dans la liste Data Element Type.
-
Sélectionnez Enregistrer.
-
Vous pouvez créer autant d’éléments de données que vous le souhaitez et les utiliser dans des règles.
Règles
Dans Adobe Experience Platform, les balises suivent un système basé sur des règles. Elles recherchent les interactions utilisateur et les données associées. Lorsque les critères définis dans votre règle sont satisfaits, la règle déclenche l’extension, le script ou le code côté client que vous avez identifié. Vous pouvez utiliser des règles pour envoyer des données (comme un objet XDM) dans Adobe Experience Platform à l’aide de l’extension Adobe Experience Platform Edge Network.
Par exemple, vous souhaitez envoyer des données d’événement lorsque l’application mobile est utilisée (au premier plan) et lorsque l’application mobile n’est pas utilisée (repoussée en arrière-plan).
Définir une règle :
-
Sélectionnez Règles dans le rail de gauche.
-
Sélectionnez Créer une règle.
-
Dans la boîte de dialogue Créer une règle :
-
Nommez la règle, par exemple
Application Status
. -
Sélectionnez + Ajouter sous Événements.
-
Dans la boîte de dialogue Configuration d’événement :
-
Sélectionnez Mobile Core dans la liste Extension.
-
Sélectionnez Premier plan dans la liste Type d’événement.
-
Sélectionnez Conserver les modifications.
-
-
Cliquez sur en regard de Mobile Core - Foreground.
-
Sélectionnez Mobile Core dans la liste Extension.
-
Sélectionnez Background dans la liste Event Type.
-
Sélectionnez Conserver les modifications.
-
-
Cliquez sur Ajouter sous ACTIONS. Dans la boîte de dialogue Configuration d’action :
-
Sélectionnez Adobe Experience Platform Edge Network dans la liste Extension.
-
Sélectionnez Forward event to Edge Network dans la liste Action Type.
-
Sélectionnez Conserver les modifications.
-
-
La règle doit se présenter comme suit :
-
Sélectionnez Enregistrer.
-
L’exemple ci-dessus illustre la définition d’une règle qui envoie des données XDM, contenant le statut de l’application, au réseau Adobe Edge et à Adobe Experience Platform.
Vous pouvez utiliser des règles de différentes manières dans la balise pour manipuler des variables (à l’aide des éléments de données).
Consultez les Règles pour plus d’informations.
Créer et publier la balise
Après avoir défini des éléments de données et des règles, vous devez créer et publier la balise. Lorsque vous créez une version de bibliothèque, vous devez l’affecter à un environnement. Les extensions, règles et éléments de données de la version sont ensuite compilés et placés dans l’environnement attribué. Chaque environnement fournit un code incorporé unique qui vous permet d’intégrer la version qui lui est assignée dans votre site.
Créer et publier la balise :
-
Sélectionnez Flux de publication dans le rail de gauche.
-
Sélectionnez Sélectionner une bibliothèque de travail, puis Ajouter une bibliothèque….
-
Dans la boîte de dialogue Créer une bibliothèque :
-
Nommez la bibliothèque.
-
Sélectionnez Développement (développement) dans la liste Environnement.
-
Sélectionnez + Ajouter toutes les ressources modifiées.
-
Sélectionnez Enregistrer et créer pour le développement.
Votre balise est enregistrée et créée pour votre environnement de développement. Un point vert indique que la balise a été créée avec succès dans l’environnement de développement.
-
-
Vous pouvez sélectionner … pour recréer la bibliothèque ou la déplacer vers un environnement d’évaluation ou de production.
Les balises Adobe Experience Platform prennent en charge les processus de publication simples à complexes qui doivent s’adapter à votre déploiement de l’Edge Network Adobe Experience Platform.
Consultez Présentation de la publication pour plus d’informations.
Récupérer le code de balise
Enfin, vous devez utiliser votre balise dans l’application mobile dont vous souhaitez effectuer le suivi.
Pour obtenir des instructions de code expliquant comment configurer votre application mobile et utiliser votre balise dans l’application :
-
Sélectionnez Environnements dans le rail de gauche.
-
Dans la liste des environnements, sélectionnez le bouton d’installation approprié.
Dans la boîte de dialogue Instructions d’installation mobile, sélectionnez la plateforme appropriée (iOS, Android). Utilisez ensuite le bouton Copier en regard de chacun des fragments de code pertinents que vous souhaitez utiliser pour configurer et initialiser votre application mobile :
-
Sélectionnez Fermer.
Au lieu du code de l’environnement de développement, vous avez peut-être sélectionné un autre environnement (d’évaluation et de production) en fonction de l’emplacement où vous déployez le SDK Mobile Adobe Experience Platform.
Consultez Environnements pour plus d’informations.
Déployer et valider
Vous pouvez désormais déployer le code dans votre application mobile. Une fois déployé, votre application mobile commence à collecter des données dans Adobe Experience Platform.
Validez la mise en œuvre, corrigez-la si nécessaire, puis déployez-la dans l’environnement d’évaluation et de production à l’aide du processus de publication des balises.
Pour plus d’informations, consultez le tutoriel Mise en oeuvre de Adobe Experience Cloud dans les applications mobiles .
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 :
-
Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Connexions dans la barre de navigation supérieure.
-
Sélectionnez Créer une connexion.
-
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.
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 (par exemple, les données des événements d’expérience de suivi push et les données de profil push de Adobe Journey Optimizer).
-
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 :
-
Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Vues de données dans la barre de navigation supérieure.
-
Sélectionnez Créer une vue de données.
-
À l’étape Configurer :
Sélectionnez la connexion dans la liste Connexion.
Nommez et décrivez (facultatif) la connexion.
Sélectionnez Enregistrer et continuer.
-
À 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.
-
À l’étape Paramètres :
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 :
-
Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Projets dans la barre de navigation supérieure.
-
Sélectionnez Projets dans la barre de navigation de gauche.
-
Sélectionnez Créer un projet.
Sélectionnez Projet vierge.
-
Sélectionnez la vue de données dans la liste.
.
-
Pour créer votre premier rapport, commencez à faire glisser des dimensions et des mesures sur la table à structure libre dans le panneau . Par exemple, faites glisser
Events
comme mesures etPush Title
comme dimension, ventilées parEvent Type
pour obtenir un aperçu de vos notifications push pour votre application mobile et de ce qui leur est arrivé.
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.