Installation et configuration de l’intégration entrante
Cet article présente les conditions préalables, responsabilités, étapes de vérification, étapes de dépannage et critères d’achèvement pour configurer l’intégration entrante de Brand Visibility avec Customer Journey Analytics.
Conditions préalables
Tenez compte des conditions préalables suivantes avant d’activer l’intégration entrante. Utilisez la procédure de vérification ci-dessous pour confirmer chaque condition préalable.
Transfert de journal BYOCDN
Les journaux d’accès au réseau CDN doivent être transférés et reçus par Adobe Brand Visibility pour chaque site de Visibilité des marques de données avant que le connecteur source de Visibilité des marques de données puisse être viable.
Cette exigence s’applique à chaque site de Visibilité des marques. Une configuration de réseau CDN ou un flux de journaux pour un site, un domaine ou un sous-domaine ne couvre que ce site.
Confirmez les deux parties de la remise :
- Vous avez configuré le réseau CDN ou le pipeline de journal approprié pour transférer les journaux d’accès requis vers la destination Amazon S3 fournie par Adobe.
- Brand Visibility reçoit et détecte les journaux du site approprié. Le site peut ensuite être sélectionné dans la source Adobe Brand Visibility d’Experience Platform.
Le transfert de journal BYOCDN fournit les données de requête CDN côté serveur utilisées pour l’analyse du trafic des agents automatisés. Les données ne dépendent pas des balises JavaScript exécutées dans un navigateur. L’élément requis
Le flux de journal du réseau CDN s’assure que le jeu de données de résumé en aval contient les données de trafic agentic de Brand Visibility prévues. Pour plus d’informations, consultez la référence du transfert de journal BYOCDN.
Informations requises
Vérifiez que vous disposez de valeurs pour tous les détails requis répertoriés dans le tableau ci-dessous pour chaque site de Visibilité des marques.
Vérifiez que chaque site est disponible à la sélection dans la source Adobe Brand Visibility avant de continuer.
Sandbox
Vous pouvez ajouter le jeu de données à la connexion CJA une fois que le jeu de données aura apparu dans Jeux de données dans cette sandbox.
Confirmez ce qui suit :
- Organisation IMS
- Sandbox Target Experience Platform
Le sandbox AEP cible est le même sandbox nommé utilisé par la connexion Customer Journey Analytics correspondante ou les connexions qui incluent le jeu de données.
Le client peut ajouter le jeu de données à la connexion CJA appropriée uniquement après qu’Adobe a confirmé que le jeu de données géré a été créé.
Jeu de données de résumé
L’intégration entrante fournit un jeu de données de résumé agrégé dans Experience Platform qui contient des informations de requête CDN côté serveur associées à LLM, aux robots et à automated-agent
le trafic.
Brand Visibility utilise les journaux d’accès CDN pour identifier les requêtes provenant des robots et des agents automatisés. Ce trafic ne déclenche pas les balises JavaScript du navigateur et n’est donc pas capturé par le biais d’une implémentation Web Analytics conventionnelle.
Pour obtenir une description détaillée de l’intégration entrante, de la structure du jeu de données et des champs disponibles, voir à propos du jeu de données .
La source de Visibilité des marques crée le jeu de données de résumé dans Experience Platform en utilisant :
- La classe Mesures récapitulatives XDM
- Le groupe de champs Résumé des requêtes CDN
- Champs organisés sous un objet cdn
Le connecteur crée le jeu de données pour chaque site Brand Visibility, en utilisant le modèle de dénomination suivant : Jeu de données Adobe Brand Visibility (ABV) - baseUrl sans schéma.
Par exemple, Adobe Brand Visibility (ABV) Dataset - example.com pour la https://example.com du site.
Les jeux de données créés avant l’adoption de cette convention de nommage affichent le modèle précédent LLM Optimization (LLMO) Dataset - baseUrl sans schéma.
Recherchez le jeu de données dans Jeux de données dans le sandbox où vous avez créé le flux de données.
Le jeu de données est constitué de données de synthèse agrégées. Lors de l’analyse du volume de requêtes dans Customer Journey Analytics, utilisez la mesure Nombre de requêtes CDN fournie plutôt que de compter les lignes du jeu de données.
Vérifiez les champs disponibles dans le schéma du jeu de données créé pour le site de Visibilité des marques spécifique. Pour planifier la configuration de la vue de données, passez en revue les champs.
Responsabilités
Après avoir activé la source de Visibilité des marques, Visibilité des marques :
- Fournit le jeu de données de résumé pour le site que vous avez sélectionné.
- Renvoie le jeu de données dans le sandbox où vous avez créé le flux de données.
Vos responsabilités en tant que client sont les suivantes :
- Pour vous assurer que les journaux CDN sont transférés à et reçus par Brand Visibility pour chaque site Brand Visibility.
- Pour activer la source de Visibilité des marques dans le bon sandbox, vérifiez que votre site est disponible et sélectionnez-le.
- Pour sélectionner la connexion Customer Journey Analytics qui doit inclure le jeu de données.
- Pour ajouter le jeu de données à cette connexion.
- Pour sélectionner les champs à exposer en tant que composants dans la vue de données Customer Journey Analytics appropriée.
- Vérifier que les dimensions et mesures obtenues prennent en charge l’analyse prévue.
Le jeu de données n’est pas disponible pour l’analyse Customer Journey Analytics tant que vous ne l’avez pas ajouté à une connexion. Les données
n’est pas disponible pour les utilisateurs par le biais d’une vue de données tant que les champs pertinents n’ont pas été ajoutés à cette vue de données.
Pour activer la source :
-
Dans Experience Platform, sélectionnez le sandbox dans lequel vous souhaitez placer le jeu de données. Un site ne peut être alloué qu’une seule fois. Assurez-vous donc que ce sandbox est celui que vous souhaitez.
-
Accédez à Sources, puis Catalogue et enfin aux applications Adobe. Sur la carte , sélectionnez Configurer la première fois. Ensuite, la carte affiche Ajouter des données.
-
Sélectionnez Ajouter des données.
-
À l’étape ➊ Sélectionner des données :
-
Sélectionnez le site dans le tableau Nom du site. Une fois qu’un site a été alloué à un flux de données, vous ne pouvez plus sélectionner le site dans ce sandbox ou dans un autre.
-
Sélectionnez Suivant.
-
-
À l’étape ➋ Détails du flux de données :
-
Saisissez un Nom du flux de données et un Description facultatif. Vous pouvez également vous abonner aux alertes Début de l’exécution du flux de données des sources, Succès de l’exécution du flux de données des sources et Échec de l’exécution du flux de données des sources.
-
Sélectionnez Suivant.
-
-
À l’étape ➌ Révision :
-
Vérifiez la connexion et l’affectation du jeu de données.
-
sélectionnez Terminer.
-
Le jeu de données est affecté automatiquement et aucun mappage de champ n’est requis.
Vérification
Procédez comme suit pour vérifier l’intégration entrante :
-
Confirmez la préparation du site ABV et du journal CDN.
Pour chaque site ABV :
- Confirmez le site ou le domaine exact couvert par le transfert du journal CDN.
- Vérifiez que le site est disponible pour sélection dans la source de Visibilité des marques d’Experience Platform. Un site est disponible en fonction de la disponibilité des journaux CDN analysés dans Brand Visibility.
- Ne continuez pas sur une instruction générale selon laquelle « les journaux CDN sont activés ». Poursuivez lorsque le site ABV spécifique peut être sélectionné.
- Vérifiez que Brand Visibility reçoit ou détecte des journaux pour ce site.
- Obtenez d’Adobe la confirmation de préparation à la Visibilité des marques de données du site.
-
Vérifiez le jeu de données dans Experience Platform.
Après avoir créé le flux de données :
-
Connectez-vous à .
-
Sélectionnez le sandbox dans lequel vous avez créé le flux de données.
-
Recherchez le jeu de données de votre site Brand Visibility dans Jeux de données.
-
Vérifiez que le jeu de données est associé au site de Visibilité des marques attendu.
-
Enregistrez le Identifiant du jeu de données et le Schéma lié.
-
Passez en revue le nombre d’enregistrements du jeu de données, les dernières informations d’ingestion et les données d’exemple disponibles lorsque cela est autorisé.
-
Ouvrez le schéma lié et vérifiez la structure XDM attendue :
- Classe : mesures récapitulatives XDM
- Groupe de champs : Résumé des requêtes CDN
- Objet : cdn
- Dimensions et mesures attendues, telles que botType, cdnProvider, url, host, status, requests et timeToFirstByte.
-
-
Ajouter le jeu de données à une connexion
Votre administrateur Customer Journey Analytics doit ajouter le jeu de données à la connexion prévue :
- Connectez-vous à Customer Journey Analytics.
- Créer une connexion ou modifier la connexion existante prévue. Vérifiez que la connexion utilise le même sandbox Experience Platform dans lequel le jeu de données a été créé.
- Recherchez le jeu de données par nom ou par identifiant de jeu de données.
- Ajoutez le jeu de données à la connexion.
- Configurez les paramètres du jeu de données en fonction de la conception Customer Journey Analytics du client.
- Enregistrez la connexion.
- Pour confirmer que le jeu de données est inclus et que l’ingestion est en cours, passez en revue les détails de la connexion.
-
Configurer ou mettre à jour la vue de données
Une fois que le jeu de données fait partie de la connexion :
-
Connectez-vous à Customer Journey Analytics.
-
Créez une vue de données ou modifiez la vue de données associée au cas d’utilisation de création de rapports prévu.
-
Sélectionnez la connexion qui contient le jeu de données Managed Brand Visibility.
-
Ajoutez les champs de schéma requis en tant que dimensions ou mesures.
-
Renseignez les champs nécessaires à l’analyse planifiée, par exemple :
- Type de robot CDN
- Fournisseur CDN
- URL CDN
- Hôte CDN
- Statut HTTP du réseau CDN
- Nombre de requêtes CDN
- Temps moyen jusqu’au premier octet du réseau CDN
-
Enregistrez la vue de données.
-
Validez les champs dans Analysis Workspace ou le workflow de création de rapports sélectionné par le client.
-
-
Validation du résultat de bout en bout
Utilisez une période de création de rapports récente et vérifiez que :
- Le site de Visibilité des marques attendu est représenté.
- Les valeurs attendues du fournisseur de réseau CDN et de l’hôte sont présentes.
- Le trafic des robots ou des agents automatisés est représenté.
- Les dimensions URL et État HTTP contiennent les valeurs attendues.
- Le nombre de requêtes CDN et les mesures de performances sont disponibles.
- Le jeu de données est inclus dans la connexion prévue.
- Les champs obligatoires sont exposés dans la vue de données prévue.
Le temps exact nécessaire à la disponibilité des données dépend du workflow d’ingestion et de traitement Customer Journey Analytics.
Résoudre des problèmes
Examinez les étapes suivantes si des problèmes se produisent :
-
Le jeu de données n’apparaît pas dans AEP.
Vérifiez que :
- L’organisation IMS est correcte.
- Le sandbox Experience Platform sélectionné est correct.
- La source a été activée après le fonctionnement du transfert du journal CDN.
- Le nom ou l’identifiant du jeu de données fourni par Adobe a été utilisé.
- Le jeu de données a été créé pour le site Brand Visibility approprié.
-
Le jeu de données existe mais ne contient aucune donnée attendue.
Vérifiez que :
- Les journaux CDN sont transférés pour le site de Visibilité des marques exact.
- Brand Visibility reçoit ou détecte des journaux pour le site.
- Le site ou le domaine dans la configuration du réseau CDN correspond au site de la Visibilité des marques.
- Le connecteur géré a été activé après la confirmation de la préparation du journal CDN.
- La période sélectionnée inclut la période postérieure au début de l’ingestion du journal.
-
Le jeu de données existe dans Experience Platform mais n’est pas disponible dans Customer Journey Analytics.
Vérifiez que :
- La connexion Customer Journey Analytics utilise le même sandbox Experience Platform nommé.
- Le jeu de données a été explicitement ajouté à la connexion.
- L’administrateur Customer Journey Analytics dispose des autorisations requises.
- La connexion a été enregistrée après l’ajout du jeu de données.
-
Le jeu de données se trouve dans la connexion mais les champs ne sont pas disponibles pour la création de rapports.
Vérifiez que :
- La vue de données sélectionne la connexion Customer Journey Analytics appropriée.
- Les champs de schéma attendus ont été ajoutés en tant que composants de la vue de données.
- Les champs ont été placés dans la section Dimensions ou Mesures prévue.
- La vue de données a été enregistrée après l’ajout des composants.
- Le schéma du jeu de données correspond à la structure attendue du groupe de champs Résumé des requêtes CDN.
-
Le site ne figure pas dans la liste.
Vérifiez que :
- Un site peut être sélectionné en fonction de la disponibilité des journaux CDN analysés dans Brand Visibility.
- Le transfert du journal CDN est configuré et fonctionne pour le site.
-
Impossible de sélectionner le site.
Notez qu’une fois qu’un site est alloué à un flux de données, il ne peut plus être sélectionné dans ce sandbox ou dans un autre. Pour utiliser le site dans un autre sandbox, supprimez le flux de données auquel le site est affecté. Le site peut ensuite être sélectionné à nouveau. La suppression du flux de données a un impact sur toute connexion Customer Journey Analytics ou vue de données qui repose sur les données de cette source.
-
Le flux de données affiche le statut En échec .
Utilisez le tableau de bord Surveillance. La présentation de Sources indique qu’un flux de données source qui échoue en continu pendant 30 jours est automatiquement désactivé.
Critères d’achèvement
L’intégration entrante est prête pour la configuration de Customer Journey Analytics côté client lorsque toutes les conditions suivantes sont confirmées :
- Les journaux CDN sont transférés à et reçus par Visibilité des marques pour chaque site ABV demandé.
- Chaque site de Visibilité des marques peut être sélectionné dans la source Adobe Brand Visibility.
- Vous avez activé la source Adobe Brand Visibility dans le sandbox prévu.
- Le jeu de données de résumé par site apparaît dans ce sandbox.
- Vous avez vérifié le jeu de données et son schéma XDM.
- Vous avez ajouté le jeu de données à la connexion CJA prévue.
- Vous avez configuré les composants de vue de données CJA appropriés.