Si votre page n’affiche pas le contenu attendu, quelques étapes permettent de déboguer la diffusion du contenu.
mboxDebug est particulièrement utile lorsque vous configurez Target sur votre page pour vous assurer que la demande Target se déclenche 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.
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 d’utilisateur suivantes pour générer un jeton d’authentification :
Au moins autorisation de l’éditeur (ou approbateur)
Pour plus d'informations sur les Target Standard clients, voir Spécification des rôles et autorisations dans Utilisateurs. Pour plus d’informations sur les clients Target Premium, voir Configuration des autorisations d’entreprise.
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, voir Configuration des autorisations d’entreprise.
Droits d’administration (autorisation Sysadmin) au niveau du produit Adobe Target
Pour récupérer le jeton d’autorisation :
Cliquez sur Administration > Implémentation.
Dans la section Outils du débogueur, cliquez sur Générer un nouveau jeton d’authentification.
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 vous permet de recevoir des informations de suivi liées aux réponses Target. Les informations de suivi reflètent le résultat d'un appel Target (par exemple, une conversion ou une impression) et toute donnée supplémentaire qui peut aider à déterminer pourquoi ce résultat particulier s'est produit, comme un ensemble 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 :
Options mboxTrace | Résultat |
---|---|
?mboxTrace=console |
Imprime dans le journal de la console sous la forme d’objets. Pour at.js, au lieu d’ouvrir une nouvelle fenêtre de navigateur ou d’afficher les résultats dans la console comme dans mbox.js, vous devrez contrôler la demande de réseau et effectuer une recherche sous Aperçu (Chrome) ou Réponse (Firefox). |
?mboxTrace=json |
Imprime dans le journal de la console sous la forme d’une chaîne JSON littérale |
?mboxTrace=window |
Imprime dans une fenêtre contextuelle sous la forme d’une chaîne JSON |
?mboxTrace=disable |
Désactive le mode de session de suivi. |
Exemple d’appel mboxTrace
https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6
Le résultat présente des informations très détaillées sur le contenu. mboxTrace affiche des détails sur la campagne ou sur l’activité et le profil. mboxTrace 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 :
Utilisation de mboxTrace sur les pages de recommandations : Ajouter mboxTrace en tant que paramètre de requête sur les pages contenant des recommandations remplace la conception Recommendations sur la page par une fenêtre de détails mboxTrace, qui affiche des informations détaillées sur vos recommandations, notamment :
Il n’est pas nécessaire d’inclure =console
, =json
ou =window
dans le paramètre de requête. Lorsque vous avez finalisé le traitement des détails mboxTrace, ajoutez =disable
et appuyez sur Entrée pour revenir au mode d’affichage normal.
mboxTrace n’a aucun impact sur le fonctionnement et l’aspect de votre site. La conception habituelle de Recommandations sera présentée aux visiteurs.
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 de réponse Target.
Certains paramètres mboxDebug sont disponibles avec ou sans authentification.
Paramètres d’URL | Objectif |
---|---|
mboxDebug=1 |
Le débogueur Ajouter ce paramètre à une URL avec des demandes de Cible définies ouvre une fenêtre contextuelle contenant des détails de débogage précieux. Les informations de cookie, ainsi que les valeurs PCid et ID de session sont écrites et toutes les URL des sont visibles. Cliquez sur une URL de demande de Cible pour afficher la réponse de cette requête Target. Pour plus d’informations, reportez-vous au fichier mbox_debug.pdf. |
mboxDebug=x-cookie |
Modification du cookie |
mboxDisable=1 |
Désactivation des mbox dans la page |
mboxDebug=x-profile |
Affichage des jeux de profils |
mboxDebug=x-time |
Afficher le temps de réponse pour chaque requête Target |
mboxOverride.browserIp=<Insert IP address> |
Test de géociblage 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. |
Assurez-vous que le fragment d’URL figure après les paramètres de chaîne de requête. Tout ce qui suit le premier #
est un identifiant de fragment et entraîne le mauvais fonctionnement des paramètres de débogage.
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. Connectez-vous à l’Experience Cloud et vous pouvez utiliser le puissant outil MboxTrace pour vérifier vos activités et vos audiences ainsi que votre profil 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.
Mbox.js envoie un cookie appelé « em-disabled » au visiteur si target.js ne se charge pas au cours de la diffusion. Ce cookie empêche les offres créées en utilisant le compositeur d’expérience visuelle d’effectuer un rendu sur le site. Les visiteurs dotés de ce cookie ne voient pas le contenu du test et ne sont pas comptabilisés dans les rapports d’activité. Tous les autres contenus d’offres (provenant de campagnes dans Target Classic par exemple) continuent à se charger. Le cookie possède une durée de vie de 30 minutes à partir de l’échec du chargement.
L'appel SiteCatalyst: purchase
ne peut pas être utilisé pour les données de trafic de l'algorithme Achat. Utilisez plutôt l'appel orderConfirmPage
.
Les activités basées sur un formulaire créées avec Target Standard/Premium peuvent entrer en conflit avec les activités créées dans l'interface utilisateur Target Classic qui ont la même priorité et utilisent la même requête Target.
Target ne prend plus en charge Internet Explorer 8.
Procédez à la mise à niveau vers mbox.js version 58 ou ultérieure.
mbox.js version 58 et ultérieure exécute le contenu non JavaScript pour la demande globale Target immédiatement après la balise HTML BODY
. Le contenu JavaScript à l’intérieur des balises <script>
pour la demande globale Target s’exécute après le déclenchement du événement DOMContentLoaded
. Cet ordre de diffusion de contenu garantit que le contenu JavaScript pour la demande globale Target est diffusé et rendu correctement.
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().
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 à cela, vous pouvez désactiver la personnalisation AEM dans les pages qui exécutent Target.
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 à l’aide de mboxTrace. Reportez-vous à https://tools.ietf.org/html/std66 pour plus d’informations sur les URL valides.
at.js ne déclenche pas de demandes de Cible si vous utilisez un type doctype non valide. at.js requiert le doctype HTML 5.
Les vidéos suivantes contiennent davantage d’informations sur les concepts abordés dans cet article.