Documentation

Débogage du compositeur d’expérience visuelle (VEC) avec les applications d’une seule page (SPA)

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Cet article fournit les bonnes pratiques pour déboguer les problèmes du compositeur d’expérience visuelle (VEC) avec les applications d’une seule page (SPA) dans Adobe Target.

Description description

Environnement

Adobe Target

Problème/Symptômes

Le VEC Adobe Target pour SPA tire parti d’un nouveau concept appelé Views (un groupe logique d’éléments visuels qui, ensemble, constituent une expérience SPA).

Comme SPA ne dépend pas de la récupération des offres au chargement de la page, il existe quelques restrictions et conditions préalables :

  • Le compositeur d’expérience visuelle SPA ne prend pas en charge les activités de ciblage automatique, de personnalisation automatisée ou de recommandation.

  • at.js 2.0+ et la fonction adobe.target.triggerView() doivent être implémentés dans l’application avant de pouvoir utiliser le compositeur d’expérience visuelle SPA.

  • L’ordre des opérations pour le chargement initial de la page est le suivant :

    Charger VisitorAPI JS" Charger at.js 2.x" Exécuter Requête Target (appel de prérécupération)" Appeler triggerView().

Résolution resolution

Lors du débogage des problèmes du compositeur d’expérience visuelle liés à SPA, vérifiez les points suivants :

  1. Assurez-vous que la fonction adobe.target.triggerView() est déclenchée pour chaque vue.

  2. Assurez-vous que votre page ne coupe pas ou ne supprime pas les paramètres : mboxEdit=1 et mboxDisable=1

    Target ajoute deux paramètres (mboxEdit=1 et mboxDisable=1) lors de l’ouverture du site web dans le compositeur d’expérience visuelle.

    Si votre site web (en particulier les applications d’une seule page) supprime nos paramètres ou les supprime lors de la navigation d’une page à une autre (sans rechargement de page), la fonctionnalité Target est rompue et les bibliothèques Target ne se chargent pas.

  3. Recherchez tout message d’erreur qui peut s’afficher dans les journaux de la console. Par exemple, un problème peut se produire lorsque l’i-frame bloque le chargement de l’affichage. Voici un message d’erreur courant :

    code language-none 
    Uncaught DOMException: Blocked a frame with origin "https://view.customer-website.com" from accessing a cross-origin frame.
at https://www.adobe.com

  4. Recherchez l’appel de notification de vue Target dans les journaux réseau (appel de notification Target avec le statut 204). Si l’appel est bloqué, vérifiez l’état .

  5. Pour les problèmes où la modification ne s’affiche plus dans le VEC mais apparaît dans le panneau de modification ; et vous ne pouvez pas supprimer les modifications du panneau, assurez-vous qu’il n’y a aucun espace de fin dans le nom view.

  6. Voici d’autres détails à vérifier lors de la configuration du nom view:

    • Aucun espace à la fin.
    • Ne peut pas être vide.
    • Le nom Vue doit être unique pour toutes les pages.
    • Le nom de la vue ne doit pas commencer ou se terminer par /. Cela est dû au fait que l’on extrait généralement le nom de la vue à partir du chemin d’URL. Pour nous, home et /home sont différents.
    • La même vue ne doit pas être déclenchée plusieurs fois avec l’option {page: true}.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f