Connecteur source Adobe Analytics pour les données de suite de rapports

Adobe Experience Platform vous permet d’ingérer des données Adobe Analytics par le biais du connecteur source Analytics. Le connecteur diffuse les données de la suite de rapports dans un jeu de données Platform en temps réel, en les convertissant au format XDM.

Fonctionnement du connecteur source Analytics

Vous continuez à utiliser votre implémentation Adobe Analytics existante, telle qu’AppMeasurement ou l’extension de balise Adobe Analytics, pour collecter des données dans vos suites de rapports. Le connecteur source ne modifie pas la manière dont vous collectez ou générez des rapports sur ces données. Une fois que vos données ont atteint les serveurs de collecte de données Analytics, le connecteur en capture une copie.

Graphique illustrant le parcours de données de différentes applications Adobe, y compris Adobe Analytics.

Cette copie est une forme partiellement traitée de chaque accès, connue sous le nom de valeurs moyennes. Analytics produit des valeurs moyennes après le prétraitement (comme les règles de traitement), mais avant le traitement au niveau des visites et des visiteurs. Par conséquent, ils n’incluent pas le contexte de post-traitement, tel que le numéro de visite. L’accès d’origine continue à travers le pipeline pour être écrit dans votre suite de rapports comme d’habitude.

Le connecteur diffuse ces valeurs moyennes en temps réel dans un jeu de données dans Experience Platform. Depuis le lac de données, les données sont disponibles pour Query Service et d’autres applications de découverte de données, et elles peuvent également enrichir le profil client en temps réel.

Pour plus d’informations sur la manière dont Analytics collecte et traite les données, y compris l’étape de valeur moyenne, voir ​ Ordre de traitement des données dans Adobe Analytics.

Mappage des champs Adobe Analytics à XDM

Lorsque vous créez une connexion source dans l’interface utilisateur d’Experience Platform, les champs Analytics sont automatiquement mappés à XDM et ingérés dans un jeu de données Platform. Pour plus d’informations, consultez le tutoriel Connecteur source Analytics.

Pour plus d’informations sur le mappage des champs entre Analytics et Experience Platform, consultez le guide Mappage des champs Adobe Analytics .

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

Identifiants de Principal dans les données Analytics

Chaque accès du connecteur source Analytics contient un identifiant principal qui dépend de l’existence ou non d’un ECID ou d’un AAID. S’il existe un ECID, l’ECID est désigné comme identifiant principal. S’il existe un AAID, l’AAID est désigné comme principal.

Le tableau suivant fournit des informations supplémentaires sur les champs d’identité de vos données Analytics.

Champ d’identité
Description
AAID
L’AAID est l’identifiant d’appareil principal dans Adobe Analytics. Il existe systématiquement dans chaque événement transmis par la source Analytics. L’AAID est parfois appelé l’ID Analytics hérité ou l’ID de cookie s_vi. Malgré cela, un AAID est créé même en l’absence du cookie s_vi. L’AAID est représenté par les colonnes post_visid_high et post_visid_low dans les flux de données Analytics. Sur un événement donné, le champ AAID contient une identité unique qui peut être l’un des différents types décrits dans l’ordre des opérations pour les ID Analytics. Remarque : au sein d’une suite de rapports complète, un AAID peut contenir plusieurs types d’événements.
ECID
L’ECID (ID Experience Cloud) est un champ d’identifiant d’appareil distinct, qui est renseigné dans Adobe Analytics lorsqu’Analytics est implémenté à l’aide du service d’identification des visiteurs. L’ECID est parfois également appelé MCID (Marketing Cloud ID). Si un ECID existe sur un événement, l’AAID peut être basé sur l’ECID selon que le délai de grâce Analytics est configuré ou non. L’ECID est représenté par le mcvisid dans les flux de données Analytics. Pour plus d’informations sur l’ECID, consultez la ​ présentation de l’ECID ​. Pour plus d’informations sur le fonctionnement d’ECID avec Analytics, consultez le document sur les requêtes d’Analytics et d’Experience Cloud ID.
AACUSTOMID
L’AACUSTOMID est un champ d’identifiant distinct qui est renseigné dans Adobe Analytics en fonction de l’utilisation de la variable visitorID dans l’implémentation d’Analytics. Si l’AACUSTOMID est présent, l’AAID est basé sur l’AACUSTOMID, car l’AACUSTOMID surpasse tous les autres identifiants comme défini par l’ordre des opérations pour les Analytics ID.

Traitement des identités par la source Analytics

La source Analytics transmet ces identités à Experience Platform sous forme XDM sous la forme suivante :

  • endUserIDs._experience.aaid.id
  • endUserIDs._experience.mcid.id
  • endUserIDs._experience.aacustomid.id

Ces champs ne sont pas marqués comme identités. Au lieu de cela, les mêmes identités (si elles sont présentes dans l’événement) sont copiées dans le identityMap de XDM en tant que paires clé-valeur :

  • { "key": "AAID", "value": [ { "id": "<identity>", "primary": <true or false> } ] }
  • { "key": "ECID", "value": [ { "id": "<identity>", "primary": <true or false> } ] }
  • { "key": "AACUSTOMID", "value": [ { "id": "<identity>", "primary": false } ] }

Lorsque l’identité ou les identités sont copiées dans identityMap, endUserIDs._experience.mcid.namespace.code est également défini sur le même événement :

  • Si l’AAID est présent, endUserIDs._experience.aaid.namespace.code est défini sur « AAID ».
  • Si l’ECID est présent, endUserIDs._experience.mcid.namespace.code est défini sur « ECID ».
  • Si l’AACUSTOMID est présent, endUserIDs._experience.aacustomid.namespace.code est défini sur « AACUSTOMID ».

Dans le mappage d’identités, si l’ECID est présent, il est marqué comme l’identité principale de l’événement. Dans ce cas, l’AAID peut être basé sur l’ECID en raison de la ​ période de grâce du service d’identification des visiteurs ​. Dans le cas contraire, l’AAID est marqué comme l’identité principale de l’événement. L’AACUSTOMID n’est jamais marqué comme l’ID de Principal de l’événement. Cependant, en présence d’un AACUSTOMID, l’AAID est basé sur l’AACUSTOMID en raison de l’ordre des opérations dans Experience Cloud.

Migration de la gestion de la confidentialité privacy

Utilisez Adobe Experience Platform Privacy Service pour traiter les demandes d’accès à des informations personnelles pour votre jeu de données source Adobe Analytics. Tout d’abord, passez en revue les libellés de vos suites de rapports. Ensuite, configurez manuellement les identités de schéma et les libellés d’utilisation des données. Enfin, basculez la source de confidentialité du flux de données.

Découvrez la gestion des demandes d’accès à des informations personnelles dans la présentation de Privacy Service 🔗.

IMPORTANT
Adobe Analytics obscurcit les identifiants lors du traitement des demandes de suppression des informations personnelles et conserve les données d’accès restantes. Experience Platform supprime plutôt les lignes correspondantes, ce qui peut modifier les mesures de rapports. La recréation de libellés ne conserve pas le comportement de suppression d’Analytics.

Vérifier les libellés des suites de rapports review-analytics-privacy-rules

Avant de migrer, passez en revue les libellés et les espaces de noms d’identité de la suite de rapports qui fournit votre jeu de données. Vous avez besoin de l’autorisation d’administrateur Gouvernance des données dans Adobe Analytics.

  1. Dans Adobe Analytics, accédez à Admin > Tous les administrateurs > Configuration et collecte des données > Gouvernance des données.
  2. Sélectionnez la suite de rapports.
  3. Examinez les libellés de variable pour l’identité, la sensibilité, l’accès et la suppression, ainsi que les espaces de noms d’identité configurés.

La grille d’étiquetage de confidentialité Adobe Analytics répertorie les variables de suite de rapports avec les paramètres d’identité, de sensibilité, d’accès, de suppression et d’espace de noms.

Découvrez les libellés dans la présentation de l’étiquetage de confidentialité. Suivez les instructions pour attribuer ou modifier des étiquettes de confidentialité de suites de rapports. Consultez les définitions des étiquettes de confidentialité des données pour les variables.

Recréer la configuration de confidentialité configure-platform-privacy

Configurez manuellement les identités et les libellés dans le schéma pour votre jeu de données source Analytics. Experience Platform ne copie pas automatiquement les libellés depuis Adobe Analytics.

Configurez les identités de schéma séparément des libellés d’utilisation des données. Utilisez le tableau pour mapper les libellés Analytics aux paramètres Experience Platform.

libellé Adobe Analytics
Configuration d’Experience Platform
ID-DEVICE
Marquez le champ de schéma correspondant comme identité.
ID-PERSON
Marquez le champ de schéma correspondant comme identité.
I1
Appliquez le libellé d’utilisation des données I1.
I2
Appliquez le libellé d’utilisation des données I2.
S1
Appliquez le libellé d’utilisation des données S1.
S2
Appliquez le libellé d’utilisation des données S2.
ACC-ALL, ACC-PERSON
Experience Platform ne prend pas en charge ces libellés. Les demandes d’accès renvoient toutes les données dans les accès correspondants. Vous ne pouvez pas sélectionner les champs à renvoyer.
DEL-DEVICE, DEL-PERSON
Ne recréez pas ces libellés. Experience Platform supprime les lignes correspondantes au lieu d’obscurcir les identifiants.

Appliquez des libellés d’utilisation des données supplémentaires, y compris des C1 via C12, PSPD et RHD, le cas échéant. Les libellés supplémentaires n’ont pas d’équivalents Analytics directs. Les étiquettes I1, I2, S1 et S2 ont des significations correspondantes, mais les produits les utilisent à des fins différentes.

IMPORTANT
La modification des identités de schéma ou des libellés de champ affecte chaque jeu de données qui utilise le schéma. Passez en revue les jeux de données affectés avant de modifier le schéma.

Avant de changer de source de confidentialité, configurez les identités et les libellés d’utilisation des données.

  1. Dans Experience Platform, sélectionnez Schémas, puis ouvrez le schéma de votre jeu de données source Analytics.

  2. Utilisez le mappage des champs 🔗 pour rechercher des champs de schéma pour vos variables Analytics étiquetées.

  3. Marquez les champs de schéma mappés à partir de variables ID-DEVICE ou ID-PERSON comme des identités.

    Suivez les instructions de configuration de l’identité du schéma pour configurer les champs d’identité et les espaces de noms.

  4. Dans l’onglet Libellés, sélectionnez les champs qui nécessitent des libellés d’utilisation des données.

  5. Sélectionnez Appliquer l’accès et les libellés de gouvernance des données, puis sélectionnez les libellés applicables dans le tableau de mappage.

  6. Sélectionnez Enregistrer.

Pour obtenir des instructions détaillées, lisez comment appliquer des libellés à un schéma.

Examinez les paramètres de confidentialité d’Analytics personnalisés, les règles VISTA et les configurations basées sur le contenu et les canaux marketing. Consultez également la section Transformations de la préparation des données . Configurez les identités et les libellés de tous les champs supplémentaires qui en ont besoin.

Changer la source de confidentialité switch-privacy-source

Après avoir configuré les identités et les libellés, basculez sur la source de confidentialité dans l’espace de travail Experience Platform Sources. La migration affecte le jeu de données associé au flux de données sélectionné, et non l’organisation entière.

IMPORTANT
Vous ne pouvez pas annuler la migration après avoir démarré le processus. Pour redémarrer la migration, supprimez la connexion et créez-la à nouveau.
  1. Dans Sources, sélectionnez Flux de données et ouvrez le menu du flux de données à migrer.

    Le menu Flux de données comprend l’action Migrer la confidentialité vers AEP.

  2. Sélectionnez Migrer la confidentialité vers AEP pour ouvrir la boîte de dialogue de confirmation.

    Consultez le rappel de configuration dans la boîte de dialogue de confirmation avant de continuer.

    La boîte de dialogue de migration de la confidentialité comprend un accusé de réception de configuration et l’action Démarrer la migration.

  3. Confirmez la configuration de la confidentialité de votre jeu de données en cochant la case accusé de réception.

  4. Sélectionnez Démarrer la migration.

    Dans Flux de données, la colonne Gestion de la confidentialité s’affiche Migration vers AEP avec un avis de transition.

    La colonne Gestion de la confidentialité affiche Migration vers AEP et un avis de transition.

Précision de l’horodatage des accès et ordre des événements

Le connecteur reçoit les données Analytics sous forme de valeurs moyennes, qui comportent des dates et heures d’accès de deuxième niveau. Comme Analytics enregistre le temps avec une précision de deuxième niveau uniquement et ne suit pas la durée inférieure à la seconde, l’ordre des accès collectés au cours de la même seconde n’est pas déterministe. Par conséquent, l’ordre des événements de même seconde ingérés par le connecteur peut différer de celui affiché dans les rapports Analytics.

Customer Journey Analytics résout les horodatages sur la milliseconde, mais les données provenant d’Analytics ne renseignent que les secondes entières. L’horodatage seul ne peut donc pas établir l’ordre relatif des événements qui partagent la même seconde. Cela est plus visible lorsque plusieurs accès sont collectés au cours de la même seconde (par exemple, une page vue et un accès Adobe Target (A4T)).

Pour plus d’informations sur la précision de l’horodatage Analytics, consultez les documentations Adobe Analytics horodatage variable et Profondeur d’accès. Pour les champs d’horodatage que le connecteur mappe à XDM (hit_time_gmt et post_cust_hit_time_gmt), consultez le guide Mappage de champs Adobe Analytics .

Les options disponibles pour la précision de l’horodatage sont les suivantes :

  • Acceptez les différences mineures de commande de même seconde. Pour la plupart des rapports, l’effet est limité aux événements qui partagent la même seconde et n’affecte pas les mesures agrégées. Il s’agit de l’approche recommandée, y compris pour les scénarios mixtes de pages vues et d’Adobe Target (A4T).
  • Pour les cas d’utilisation sensibles à la commande, préférez le SDK Web. L’envoi de données via le Adobe Experience Platform Web SDK directement vers Experience Platform et Customer Journey Analytics préserve la précision de l’horodatage de moins de la seconde (milliseconde) et évite le retraitement par Analytics. Cette approche est recommandée lorsque l’ordre des événements est important.

Latence des données et renvoi

La latence attendue des données Analytics sur Experience Platform est décrite dans le tableau ci-dessous. La latence varie en fonction de la configuration du client, des volumes de données et des applications clientes. Par exemple, si l’implémentation d’Analytics est configurée avec A4T, la latence du pipeline augmente de 5 à 10 minutes.

Données Analytics
Latence attendue
Nouvelles données du profil client en temps réel (A4T non activé)
< 2 minutes
Nouvelles données du profil client en temps réel (A4T est activé)
jusqu’à 30 minutes
Nouvelles données dans le lac de données
< 2,25 heures
Nouvelles données dans Customer Journey Analytics sans assemblage
< 3,75 heures
Nouvelles données dans Customer Journey Analytics avec l’assemblage
< 7 heures
Renvoi de moins de 10 milliards d’événements
< 4 semaines

Pour plus d’informations sur les latences de Customer Journey Analytics, voir : Mécanismes de sécurisation de Customer Journey Analytics.

Le renvoi Analytics pour les sandbox de production est défini par défaut sur 13 mois. Pour les données Analytics dans les sandbox hors production, le renvoi est défini sur trois mois. La limite de 10 milliards d’événements mentionnée dans le tableau ci-dessus est strictement liée à la latence attendue.

Lorsque vous créez un flux de données source Analytics dans un sandbox de production, deux flux de données sont créés :

  • 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 au profil client en temps réel. Ce flux de données s’exécute en continu.

Bonnes pratiques

Suivez ces bonnes pratiques pour éviter de dépasser vos droits de licence et de surcharger vos mesures de stockage total et de richesse des données :

  • Configurez la durée de vie (TTL) de rétention des jeux de données d’événements d’expérience dès le début pour optimiser la gestion du cycle de vie des données et l’efficacité du stockage. Pour plus d’informations, consultez le guide sur la gestion de la conservation des jeux de données d’événements d’expérience dans le lac de données à l’aide de TTL.
  • Lorsque vous créez un flux de données source Analytics, commencez par configurer le connecteur afin d’ingérer les données uniquement dans le lac de données. Après avoir confirmé que le flux de données fonctionne, vous pouvez activer l’ingestion de profil pour le jeu de données. Cette approche fonctionne mieux lorsque les filtres de ligne et de colonne réduisent efficacement le volume de données. Pour en savoir plus, consultez la documentation connexion d’Adobe Analytics à Experience Platform.

Questions fréquentes

Les données de renvoi Analytics sont-elles comptabilisées dans le nombre de profils sous licence ?
Non. Les données de renvoi Analytics ne sont pas ingérées dans le profil et ne sont donc pas prises en compte dans vos droits de licence.
Puis-je importer plus de 13 mois de données historiques ?
Le renvoi Analytics pour les sandbox de production est défini par défaut sur 13 mois et les sandbox hors production sont limités à trois mois. Pour les sandbox de production, si vous disposez d’une licence pour le SKU supplémentaire qui vous autorise à importer plus de 13 mois de données de renvoi historiques, contactez Adobe pour demander le renvoi étendu.
Comment empêcher l’ingestion d’identités secondaires (AAID et AACUSTOMID) dans le profil client en temps réel ?
Vous pouvez utiliser la préparation de données pour filtrer les identités secondaires provenant d’Analytics, telles que l’AAID et l’AACUSTOMID. Si elles sont filtrées, ces identités ne sont pas ingérées dans le profil même si elles sont disponibles dans les données Analytics entrantes.
recommendation-more-help
experience-platform-help-sources