Créer une connexion source Adobe Analytics dans l’interface utilisateur

Ce tutoriel décrit les étapes à suivre pour créer une connexion source Adobe Analytics dans l’interface utilisateur afin d’importer les données de suite de rapports Adobe Analytics dans Adobe Experience Platform.

Prise en main

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 de plateforme 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 Analytics et du schéma 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 mise en oeuvre Adobe Analytics pour capturer des informations spécifiques dans une suite de rapports. Leur utilisation peut différer 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 Analytics documentation 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.
  • Noms conviviaux : les noms conviviaux sont des libellés fournis par l’utilisateur pour les variables personnalisées dans le cadre dʼune implémentation Analytics. Pour plus d’informations sur les noms conviviaux, consultez la Analytics documentation sur les variables de conversion.

Créer une connexion source avec Adobe Analytics

NOTE
Lorsque vous créez un flux de données source Analytics dans un environnement de test de production, deux flux de données sont créés :
  • Flux de données qui effectue un renvoi de 13 mois des données de suite de rapports historiques dans le lac de données. Ce flux de données se termine une fois le renvoi 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 de Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources avec lesquelles vous pouvez créer un compte.

Vous pouvez sélectionner la catégorie appropriée dans le catalogue sur le côté gauche de votre écran. Vous pouvez également utiliser la barre de recherche pour réduire les sources affichées.

Dans la catégorie des applications Adobe, sélectionnez Adobe Analytics, puis Ajouter des données.

catalog

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 comprendre les limites et les obligations de vos données, ainsi que la manière dont vous utilisez ces données dans Adobe Experience Platform entre les régions. Assurez-vous que votre entreprise l’autorise.

La variable Ajout de données à la source Analytics vous fournit une liste de Analytics données de la suite de rapports avec laquelle créer une connexion source.

Une suite de rapports est un conteneur de données qui constitue la base de Analytics création de rapports. Une organisation peut comporter de nombreuses suites de rapports, chacune contenant différents jeux de données.

Vous pouvez ingérer des suites de rapports provenant de n’importe quelle région (États-Unis, Royaume-Uni ou Singapour) tant qu’elles sont mappées à la même organisation que l’instance de sandbox Experience Platform dans laquelle la connexion source est créée. Une suite de rapports peut être ingérée à l’aide d’un seul flux de données actif. Une suite de rapports qui n’est pas sélectionnable a déjà été ingérée, que ce soit dans l’environnement de test que vous utilisez ou dans un autre environnement de test.

Plusieurs connexions entrantes peuvent être établies pour importer plusieurs suites de rapports dans le même environnement de test. Si les suites de rapports comportent des schémas différents pour les variables (comme les eVars ou les é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 en utilisant Préparation de données. Les suites de rapports ne peuvent être ajoutées qu’à un seul environnement de test.

NOTE
Les données de plusieurs suites de rapports ne peuvent être activées pour Real-Time Customer Profile 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.

Pour créer une Analytics connexion source, sélectionnez une suite de rapports, puis sélectionnez Suivant pour continuer.

<!: les suites de rapports Analytics peuvent être configurées pour un environnement de test à la fois. Pour importer la même suite de rapports dans un environnement de test différent, le flux du jeu de données doit être supprimé et instancié à nouveau via la configuration pour un autre environnement de test.—>

Mappage

IMPORTANT
Les transformations de préparation des données peuvent ajouter une latence au flux de données global. La latence supplémentaire ajoutée varie en fonction de la complexité de la logique de transformation.

Avant 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, contenant le groupe de champs Adobe Analytics ExperienceEvent Template. Pour utiliser un schéma par défaut, sélectionnez Schéma par défaut.

default-schema

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é.

custom-schema

La page Mappage fournit une interface permettant de mapper les champs source aux champs de schéma cible appropriés. Dans cette interface, 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
Seuls les schémas comportant le groupe de champs Adobe Analytics ExperienceEvent Template s’affichent dans le menu de sélection des schémas. Les autres schémas sont ignorés. Si aucun schéma approprié n’est disponible pour vos données de suite de rapports, vous devez créer un schéma. Pour obtenir des instructions détaillées sur la création de schémas, consultez le guide de création et de modification des schémas dans l’interface utilisateur.

select-schema

La section Mappage des champs standard affiche des panneaux pour les Mappages standard appliqués, les Mappages standard non correspondants et les Mappages personnalisés. Consultez le tableau suivant pour obtenir des informations spécifiques sur chaque catégorie :

Mappage des champs standard
Description
Mappages standard appliqués
Le panneau Mappages standard appliqués affiche le nombre total d’attributs mappés. Les mappages standard font référence aux jeux de mappages entre tous les attributs des données sources Analytics et les attributs correspondants du groupe de champs Analytics. Ils sont prémappés et ne peuvent pas être modifiés.
Mappages standard non correspondants
Le panneau Mappages standard non correspondants fait référence au nombre d’attributs mappés contenant des conflits de noms conviviaux. Ces conflits apparaissent lorsque vous réutilisez un schéma qui contient déjà un jeu de descripteurs de champs provenant d’une autre suite de rapports. Vous pouvez continuer à utiliser votre flux de données Analytics malgré la présence de conflits de noms conviviaux.
Mappages personnalisés
Le panneau Mappages personnalisés affiche le nombre d’attributs personnalisés mappés, y compris les eVars, les props et les listes. Les mappages personnalisés font référence aux jeux de mappages entre les attributs personnalisés des données sources Analytics et les attributs des groupes de champs personnalisés inclus dans le schéma sélectionné.

map-standard-fields

Pour prévisualiser le groupe de champs de schéma de modèle Analytics ExperienceEvent, sélectionnez Affichage dans le panneau Mappages standard appliqués.

view

La page Groupe de champs de schéma de modèle Adobe Analytics ExperienceEvent fournit une interface permettant dʼexaminer la structure de votre schéma. Lorsque vous avez terminé, sélectionnez Fermer.

field-group-preview

Platform détecte automatiquement tout conflit de noms conviviaux dans vos jeux de mappages. Si aucun conflit nʼest détecté, sélectionnez Suivant pour continuer.

mapping

TIP
Si des conflits de noms conviviaux existent entre votre suite de rapports source et votre schéma sélectionné, vous pouvez tout de même continuer à utiliser votre flux de données Analytics, mais les descripteurs de champ ne seront pas modifiés. Vous pouvez également choisir de créer un autre schéma avec un jeu de descripteurs vierge.

Mappings personnalisés

Vous pouvez utiliser les fonctions de préparation de données pour ajouter un nouveau mappage personnalisé ou des champs calculés pour les attributs personnalisés. Pour ajouter des mappages personnalisés, sélectionnez Personnalisé.

custom

Selon vos besoins, vous pouvez sélectionner l’une des options suivantes : Ajouter un nouveau mappage ou Ajouter un champ calculé et créez des mappages personnalisés pour vos attributs personnalisés. Pour obtenir des instructions complètes sur l’utilisation des fonctions de préparation de données, veuillez lire la section Guide de l’interface utilisateur de la préparation de données.

La documentation suivante fournit d’autres ressources sur la compréhension de la préparation des données, des champs calculés et des fonctions de mappage :

Filtrage pour le profil client en temps réel filtering-for-profile

Une fois que vous avez terminé les mappages pour vos Analytics données de suite de rapports, 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 dans Real-time Customer Profile. La prise en charge du filtrage est uniquement disponible pour Analytics Les données et les données ne sont filtrées que lors de la saisie de Profile. Toutes les données sont ingérées dans le lac de données.

recommendation-more-help

Informations supplémentaires sur la préparation des données et le filtrage des données Analytics pour Real-Time Customer Profile

  • Vous pouvez utiliser la fonctionnalité de filtrage pour les données qui vont dans Profile, mais pas pour les données qui vont dans le lac de données.
  • Vous pouvez utiliser le filtrage des données actives, mais vous ne pouvez pas filtrer les données de renvoi.
    • La variable Analytics La source ne renverse pas les données dans Profile.
  • Si vous utilisez des configurations de préparation de données lors de la configuration initiale d’une Analytics , ces modifications sont également appliquées au renvoi automatique de 13 mois.
    • Cependant, ce n’est pas le cas pour le filtrage, car celui-ci est réservé uniquement aux données actives.
  • La préparation de données est appliquée aux chemins d’ingestion par lots et en flux continu. Si vous modifiez une configuration de prépréparation de données existante, ces modifications sont ensuite appliquées aux nouvelles données entrantes sur les chemins de diffusion en continu et d’ingestion par lots.
    • Toutefois, les configurations de prép de données ne s’appliquent pas aux données qui ont déjà été 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 requis dans Identity Service ou dans Profile.
  • 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 ECID.
  • Lorsqu’une erreur de transformation se produit, la colonne correspondante génère une valeur NULL.

Filtrage au niveau de la ligne

IMPORTANT
Utilisez le filtrage au niveau des lignes pour appliquer des conditions et dicter les données à inclure lors de l'ingestion de profils. Utilisez le filtrage au niveau des colonnes pour sélectionner les colonnes de données à sélectionner. exclusion de l’ingestion de profils.

Vous pouvez filtrer les données pour Profile ingestion au niveau des lignes et des colonnes. Le filtrage au niveau des lignes vous permet de définir des critères tels que chaîne contenant, égal à, commence ou se termine par. Vous pouvez également utiliser le filtrage au niveau des lignes pour joindre des conditions à l’aide de AND ainsi que ORet annuler les conditions à l’aide de NOT.

Pour filtrer votre Analytics données au niveau de la ligne, sélectionnez Filtre de lignes.

row-filter

Utilisez le rail de gauche pour parcourir la hiérarchie de schémas et sélectionnez l’attribut de schéma de votre choix pour approfondir l’analyse d’un schéma particulier.

rail gauche

Une fois que vous avez identifié l’attribut que vous souhaitez configurer, sélectionnez-le et faites glisser l’attribut du rail de gauche vers le panneau de filtrage.

filter-panel

Pour configurer différentes conditions, sélectionnez est égal à puis sélectionnez une condition dans la fenêtre déroulante qui s’affiche.

La liste des conditions configurables inclut :

  • est égal à
  • n’est pas égal à
  • commence par
  • se termine par
  • ne se termine pas par
  • contains
  • ne contient pas
  • exists
  • n’existe pas

conditions

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 la fonction Fabricant attribut.

include-manufacturer

Pour préciser 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, la variable Modèle est ajouté et des modèles tels que iPhone 13 et Google Pixel 6 sont filtrées pour l’ingestion.

include-model

Pour ajouter un nouveau conteneur, sélectionnez les ellipses (...) en haut à droite de l’interface de filtrage, puis sélectionnez Ajouter un conteneur.

add-container

Une fois un nouveau conteneur ajouté, sélectionnez Inclure puis sélectionnez Exclure dans la fenêtre déroulante qui s’affiche.

exclude

Suivez la même procédure en faisant glisser les attributs de schéma et en ajoutant les valeurs correspondantes que vous souhaitez exclure du filtrage. Dans l’exemple ci-dessous, la variable iPhone 12, iPhone 12 mini, et Google Pixel 5 sont tous filtrés à partir de l’exclusion de la variable Modèle , paysage est exclu de la variable Orientation de l’écran, et numéro de modèle A1633 est exclu de Numéro de modèle.

Lorsque vous avez terminé, sélectionnez Suivant.

exclude-examples

Filtrage au niveau des colonnes

Sélectionner Filtre Colonnes à partir de l’en-tête pour appliquer un filtrage au niveau des colonnes.

column-filter

La page se met à jour dans une arborescence de schéma interactive, affichant vos attributs de schéma au niveau de la colonne. À partir de là, vous pouvez sélectionner les colonnes de données que vous souhaitez exclure de Profile ingestion. Vous pouvez également développer une colonne et sélectionner des attributs spécifiques à exclure.

Par défaut, tous les Analytics accéder à Profile et ce processus permet d’exclure des branches de données XDM Profile ingestion.

Lorsque vous avez terminé, sélectionnez Suivant.

colonnes sélectionnées

Filtrage des identités secondaires

Utilisez un filtre de colonne pour exclure les identités secondaires de l’ingestion des profils. Pour filtrer les identités secondaires, sélectionnez Filtre Colonnes 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 primaires, elles ne sont pas filtrées.

identités secondaires

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.

dataflow-detail

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.

review

Surveiller votre flux de données monitor-your-dataflow

Une fois le flux de données terminé, sélectionnez Flux de données dans le catalogue des sources pour surveiller l’activité et l’état de vos données.

Catalogue des sources avec l’onglet des flux de données sélectionné.

Une liste des flux de données Analytics existants dans votre organisation s’affiche. À partir de là, sélectionnez un jeu de données cible pour afficher son activité d’ingestion respective.

Liste des flux de données Adobe Analytics existants dans votre organisation.

La variable Activité du jeu de données fournit des informations sur la progression des données envoyées d’Analytics à Experience Platform. L’interface affiche des mesures telles que le nombre d’enregistrements ingérés, le nombre de lots ingérés et le nombre de lots en échec.

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 être ingérées dans Real-Time Customer Profile, 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 section Présentation de la source Analytics.

Page d’activité du jeu de données pour un jeu de données cible donné pour les données Adobe Analytics.

Affichage de lots individuels à l’aide de l’interface de surveillance héritée

La page d’activité du jeu de données n’affiche pas de liste de lots individuels. Pour afficher une liste de lots individuels, sélectionnez un graphique dans l’interface de l’activité du jeu de données.

Page de l’activité du jeu de données avec un graphique sélectionné.

Vous accédez au tableau de bord Surveillance . Ensuite, sélectionnez SEULS LES ÉCHECS D’INGÉRATION : OUI pour effacer le filtre et afficher une liste de lots individuels.

Le tableau de bord de surveillance avec le filtre d’échec sélectionné.

L’interface se met à jour vers une liste de lots individuels, y compris des informations sur leurs mesures respectives.

Page de surveillance héritée pour les données par lots.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
Mesures Description
Identifiant de lot L’identifiant d’un lot donné. Cette valeur est générée en interne.
Nom du jeu de données Nom d’un jeu de données donné utilisé pour les données Analytics.
Source Source des données ingérées.
Mis à jour Date de l’itération d’exécution de flux la plus récente.
Enregistrements dans un jeu de données Nombre total d’enregistrements dans le jeu de données. Remarque: ce paramètre affiche parfois l’état de in-progress. Ce statut indique que le processus d’ingestion des enregistrements n’est pas encore terminé.
Nouveaux fragments de profil Nombre total de nouveaux fragments de profil qui ont été ingérés.
Fragments de profil existants Comptage total des fragments de profil existants.
Enregistrements d’identité assemblés Comptage total des enregistrements d’identité assemblés après ingestion.
Enregistrements dans le profil Nombre total d’enregistrements ingérés dans Real-Time Customer Profile.

É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 de 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
Lʼinterface utilisateur de Platform affichée dans la vidéo suivante est obsolète. Consultez la documentation pour découvrir les dernières captures dʼécran et fonctionnalités de lʼinterface utilisateur.
337b99bb-92fb-42ae-b6b7-c7042161d089