Résolution des problèmes liés à la diffusion de contenu
Si votre page n’affiche pas le contenu attendu, quelques étapes permettent de déboguer la diffusion du contenu.
- Vérifiez minutieusement le code de votre activité ou campagne. Une coquille ou d’autres erreurs pourraient empêcher le contenu de s’afficher.
- Utilisez mboxTrace ou mboxDebug pour dépanner la requête Target.
- Utilisez le débogueur Adobe Experience Cloud, un outil convivial qui fournit pratiquement les mêmes informations que mboxDebug, pour résoudre les problèmes liés à la requête Target.
mboxDebug est tout particulièrement utile lorsque vous configurez Target sur votre page afin de vérifier que la requête Target est déclenchée et que le cookie est défini. Néanmoins, mboxDebug n’entre pas dans le type de détail qui est utile lors du débogage de la diffusion du contenu. Si votre activité ne s’affiche pas sur la page ou qu’un contenu indésirable s’affiche, utilisez mboxTrace pour examiner et déboguer la page en détail.
Récupérez le jeton d’autorisation à utiliser avec les outils de débogage section_BED130298E794D1FA229DB7C3358BA54
mboxTrace et mboxDebug pouvant exposer des données de campagne et de profil à des parties externes, un jeton d’autorisation est requis. Le jeton d’autorisation peut être récupéré dans l’interface utilisateur de Target. Le jeton est valide pendant six heures.
Vous devez disposer de l’une des autorisations utilisateur suivantes pour générer un jeton d’authentification :
-
Au moins Editor autorisations (ou Approver)
Pour plus d’informations concernant les clients Target Standard, consultez Spécifier les rôles et autorisations dans Utilisateurs. Pour plus d’informations concernant les clients Target Premium, consultez Configuration des autorisations d’Enterprise.
-
Rôle d’administrateur au niveau de l’espace de travail/du profil de produit
Les espaces de travail sont disponibles uniquement pour les clients Target Premium. Pour plus d’informations, consultez Configuration des autorisations d’Enterprise.
-
Droits d’administrateur (autorisation Sysadmin) au niveau du produit Adobe Target
Pour récupérer le jeton d’autorisation :
-
Cliquez sur Administration > Implementation.
-
Dans la section Outils du débogueur, cliquez sur Generate New Authentication Token.
-
Ajoutez le jeton généré en tant que paramètre de votre URL pour activer l’un des outils de débogage avancé.
mboxTrace section_256FCF7C14BB435BA2C68049EF0BA99E
mboxTrace vous permet de recevoir des informations de suivi jointes aux réponses de Target. Les informations de suivi reflètent le résultat d’un appel Target (par exemple, une conversion ou une impression) ainsi que toute donnée supplémentaire qui peut permettre de déterminer pour quelles raisons ce résultat spécifique a été obtenu, par exemple un jeu de branches disponibles parmi lesquelles la sélection a été effectuée dans une campagne. Utilisez ces informations pour déboguer la diffusion du contenu.
Les paramètres suivants sont disponibles :
?mboxTrace=console
Pour at.js, plutôt que dʼafficher une nouvelle fenêtre de navigation ou de générer une sortie dans la console comme cʼétait le cas dans mbox.js (aujourd’hui obsolète), vous devez inspecter la requête réseau et rechercher sous Aperçu (Chrome) ou Réponse (Firefox).
?mboxTrace=json
?mboxTrace=window
?mboxTrace=disable
Exemple d’un appel mboxTrace
https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6
Le résultat présente des informations détaillées sur le contenu. mboxTrace affiche des détails sur la campagne ou sur lʼactivité et le profil. Lʼoutil fournit également un instantané du profil avant lʼexécution et un instantané des modifications après lʼexécution. mboxTrace affiche également les campagnes ou les activités qui ont été évaluées pour chaque emplacement.
Certaines des informations incluent des segments correspondants et non correspondants et des ID cibles :
- SegmentId : ID des segments, provenant de la bibliothèque des segments réutilisables ou segments anonymes créés pour la campagne spécifique.
- TargetId : ID des cibles, provenant de la bibliothèque des expressions cibles ou cibles anonymes créées pour tout segment de la campagne.
- Unmatched : la demande n’a pas abouti dans cet appel pour les segments ou les cibles.
- Matched : la demande a abouti pour les segments ou les cibles spécifiées.
Utilisation de mboxTrace sur les pages de recommandations : l’ajout de mboxTrace en tant que paramètre de requête sur les pages comportant des recommandations remplace la conception Recommendations sur la page par une fenêtre de détails de mboxTrace, qui présente des informations détaillées sur vos recommandations, notamment :
- Les recommandations renvoyées par rapport aux recommandations demandées
- La clé utilisée et si elle génère des recommandations
- Les recommandations générées par des critères par rapport aux recommandations de sauvegarde
- La configuration des critères
- Les exclusions et inclusions appliquées
- Les règles de collection
Vous n’avez pas besoin d’inclure =console
, =json
ou =window
dans le paramètre de requête. Lorsque vous avez terminé avec les détails mboxTrace, ajoutez =disable
et appuyez sur Enter pour revenir au mode d’affichage normal.
mboxTrace n’a aucun impact sur le fonctionnement et l’aspect de votre site. Les visiteurs visualisent la conception habituelle de Recommendations.
mboxDebug mboxdebug
Pour utiliser mboxDebug, ajoutez un paramètre mboxDebug à la fin de votre URL. Le tableau suivant contient des informations sur les paramètres d’URL liés à la réponse Target.
mboxDebug=1
Si vous ajoutez ce paramètre à une URL avec des requêtes Target définies, une fenêtre pop-up contenant des informations importantes sur le débogage s’affiche. Les informations de cookie ainsi que les valeurs PCid et ID de session sont écrites et toutes les URL sont visibles. Cliquez sur une URL de requête Target pour afficher la réponse de cette requête Target. Pour plus d’informations, reportez-vous au fichier mbox_debug.pdf.
mboxDisable=1
mboxOverride.browserIp=<Insert IP address>
Effectuez un test de géociblage avec ce paramètre d’URL. Saisissez une adresse IP comme valeur de cet attribut et la fonction de géociblage de Test&Target évalue cette adresse IP par rapport à un géociblage ou à une segmentation défini dans une campagne.
#
est un identifiant de fragment et entraîne le mauvais fonctionnement des paramètres de débogage.Débogueur Adobe Experience Cloud section_A2798ED3A431409690A4BE08A1BFCF17
Le débogueur Adobe Experience Cloud vous permet de comprendre rapidement et facilement votre implémentation Target. Vous pouvez afficher rapidement la configuration de votre bibliothèque, examiner les demandes pour vérifier que vos paramètres personnalisés sont transmis correctement, activer la journalisation de la console et désactiver toutes les demandes Target. Authentifiez-vous dans Experience Cloud afin de pouvoir utiliser le puissant outil MboxTrace pour inspecter vos qualifications d’activité et d’audience ainsi que votre profil de visiteur.
Pour plus d’informations, consultez les vidéos de formation ci-dessous :
Pour plus d’informations, voir Débogage d’at.js à l’aide du débogueur Adobe Experience Cloud.
Les meilleurs vendeurs n’apparaissent pas dans Recommendations section_3920C857270A406C80BE6CBAC8221ECD
L’appel SiteCatalyst: purchase
ne peut pas être utilisé pour les données de trafic de l’algorithme Purchase. Utilisez plutôt l’appel orderConfirmPage
.
Vérifier la priorité des activités section_3D0DD07240F0465BAF655D0804100AED
Les activités basées sur des formulaires créées avec Target Standard/Premium peuvent être en conflit avec les activités créées dans l’interface utilisateur Target Classic qui ont la même priorité et qui utilisent la même requête Target.
Le code personnalisé ne donne pas les résultats escomptés dans Internet Explorer 8. section_FAC3651F19144D12A37A3E4F14C06945
Target ne prend plus en charge Internet Explorer 8.
Le cookie Target n’est pas défini section_77AFEB541C0B495EB67E29A4475DF960
Si votre site comporte un sous-domaine, tel que us.domain.com, mais que le cookie Target doit être défini sur domain.com (plutôt que us.domain.com), vous devez remplacer le paramètre cookieDomain
. Pour plus d’informations, voir targetGlobalSettings().
Le contenu de Target scintille ou nʼest pas affiché si un élément fait également partie de la personnalisation Adobe Experience Manager. section_9E1DABEB75AB431FB9F09887E6DD07D3
Si un élément DOM fait partie du ciblage de personnalisation d’Adobe Experience Manager (AEM) et d’une activité Target, le contenu de Target peut scintiller ou ne pas s’afficher.
Pour remédier à cette sitation, vous pouvez désactiver la personnalisation AEM dans les pages qui exécutent Target.
Les offres de redirection et distantes ne fonctionnent pas en raison d’une URL non valide. section_7D09043B687F43B39DAEDF17D00375AC
Si l’offre de redirection ou distante utilise une URL non valide, elle risque de ne pas être livrée.
Pour les offres de redirection, la réponse Target peut contenir /* invalid redirect offer URL */
.
Ou
Pour les offres distantes, la réponse Target peut contenir /* invalid remote offer URL */
.
Vous pouvez vérifier la réponse Target dans le navigateur ou utiliser mboxTrace. Reportez-vous à https://tools.ietf.org/html/std66 pour plus d’informations sur les URL valides.
TargetLes requêtes ne se déclenchent pas sur mon site.
at.js ne déclenche pas les requêtes Target si vous utilisez un type doctype non valide. at.js requiert le doctype HTML 5.
Assurez-vous que les activités Target gèrent correctement les URL avec des paramètres de chaîne de requête. query-strings
L’ Activity URL détermine la page qui qualifie les visiteurs pour l’activité et présente les expériences de l’activité aux utilisateurs. Lorsque vous y êtes invité au cours de la création de lʼactivité, la saisie de lʼURL dans son entièreté ne garantit pas toujours que le contenu sera diffusé sur la page du site, en particulier sʼil sʼagit dʼURL contenant des paramètres de chaîne de requête.
Par défaut, le Visual Experience Composer (VEC) ouvre la page qui est spécifiée dans vos paramètres du compositeur d’expérience visuelle. Vous pouvez également spécifier une autre page au cours de la création de lʼactivité.
Pour afficher une autre page après l’ouverture du VEC, cliquez sur Configure gear icon > sélectionnez Page Delivery > puis spécifiez l’URL souhaitée dans le champ Activity URL .
Mais comment dois-je procéder si lʼURL contient des paramètres de chaîne de requête ? Cette méthode fonctionnera-t-elle et permettra-t-elle dʼafficher le contenu personnalisé ? Dans ce scénario, quelle que soit votre audience ciblée, vous pouvez inclure des règles de modèle en plus de lʼURL de base pour définir vos paramètres de requête.
Les options suivantes peuvent être utilisées pour inclure des règles de modèle supplémentaires :
Option 1 : répliquez l’URL et conservez-la dans la règle du modèle avec l’option "contient".
Cette option garantit que lʼURL qualifie pour lʼactivité, mais vous devez être conscient quʼelle risque dʼinfluencer vos données de rapport en ajoutant des enregistrements supplémentaires aux URL qui contiennent lʼURL de base.
Dans ce scénario, lʼURL est https://shopping.mycart.com?type=Summers%20Offers
et la règle de modèle supplémentaire « contient » la même URL, séparée par un opérateur OU :
Option 2 : limite la condition "contient" de l’URL avec uniquement la chaîne de requête.
Le risque abordé dans lʼoption précédente est également présent ici. Toutefois, la configuration conditionnelle est désormais uniquement limitée à la chaîne de requête.
Dans ce scénario, lʼURL est https://shopping.mycart.com?type=Summers%20Offers
et la règle de modèle supplémentaire « contient » uniquement la chaîne de requête, séparée par un opérateur OU :
Option 3 : au lieu de cibler lʼURL complète, limitez-vous à une portion spécifique de lʼURL.
Dans ce scénario, l’URL est https://shopping.mycart.com?type=Summers%20Offers
et des règles de modèle supplémentaires spécifient une Query avec type > is (case sensitive) > type=Summers%20Offres, séparées par un opérateur OU :
L’échappement des guillemets doubles dans la valeur d’attribut de profil Target ne fonctionne pas comme prévu. escape
Lorsque vous envoyez des valeurs contenant des guillemets doubles dans un attribut de profil Target, vous devez les placer dans une double séquence d’échappement comme illustré ci-dessous.
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
Vidéos de formation
Les vidéos suivantes contiennent davantage d’informations sur les concepts abordés dans cet article.