Dépannage des données Adobe Advertising dans Customer Journey Analytics
Vous trouverez ci-dessous des problèmes potentiels, leurs causes possibles et des solutions.
Liste de tous les problèmes potentiels
_experience.adcloud est absent de la payload du modèle de données d’expérience (XDM) pour les clics publicitaires.alloy() réussit (avec une réponse 200), mais les données de conversion Adobe Advertising sont absentes des rapports._experience.adcloud.Page Views) ne sont pas disponibles pour une dimension de rapport (telle que Campaign) dans CJA Customer Journey Analytics Workspace.Problèmes d’installation et de configuration issues-installation-setup
L’extension WebSDK n’initialise pas websdk-extension-doesn’t-initialize
Événements :
- Aucun appel alloy() n’est visible dans l’onglet Network de l’outil d’inspection du code de votre navigateur.
- Erreur de console : l’alliage n’est pas défini.
- Aucune requête d’interaction ou de collecte n’est envoyée à edge.adobedc.net.
Causes possibles et vérification/résolution
<head> pour la balise de script //assets.adobedtm.com/....Flux de données non configuré ou mal configuré datastream-not-configured-or-misconfigured
Événements :
- Les requêtes atteignent Adobe Experience Platform Edge Network mais renvoient des erreurs 400 ou 500.
- Aucune donnée n’apparaît dans les rapports Adobe Analytics ou Adobe Advertising.
- Erreur dans la réponse réseau : « flux de données introuvable »
Causes possibles et vérification/résolution
- Dans Tags, ouvrez les paramètres de configuration du flux de données de votre propriété de balise.
- Vérifiez que le champ Datastream pointe vers le flux de données correct pour chaque environnement (développement, évaluation et production), ainsi que vers le schéma et le jeu de données corrects.
Chaque environnement doit avoir son propre flux de données, sauf si vous partagez explicitement un flux de données entre les trois environnements.
Ouvrez les paramètres du flux de données et assurez-vous que les services suivants sont activés :
- Adobe Advertising (pour la conversion/synchronisation de l’audience)
- Adobe Experience Platform (pour l’ingestion de profils)
Problèmes de configuration de l’extension Advertising advertising-extension-setup-issues
Événements :
-
Aucune conversion d’affichage publicitaire ou de clic publicitaire n’est enregistrée pour la page web.
Pour vérifier si les conversions sont enregistrées :
- Ouvrez la page web avec des
ef_id=test&s_kwcid=testajoutées à l’URL. - Ouvrez l’outil d’inspection du code de votre navigateur (souvent appelé Inspect), ouvrez l’onglet Network et recherchez un appel d’interaction pour event_type=« advertising.enrichment_ct » de Adobe Experience Platform.
- Dans l’interface de collecte de données, ouvrez la définition du schéma pour les données du site web que vous souhaitez collecter et confirmez que
xdm->_experience->adcloud->conversionDetails->trackingCodeettrackingIdentitiescontiennent desef_idet dess_kwcid.
- Ouvrez la page web avec des
-
_experience.adcloudest absent de la payload du modèle de données d’expérience (XDM) pour les clics publicitaires. -
Les conversions sont confirmées dans un outil de débogage, mais n’apparaissent pas dans les rapports Adobe Advertising
Causes possibles et vérification/résolution
Adobe Advertising n’est pas activé pour le flux de données.-
Dans Tags, ouvrez les paramètres de configuration du flux de données de votre propriété de balise.
-
Activez les services suivants et enregistrez les paramètres :
- Adobe Advertising (pour la conversion/synchronisation de l’audience)
- Adobe Experience Platform (pour l’ingestion de profils)
Adobe Advertising n’est pas activé pour l’extension WebSDK.Le composant Adobe Advertising de l’extension WebSDK est désactivé par défaut et doit être explicitement activé avant que le suivi des clics publicitaires ou des affichages publicitaires Adobe Advertising ne soit fonctionnel, quelle que soit la configuration du schéma ou des règles XDM.
- Dans Tags, ouvrez les options de build de la propriété dans les paramètres de configuration de Adobe Experience Platform Web SDK.
- Activez le composant et enregistrez les paramètres.
- Recréez et republiez la bibliothèque.
Adobe Advertising activé, le suivi des clics publicitaires est automatiquement activé à l’aide des paramètres de requête d’URL s_kwcid et ef_id. Le suivi des vues publicitaires est désactivé par défaut et nécessite une configuration supplémentaire (voir la ligne suivante).- Activer le service Adobe Advertising pour le flux de données
-
- Accédez à Data Collection > Datastreams dans Adobe Experience Platform et ouvrez le flux de données utilisé par votre propriété Tags.
- Sélectionnez Ajouter un service, Adobe Advertising et Adobe Experience Platform, puis sélectionnez Enregistrer. Configuration des annonceurs dans Adobe Advertising DSP
-
- Dans Tags, accédez à Extensions > Installed > Adobe Experience Platform Web SDK > Configure.
- Dans la section Advertiser , sélectionnez un annonceur dans la liste déroulante et activez-le. Pour configurer plusieurs annonceurs, sélectionnez Ajouter un annonceur. Vérifiez que les pixels de conversion de visionneuse se déclenchent
- Dans Adobe Experience Platform Debugger, vérifiez que l’appel d’interaction comprend des
stitchIdsous le champxdm.query. - Dans l’onglet Network de l’outil d’inspection du code de votre navigateur, confirmez qu’un événement de type
advertising.enrichmentest déclenché et inclut desstitchIdsousxdm.query.
Les conversions d’affichage publicitaire ne se déclenchent que toutes les 30 minutes, quel que soit le nombre de visites. Si aucun appel d’interaction ne s’affiche, effacez la mémoire cache du navigateur et réessayez.
Avant d’ouvrir un ticket d’assistance pour Advertising problèmes de configuration de l’extension, vérifiez les points suivants :
- Les services et Adobe Experience Platform sont ajoutés au flux de données.
- Le composant est activé dans la configuration de l’extension WebSDK.
- La bibliothèque a été reconstruite et republiée après l’activation du composant.
- Pour le suivi des clics publicitaires, l’URL de la page de destination contient les
s_kwcidet lesef_idsur les clics publicitaires. - Pour le suivi d’affichage publicitaire, un annonceur est configuré dans Adobe Advertising DSP avec l’ID d’annonceur approprié.
- L’extension WebSDK est de la version 2.36.0 ou ultérieure.
Problèmes d’identité et d’ECID identity-and-ecid-issues
Événements :
- L’identifiant visiteur change entre les pages.
- Les segments d’audience Advertising ne correspondent pas.
Causes possibles et vérification/résolution
idMigrationEnabled est défini sur false tant qu’un cookie de s_ecid hérité est présent.idMigrationEnabled: true dans la configuration de base du SDK Web pour migrer l’ECID existant à partir des cookies s_ecid ou AMCV_.Les règles ou les événements ne se déclenchent pas #rules-or-events-don’t-fire
Événements :
- Le débogueur indique que les conditions de la règle ne sont pas remplies.
- L’action Send Event ne s’exécute jamais.
Vérification et résolution
Vérifiez les points suivants :
- La règle est enregistrée et incluse dans la version de bibliothèque active.
- Le type d’événement correspond au comportement réel de la page (par exemple, Library Loaded ou DOM Ready ou Window Loaded).
- Les conditions de la règle ne sont pas trop restrictives. Testez en supprimant temporairement les conditions pour isoler le problème.
- L’ordre des règles est correct. Si plusieurs règles partagent le même événement, vérifiez l’ordre des règles.
- Aucune erreur JavaScript antérieure sur la page n’interrompt l’exécution. Recherchez des exceptions non interceptées dans la console du navigateur.
Problèmes de création et de publication de bibliothèque library-build-and-publishing-issues
Événements :
- Les modifications apportées dans Tags ne sont pas répercutées sur le site actif.
- Une mise à jour d’extension a été appliquée, mais l’ancien comportement persiste.
Causes possibles et vérification/résolution
Problèmes de validation des schémas pour les champs Advertising schema-validation-for-advertising-fields
Événements :
- L’appel de l’événement d’envoi
alloy()réussit (avec une réponse 200), mais les données de conversion Adobe Advertising sont absentes des rapports. - La payload XDM du débogueur n’affiche aucun objet
_experience.adcloud.
Causes possibles et vérification/résolution
- Accédez à Adobe Experience Platform > Data Management > Schemas.
- Ouvrez le schéma utilisé par votre flux de données.
- Dans le panneau Field Groups, confirmez que Extension complète Adobe Advertising Cloud ExperienceEvent est répertoriée.
- S’il est manquant, sélectionnez Ajouter, recherchez Adobe Advertising Cloud, sélectionnez Extension complète Adobe Advertising Cloud ExperienceEvent, puis enregistrez les paramètres.
La republication de votre bibliothèque Tags n’est pas nécessaire pour les seules modifications de schéma, mais vous devez remapper l’élément de données XDM dans Tags si de nouveaux champs ont été ajoutés.
_experience.adcloud.conversionDetails. Voir « Référence : champs de schéma obligatoires ».Si l’un des champs est manquant, vérifiez que le groupe de champs Extension complète Adobe Advertising Cloud ExperienceEvent a été enregistré dans le schéma, puis actualisez l’éditeur de schémas.
s_kwcid et les paramètres ef_id, tels que https://www.example.com/landing-page?s_kwcid=AL!12345!3!abc123&ef_id=abc123xyz:G:s. Consultez « Référence : paramètres de requête manquants » pour connaître les causes probables.edge.adobedc.net et inspectez le corps de la requête d’interaction (voir l’exemple de payload ci-dessous).Si
trackingCode ou trackingIdentity sont vides ou manquants, alors a) le paramètre de requête n’était pas présent sur la page lors du déclenchement de la règle (vérifiez l’URL et le timing de l’événement de la règle) ou b) le groupe de champs est absent du schéma (revenez sur la première ligne ci-dessus).Référence : champs de schéma obligatoires required-schema-fields
_experience.adcloud.conversionDetails.trackingCodes_kwcid sur l’URL de la page de destination._experience.adcloud.conversionDetails.trackingIdentityef_id sur l’URL de la page de destination.Référence : paramètres de requête manquants missing-query-parameters
s_kwcidef_idExemple de payload de clic publicitaire
{
"events": [{
"xdm": {
"eventType": "advertising.clicks",
"_experience": {
"adcloud": {
"conversionDetails": {
"trackingCode": "AL!12345!3!abc123",
"trackingIdentity": "abc123xyz:G:s"
}
}
}
}
}]
}
Signaler des problèmes dans Customer Journey Analytics Workspace
Rapports de synthèse
- Vérifiez que Customer Journey Analytics Workspace référence la vue de données appropriée.
- Vérifiez que le flux d’Adobe Advertising vers Customer Journey Analytics est activé. Vérifiez auprès de l’équipe chargée de votre compte Adobe.
- Vérifiez que votre jeu de données de dimension/classification/recherche Adobe Advertising et votre jeu de données de résumé sont inclus dans votre connexion Customer Journey Analytics.
- Vérifiez que vos dimensions et mesures récapitulatives Adobe Advertising sont incluses dans votre vue de données Customer Journey Analytics.
Si vous vérifiez tous les paramètres ci-dessus mais que vous ne voyez toujours pas de données récapitulatives, ouvrez un ticket d’assistance pour votre organisation.
- Vérifiez que le flux d’Adobe Advertising vers Customer Journey Analytics est activé pour l’annonceur 2. Vérifiez auprès de l’équipe chargée de votre compte Adobe.
- Vérifiez que le paramètre « Backfill all existing data » est activé pour vos trois jeux de données (dimension/classification/recherche, résumé et mesures d’événement) dans votre connexion Customer Journey Analytics.
Si vous vérifiez toutes les conditions ci-dessus mais que vous ne voyez toujours pas de données récapitulatives, ouvrez un ticket d’assistance pour votre organisation.
Si le flux est activé pour un compte mais que vous ne voyez toujours pas de données récapitulatives, ouvrez un ticket d’assistance pour votre organisation. Incluez le Account ID du compte réseau publicitaire.
- Vérifiez que vous utilisez les mêmes périodes dans le rapport Workspace et dans le rapport Adobe Advertising.
- Vérifiez que les filtres et les segments appliqués dans Workspace et le rapport Adobe Advertising ne provoquent pas de différences dans les données.
- Vérifiez que la Time Zone de votre vue de données Customer Journey Analytics correspond à la Default Timezone de votre compte Advertising DSP.
- Vérifiez que le paramètre « Backfill all existing data » est activé pour vos trois jeux de données (dimension/classification/recherche, résumé et mesures d’événement) dans votre connexion Customer Journey Analytics.
Si vous êtes sûr d’une incohérence des données, ouvrez un ticket d’assistance pour votre organisation. Incluez le Account ID du compte réseau publicitaire. Pour montrer la preuve de l’incohérence, incluez des captures d’écran et des feuilles de calcul. Votre équipe de compte Adobe peut corriger rétroactivement le flux de données pour résoudre l’incohérence, si nécessaire.
Reporting au niveau des événements
Page Views) ne sont pas disponibles pour une dimension de rapport (telle que Campaign) dans Customer Journey Analytics Workspace.Vérifiez les points suivants, en commençant par les éléments présentant le moins de barrières de vérification :
- Vérifiez que vous utilisez la vue de données appropriée.
- Vérifiez que les mesures de conversion applicables sont des événements web/en ligne qu’Adobe Advertising peut attribuer aux dimensions.
- Vérifiez qu’Adobe Advertising effectue le suivi des clics publicitaires et des affichages publicitaires sur le site approprié.
- Dans la connexion Customer Journey Analytics du jeu de données de classifications, vérifiez que les valeurs des paramètres Key et Matching Key sont correctes : Key :
Tracking Code(_customername.adLens2.trackingCode), Matching Key :Tracking Code(event._experience.adcloud.conversionDetails.trackingCode). - Vérifiez que le service Adobe Advertising est ajouté au flux de données Adobe Experience Platform, que le schéma mappé pour le flux de données est
XDM ExperienceEvent Schemaet que leAdobe Advertising Cloud ExperienceEvent Full Extensiondu groupe de champs est ajouté au schémaXDM ExperienceEvent. - Vérifiez que les paramètres Adobe Advertising sont correctement configurés dans l’extension WebSDK et publiés.
Si vous vérifiez tous les paramètres ci-dessus mais que vous ne voyez toujours pas les données de conversion, ouvrez un ticket d’assistance pour votre organisation. Incluez le Account ID du compte réseau publicitaire.
Outils de validation et de débogage utiles
Adobe Experience Platform Debugger
Installez l’extension Adobe Experience Platform Debugger pour Chrome pour :
- Affichage en temps réel de tous les appels de
alloy()WebSDK - Validation de l’environnement et de l’identifiant du flux de données
- Inspection de la payload XDM
- Détails de la requête et de la réponse Edge Network
Vérifications de clés dans le débogueur :
advertising.enrichment.Network de l’outil d’inspection du code de votre navigateur
Utilisez l’onglet Network de l’outil d’inspection du code de votre navigateur (souvent appelé « Inspect ») pour effectuer les opérations suivantes :
Filtrez par edge.adobedc.net pour inspecter les requêtes Edge Network brutes :
- URL de la demande :
https://[org-id].data.adobedc.net/ee/v2/interact - Méthode :
POST - Statut :
200(sain),400(payload incorrecte) ou500(erreur de serveur ou de flux de données)
Vérifiez la payload de la requête pour :
- La bonne
dataStreamId - Présence d’un objet
xdmavec les champs attendus - Un
identityMapavec l’ECID renseigné
Validation de la console
Vérifiez la version du SDK Web installée :
window.alloy.version
Déclenchez manuellement un événement de test :
alloy("sendEvent", {
xdm: {
eventType: "web.webpagedetails.pageViews",
web: {
webPageDetails: { name: "Test Page", URL: window.location.href }
}
}
}).then(result => console.log("Edge response:", result))
.catch(err => console.error("Send event error:", err));
Liste de contrôle de référence rapide avant de demander de l’aide
Vérifiez les points suivants avant d’ouvrir un ticket d’assistance :
- L’extension WebSDK dispose de la dernière version.
- La bibliothèque est publiée et le code incorporé est correct pour l’environnement.
- L’identifiant du flux de données est défini correctement pour le développement, l’évaluation et la production.
- Tous les services de flux de données requis sont activés.
- Le composant Advertising est activé dans la configuration de l’extension WebSDK et un ID d’annonceur DSP est configuré.
- Le schéma XDM inclut le groupe de champs Advertising.
- La règle Send Event inclut un mappage d’identités et se déclenche sur l’événement correct.
- Aucun CSP ni paramètre de confidentialité du navigateur ne bloque les requêtes Edge Network.
- L’Adobe Experience Platform Debugger confirme que les événements atteignent l’Edge Network.
- Aucune erreur JavaScript dans la console du navigateur n’interrompt l’exécution.
- Le groupe de champs
Adobe Advertising Cloud ExperienceEvent Full Extensionest ajouté au schéma. _experience.adcloud.conversionDetails.trackingCodeest présent dans le schéma._experience.adcloud.conversionDetails.trackingIdentityest présent dans le schéma.- L’URL de la page de destination contient les paramètres
s_kwcidetef_iden cas de clic publicitaire. - L’Adobe Experience Platform Debugger confirme que
conversionDetailsest renseigné dans la payload sortante.
Quand signaler un problème
Contactez votre équipe de compte Adobe ou votre équipe d’ingénieurs si :
- Les requêtes Edge Network renvoient des erreurs
500persistantes après la validation du flux de données. - Les conversions Advertising sont confirmées dans le débogueur, mais n’apparaissent pas dans les rapports après 24 à 48 heures.
- Une mise à jour de la version du SDK Web introduit une régression qui n’était pas présente dans la version précédente. Incluez les numéros de version spécifiques dans le ticket de support.