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 particulièrement utile lorsque vous configurez Target sur votre page pour vous assurer que la demande Cible 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

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 :

Pour récupérer le jeton d’autorisation :

  1. Cliquez sur Administration > Implémentation.

  2. Dans la section Outils du débogueur, cliquez sur Générer un nouveau jeton d’authentification.

    Générer un nouveau jeton d’authentification

  3. Ajoutez le jeton généré en tant que paramètre de votre URL pour activer l’un des outils de débogage avancé.

    Jeton d’autorisation

mboxTrace

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 :

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 de sortir vers la console comme c’était le cas dans mbox.js, vous devez inspecter la demande réseau et regarder 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’un appel mboxTrace

https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6

La sortie affiche des informations détaillées sur votre contenu. mboxTrace affiche des détails sur votre campagne ou activité et votre profil. Il fournit également un instantané du profil avant l’exécution et un instantané de ce qui a changé 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

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. Les visiteurs voient votre design Recommendations habituel.

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.

REMARQUE

Certains paramètres mboxDebug sont disponibles avec ou sans authentification.

Paramètres d’URL Objectif
mboxDebug=1 Débogueur
Si vous ajoutez ce paramètre à une URL avec des requêtes Target définies, une fenêtre contextuelle 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.
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 Affichage du 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.
REMARQUE

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.

Débogueur Adobe Experience Cloud

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éboguer at.js à l’aide du débogueur Adobe Experience Cloud.

Les meilleurs vendeurs n’apparaissent pas dans Recommendations

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

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.

Target ne prend plus en charge Internet Explorer 8.

Le cookie Target n’est pas défini

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 cible clignote ou n’est pas affiché si un élément fait également partie de la personnalisation Adobe Experience Manager.

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 situation, vous pouvez désactiver AEM personnalisation sur les pages sur lesquelles Target est en cours d’exécution.

Les offres de redirection et distantes ne fonctionnent pas en raison d’une URL non valide.

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 Target les activités gèrent correctement les URL avec des paramètres de chaîne de requête.

Le URL d’activité détermine la page qui qualifie les visiteurs pour l’activité et rend les expériences d’activité aux utilisateurs. Lorsque vous y êtes invité lors de la création de l’activité, la saisie de l’URL complète ne garantit pas toujours que le contenu est distribué sur cette page de site, en particulier avec les URL qui contiennent des paramètres de chaîne de requête.

Par défaut, la propriété Compositeur d’expérience visuelle (VEC) ouvre la page spécifiée dans votre Paramètres de Visual Experience Composer. Vous pouvez également spécifier une page différente lors de la création d’une activité.

Pour afficher une page différente après l’ouverture du fichier VEC, cliquez sur le bouton Configuration de l’icône d’engrenage > sélectionner Livraison de page > spécifiez ensuite l’URL de votre choix dans la zone URL d’activité champ.

Configuration de l’interface utilisateur des paramètres de remise de page

Mais que se passe-t-il si l'URL contient des paramètres de chaîne de requête ? Fonctionnera-t-il et affichera-t-il le contenu personnalisé ? Dans ce scénario, quel que soit votre public ciblé, 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 cette URL correspond à l’activité, mais sachez qu’il y a des cas d’inflexion qui lui sont joints et qui peuvent influencer vos données de rapport avec des enregistrements supplémentaires d’URL contenant l’URL de base.

Dans ce scénario, l’URL est https://shopping.mycart.com?type=Summers%20Offers et des règles de modèle supplémentaires "contiennent" la même URL, séparées par un opérateur OU :

Réplication de l’URL dans les règles de modèle

Option 2 : Restreindre la condition "contient" de l’URL avec uniquement la chaîne de requête.

Le cas d'angle abordé dans l'option précédente est appliqué dans cette option, mais ici la configuration conditionnelle est limitée à la chaîne de requête uniquement.

Dans ce scénario, l’URL est https://shopping.mycart.com?type=Summers%20Offers et autres règles de modèle "contient" uniquement la chaîne de requête, séparée par un opérateur OR :

La règle de modèle ne contient que la chaîne de requête

Option 3 : Au lieu de cibler l’URL complète, utilisez une partie 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 un Requête avec type > est (sensible à la casse) > type=Summers%20Offres, séparées par un opérateur OU :

Règle de modèle utilisant une partie spécifique de l’URL

Vidéos de formation

Les vidéos suivantes contiennent davantage d’informations sur les concepts abordés dans cet article.

Ajouter l’extension Badge de tutoriel

Débogage de base d’Adobe Target Badge de tutoriel

mboxTrace Badge de tutoriel

Sur cette page