Ingestion de données via le SDK mobile Adobe Experience Platform
Ce guide de démarrage rapide explique comment ingérer des données de tracking d’application mobile directement dans Adobe Experience Platform à l’aide du SDK mobile Adobe Experience Platform et du réseau Edge. Utilisez ensuite ces données dans 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.
-
Utiliser 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 le cadre 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) qui contient 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 à l’aide de 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électionner Créer un schéma. .
-
À l’étape Sélectionner une classe de l’assistant de création de schéma :
-
Sélectionner Événement d’expérience.
note info INFO Un schéma d’événement d’expérience est utilisé pour modéliser la variable comportement d’un profil (comme le nom de la scène, le bouton poussoir à 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 le Nom et étape de révision du Créer un schéma assistant :
-
Saisir un Nom d’affichage du schéma pour votre schéma et (facultatif) un 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 le Ajouter des groupes de champs , sélectionnez la ExperienceEvent du SDK AEP Mobile groupe de champs de 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 Propriétés du champ panneau, entrée
identificationcomme Nom du champ, Identification comme Nom d’affichage, sélectionnez Objet comme Type et sélectionnez ExperienceEvent Core v2.1 comme Groupe de champs.note note NOTE Si ce groupe de champs n’est pas disponible, recherchez un autre groupe de champs contenant des champs d’identité. Ou créer un groupe de champs et ajouter de nouveaux champs d’identité (comme ecid,crmId, et les 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 au schéma. Dans votre cas, vous devez identifier les profils à l'aide de votre application mobile à l'aide de l'identifiant de l'Experience Cloud et de l'adresse e-mail. De nombreux autres attributs sont disponibles pour effectuer le suivi de l’identification de votre personne (par exemple, l’identifiant client, l’identifiant 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 regard des données de comportement, vous pouvez également capturer les données d’attributs de profil de votre application mobile (par exemple, les détails des profils s’abonnant à une newsletter).
Pour capturer les 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éfinir l’ID de l’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 la structure 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 ces données sont transférées.
Dans votre configuration, vous souhaitez que les données que vous collectez 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.
-
Le flux de données est maintenant configuré pour transférer les données collectées depuis l’application mobile vers le 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 fonctionnalité Balises de 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 à Adobe Experience Platform à l’aide de l’extension du SDK mobile Adobe Experience Platform.
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, puis 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 des Propriétés de balise.
Extensions
Ajoutez l’extension Adobe Platform Edge Network à la balise pour vous assurer que vous pouvez envoyer des données à Adobe Experience Platform (via le flux de données).
Création et configuration de l’extension SDK mobile Adobe Experience Platform :
-
Sélectionner 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’écran jusqu’à Adobe Experience Platform Edge Network et Sélectionner 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.
-
Saisir votre Domaine du réseau Edge dessous Configuration de domaine. Utilisez généralement .
<organizationName>.data.adobedc.net. -
Sélectionnez Enregistrer.
Voir Configuration de l’extension Adobe Experience Platform Edge Network pour plus d’informations.
Vous souhaitez également configurer les extensions supplémentaires suivantes à partir du catalogue :
- Identité.
- Assurance AEP.
- Consentement.
Voir Configuration d’une propriété de balise dans le Tutoriel sur les applications mobiles pour Experience Platform pour beaucoup plus d’informations sur les extensions et leur configuration.
É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 la balise qui peuvent être lus à partir de données ou d’événements d’application mobile et ê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 d’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électionner Mobile Core à partir du Extension liste.
-
Sélectionner Nom de l’opérateur à partir du Type d’élément de données liste.
-
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 lorsqu’elle n’est pas utilisée (poussé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électionner Mobile Core à partir du Extension liste.
-
Sélectionner Premier plan à partir du Type d’événement liste.
-
Sélectionnez Conserver les modifications.
-
-
Clic
-
Sélectionner Mobile Core à partir du Extension liste.
-
Sélectionner Contexte à partir du Type d’événement liste.
-
Sélectionnez Conserver les modifications.
-
-
Clic
-
Sélectionner Adobe Experience Platform Edge Network à partir du Extension liste.
-
Sélectionner Transférer l’événement vers Edge Network à partir du Type d’action liste.
-
Sélectionnez Conserver les modifications.
-
-
La règle doit se présenter comme suit :
-
Sélectionnez Enregistrer.
-
Ce qui précède n’est qu’un exemple de définition d’une règle qui envoie des données XDM, contenant l’état 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.
La 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 workflows de publication simples à complexes qui doivent s’adapter au déploiement de Adobe Experience Platform Edge Network.
Consultez Présentation de la publication pour plus d’informations.
Récupérer le code de balise
Enfin, vous devez utiliser la 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 la balise dans l’application, procédez comme suit :
-
Sélectionnez Environnements dans le rail de gauche.
-
Dans la liste des environnements, sélectionnez l’installation appropriée
Dans le Instructions d’installation pour Mobile , sélectionnez la plateforme appropriée (iOS, Android). Utiliser ensuite la copie
-
Sélectionnez Fermer.
Au lieu du code de l’environnement de développement, vous auriez pu sélectionner un autre environnement (évaluation, production) en fonction du stade auquel vous vous trouvez dans le processus de déploiement du 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ée, 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.
Voir Tutoriel sur l’implémentation de Adobe Experience Cloud dans les applications mobiles pour obtenir des informations beaucoup plus détaillées.
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 générer 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 Espace de travail.
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 d’événements d’expérience de suivi push et les données de profil push depuis 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 et à déposer des dimensions et des mesures sur le Tableau à structure libre dans le Panneau . Par exemple, faites glisser
Eventscomme mesures etPush Titlecomme dimension, ventilée parEvent Typepour 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.