Connexion d’Adobe Analytics à Experience Platform
Créé pour :
- Développeur
Lisez ce guide pour savoir comment utiliser la source Adobe Analytics pour ingérer les données de votre suite de rapports Analytics dans Adobe Experience Platform.
Commencer
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
- Système de modèle de données d’expérience (XDM) : cadre normalisé selon lequel Experience Platform organise les données d’expérience client.
- Profil client en temps réel : fournit un profil client en temps réel unifié basé sur des données agrégées issues de plusieurs sources.
- Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance Experience Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Terminologie clé
Il est important de comprendre les termes clés suivants utilisés dans ce document :
- Attribut standard : les attributs standard sont tous les attributs prédéfinis par Adobe. Ils renferment la même signification pour tous les clients et sont disponibles dans les groupes de champs des données sources et du schéma Analytics d’Analytics .
- Attribut personnalisé : les attributs personnalisés sont tout attribut de la hiérarchie des variables personnalisées dans Analytics. Les attributs personnalisés sont utilisés dans une implémentation d’Adobe Analytics pour capturer des informations spécifiques dans une suite de rapports. Leur utilisation peut varier d’une suite de rapports à l’autre. Les attributs personnalisés comprennent les eVars, les props et les listes. Pour plus d’informations sur les eVars🔗 consultez la documentation Analytics sur les variables de conversion .
- Tout attribut dans les groupes de champs personnalisés : les attributs qui proviennent de groupes de champs créés par les clients sont tous définis par l’utilisateur et sont considérés comme des attributs ni standard ni personnalisés.
Parcourir le catalogue des sources
NOTE- Flux de données qui renvoie pendant 13 mois les données historiques de la suite de rapports dans le lac de données. Ce flux de données se termine lorsque le renvoi est terminé.
- Flux de données qui envoie des données actives au lac de données et à Real-Time Customer Profile. Ce flux de données s’exécute en continu.
Dans l’interface utilisateur d’Experience Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources. Dans la catégorie Applications Adobe, sélectionnez la vignette Adobe Analytics puis sélectionnez Ajouter des données.
Sélectionner les données
IMPORTANT- Les suites de rapports répertoriées à l’écran peuvent provenir de différentes régions. Il vous incombe de connaître les limites et obligations relatives à vos données et la manière dont vous les utilisez dans Adobe Experience Platform d’une région à l’autre. Assurez-vous que votre entreprise l’autorise.
- Les données provenant de plusieurs suites de rapports ne peuvent être activées pour le profil client en temps réel que s’il n’existe aucun conflit de données, comme deux propriétés personnalisées (eVars, listes et props) ayant une signification différente.
Une suite de rapports est un conteneur de données qui forme la base des rapports Analytics. Une organisation peut avoir de nombreuses suites de rapports, chacune contenant des jeux de données différents.
Vous pouvez ingérer des suites de rapports à partir de n’importe quelle région (États-Unis, Royaume-Uni ou Singapour), à condition qu’elles soient mappées à la même organisation que l’instance sandbox Experience Platform dans laquelle la connexion source est en cours de création. Une suite de rapports peut être ingérée à l’aide d’un seul flux de données actif. Si une suite de rapports est grise et ne peut pas être sélectionnée, elle a déjà été ingérée dans le sandbox que vous utilisez ou dans un autre sandbox.
Il est possible d’établir plusieurs connexions entrantes pour importer plusieurs suites de rapports dans le même sandbox. Si les suites de rapports comportent des schémas différents pour les variables (telles que des eVars ou des événements), elles doivent être mappées à des champs spécifiques dans les groupes de champs personnalisés et éviter les conflits de données à l’aide de Préparation de données. Les suites de rapports ne peuvent être ajoutées qu’à un seul sandbox.
Sélectionnez Suite de rapports puis utilisez l’interface Ajout de données à la source Analytics pour parcourir la liste et identifier la suite de rapports Analytics à ingérer dans Experience Platform. Cliquez sur Suivant pour continuer.
<!: les suites de rapports Analytics peuvent être configurées pour un sandbox à la fois. Pour importer la même suite de rapports dans un autre sandbox, le flux du jeu de données devra être supprimé et instancié à nouveau via la configuration pour un autre sandbox.—>
Mappage
IMPORTANTAvant de pouvoir mapper vos données Analytics à un schéma XDM cible, vous devez d’abord déterminer si vous utilisez un schéma par défaut ou un schéma personnalisé.
Un schéma par défaut crée un schéma à votre place. Ce schéma nouvellement créé contient le groupe de champs Adobe Analytics ExperienceEvent Template. Pour utiliser un schéma par défaut, sélectionnez Schéma par défaut.
Un schéma personnalisé vous permet de choisir n’importe quel schéma disponible pour vos données Analytics, à condition que ce schéma contienne le groupe de champs Adobe Analytics ExperienceEvent Template. Pour utiliser un schéma personnalisé, sélectionnez Schéma personnalisé.
Utilisez l’interface Mapping pour mapper les champs source aux champs de schéma cible appropriés. Vous pouvez mapper des variables personnalisées à de nouveaux groupes de champs de schéma et appliquer des calculs pris en charge par la préparation des données. Sélectionnez un schéma cible pour démarrer le processus de mappage.
TIP
Reportez-vous au panneau Mappage des champs standard pour connaître les mesures de vos Mappages standard appliqués. Mappages standard avec conflits de noms de descripteur et Custom mappings.
Mappages standard
Experience Platform détecte automatiquement tout conflit de nom dans votre mappage. S’il n’y a aucun conflit avec vos mappages, sélectionnez Suivant pour continuer.
TIPMappings personnalisés
Vous pouvez utiliser les fonctions de préparation de données pour ajouter de nouveaux mappages personnalisés ou des champs calculés pour les attributs personnalisés. Pour ajouter des mappages personnalisés, sélectionnez Personnalisé.
- Filtrer les champs : utilisez la saisie de texte Filtrer les champs pour filtrer les champs de mappage spécifiques dans vos mappages.
- Ajouter un nouveau mappage : pour ajouter un nouveau mappage de champ source et de champ cible, sélectionnez Ajouter un nouveau mappage.
- Ajouter un champ calculé : si nécessaire, vous pouvez sélectionner Ajouter un champ calculé pour créer un champ calculé pour vos mappages.
- Mappage d’importation : vous pouvez réduire le temps de configuration manuelle de votre processus d’ingestion de données et limiter les erreurs à l’aide de la fonctionnalité de mappage d’importation de la préparation des données. Sélectionnez Importer le mappage pour importer des mappages à partir d’un flux existant ou d’un fichier exporté. Pour plus d’informations, consultez le guide sur l’importation et l’exportation de mappages.
- Télécharger le modèle : vous pouvez également télécharger une copie CSV de vos mappages et configurer vos mappages sur votre appareil local. Sélectionnez Télécharger le modèle pour télécharger une copie CSV de vos mappages. Vous devez vous assurer que vous utilisez uniquement les champs fournis dans votre fichier source et votre schéma cible.
Pour plus d’informations sur la préparation des données, consultez la documentation suivante.
Filtrage pour le profil client en temps réel
Une fois que vous avez terminé les mappages pour les données de votre suite de rapports Analytics, vous pouvez appliquer des règles et des conditions de filtrage pour inclure ou exclure de manière sélective des données de l’ingestion vers le profil client en temps réel. La prise en charge du filtrage est uniquement disponible pour les données Analytics et les données ne sont filtrées qu’avant la saisie Profile. Toutes les données sont ingérées dans le lac de données.
Informations supplémentaires sur la préparation et le filtrage des données Analytics pour le profil client en temps réel
- Vous pouvez utiliser la fonctionnalité de filtrage pour les données qui vont dans Profil, mais pas pour celles qui vont dans le lac de données.
- Vous pouvez utiliser le filtrage pour les données actives, mais vous ne pouvez pas filtrer les données de renvoi.
- La source Analytics ne renvoie pas les données dans le profil.
- Si vous utilisez des configurations de préparation de données lors de la configuration initiale d’un flux Analytics, ces modifications sont également appliquées au renvoi automatique de 13 mois.
- Ce n’est toutefois pas le cas pour le filtrage, car celui-ci est réservé aux données actives.
- La préparation des données est appliquée aux chemins d’ingestion en flux continu et par lots. Si vous modifiez une configuration de préparation de données existante, ces modifications sont ensuite appliquées aux nouvelles données entrantes sur les chemins d’ingestion par lots et par flux.
- Toutefois, les configurations de préparation de données ne s’appliquent pas aux données déjà ingérées dans Experience Platform, qu’il s’agisse de données en flux continu ou de données par lots.
- Les attributs standard d’Analytics sont toujours mappés automatiquement. Par conséquent, vous ne pouvez pas appliquer de transformations aux attributs standard.
- Cependant, vous pouvez filtrer les attributs standard tant qu’ils ne sont pas obligatoires dans le service d’identités ou le profil.
- Vous ne pouvez pas utiliser le filtrage au niveau des colonnes pour filtrer les champs obligatoires et les champs d’identité.
- Bien que vous puissiez filtrer les identités secondaires, en particulier AAID et AACustomID, vous ne pouvez pas exclure l’ECID.
- Lorsqu’une erreur de transformation se produit, la colonne correspondante donne la valeur NULL.
Filtrage au niveau des lignes
IMPORTANTVous pouvez filtrer les données pour l’ingestion de profils au niveau des lignes et des colonnes. Utilisez le filtrage au niveau des lignes pour définir des critères tels que la chaîne contient, est égal à, commence ou se termine par. Vous pouvez également utiliser le filtrage au niveau des lignes pour joindre des conditions à l’aide de AND et de OR, et annuler des conditions à l’aide de NOT.
Pour filtrer vos données Analytics au niveau des lignes, sélectionnez Filtre de ligne et utilisez le rail de gauche pour parcourir la hiérarchie du schéma et identifier l’attribut de schéma à sélectionner.
Une fois que vous avez identifié l’attribut à configurer, sélectionnez-le et faites-le glisser du rail de gauche vers le panneau de filtrage.
Pour configurer différentes conditions, sélectionnez égal à puis sélectionnez une condition dans la fenêtre déroulante qui s’affiche.
La liste des conditions configurables comprend :
- égal à
- différent de
- commence par
- se termine par
- ne se termine pas par
- contient
- ne contient pas
- existe
- n’existe pas
Saisissez ensuite les valeurs à inclure en fonction de l’attribut que vous avez sélectionné. Dans l’exemple ci-dessous, Apple et Google sont sélectionnés pour l’ingestion dans le cadre de l’attribut Fabricant.
Pour spécifier davantage vos conditions de filtrage, ajoutez un autre attribut du schéma, puis ajoutez des valeurs basées sur cet attribut. Dans l’exemple ci-dessous, l’attribut Model est ajouté et les modèles tels que iPhone 16 et Google Pixel 9 sont filtrés pour l’ingestion.
Pour ajouter un nouveau conteneur, sélectionnez les points de suspension (...) en haut à droite de l’interface de filtrage, puis sélectionnez Ajouter un conteneur.
Une fois qu’un nouveau conteneur est ajouté, sélectionnez Inclure puis Exclure dans le menu déroulant. Ajoutez les attributs et les valeurs à exclure, puis, lorsque vous avez terminé, sélectionnez Suivant.
Filtrage au niveau des colonnes
Sélectionnez Filtre de colonne dans l’en-tête pour appliquer un filtrage au niveau des colonnes.
La page se met à jour dans une arborescence de schéma interactif, affichant les attributs de votre schéma au niveau de la colonne. À partir de là, vous pouvez sélectionner les colonnes de données que vous souhaitez exclure de l’ingestion de profils. Vous pouvez également développer une colonne et sélectionner des attributs spécifiques à exclure.
Par défaut, toutes les analyses sont transmises au profil et ce processus permet d’exclure des branches de données XDM de l’ingestion de profils.
Filtrer les identités secondaires
Utilisez un filtre de colonne pour exclure les identités secondaires de l’ingestion de profils. Pour filtrer les identités secondaires, sélectionnez Filtre de colonne puis sélectionnez _identities.
Le filtre s’applique uniquement lorsqu’une identité est marquée comme secondaire. Si des identités sont sélectionnées, mais qu’un événement arrive avec l’une des identités marquées comme principales, elles ne sont pas filtrées.
Fournir des détails sur le flux de données
Dans lʼécran des Détails du flux de données qui s’affiche, vous devez fournir un nom et une description facultative du flux de données. Lorsque vous avez terminé, cliquez sur Suivant.
Révision
L’écran de Révision s’affiche, vous permettant dʼexaminer votre nouveau flux de données Analytics avant sa création. Les détails de la connexion sont regroupés par catégories, notamment :
- Connexion : affiche la plateforme source de la connexion.
- Type de données : affiche la suite de rapports sélectionnée et l’identifiant de suite de rapports correspondant.
Surveiller votre flux de données
Une fois votre flux de données terminé, vous pouvez utiliser l’interface Flux de données pour surveiller le statut de votre flux de données Analytics.
Utilisez l’interface Activité du jeu de données pour plus d’informations sur la progression des données envoyées d’Analytics vers Experience Platform. L’interface affiche des mesures telles que le total des enregistrements du mois précédent, le total des enregistrements ingérés au cours des sept derniers jours et la taille des données du mois précédent.
La source instancie deux flux de jeux de données. L’un représente les données de renvoi, l’autre les données actives. Les données de renvoi ne sont pas configurées pour l’ingestion dans le profil client en temps réel, mais sont envoyées au lac de données à des fins d’analyse et de cas d’utilisation en science des données.
Pour plus d’informations sur le renvoi, les données actives et leurs latences respectives, consultez la présentation de la source Analytics.
NOTESupprimer le flux de données
Pour supprimer votre flux de données Analytics, sélectionnez Flux de données dans l’en-tête supérieur de l’espace de travail des sources. Utilisez la page Flux de données pour localiser le flux de données Analytics à supprimer, puis sélectionnez les points de suspension (...) en regard. Utilisez ensuite le menu déroulant et sélectionnez Supprimer.
- La suppression du flux de données Analytics actif supprimera également son jeu de données sous-jacent.
- La suppression du flux de données d’analyse de renvoi ne supprime pas le jeu de données sous-jacent, mais arrête le processus de renvoi de la suite de rapports correspondante. Si vous supprimez le flux de données de renvoi, les données ingérées peuvent toujours être consultées via le jeu de données.
Étapes suivantes et ressources supplémentaires
Une fois la connexion créée, le flux de données est automatiquement créé pour contenir les données entrantes et renseigner un jeu de données avec votre schéma sélectionné. En outre, un remplissage de données se produit et ingeste jusqu’à 13 mois de données historiques. Une fois l’ingestion initiale terminée, les données Analytics peuvent être utilisées par les services Experience Platform en aval, tels que Real-Time Customer Profile et Segmentation Service. Consultez les documents suivants pour plus d’informations :
La vidéo suivante est destinée à vous aider à comprendre l’ingestion de données à l’aide du connecteur source Adobe Analytics :
WARNING