Une fois le processus d’implémentation terminé, il est important de vérifier que votre script, le contexte de la page, les événements et le flux de données sont correctement configurés. Cet article vous guide dans le processus de ces validations pour une implémentation web standard.
Il existe deux manières de valider l’implémentation :
-
Statut de l’implémentation :
- Synchronisation périodique : un résumé des 12 dernières heures
- Synchronisation API : un résumé des 7 derniers jours
- Implementation Helper (aide à l’implémentation) : Outil de débogage immédiat dans votre navigateur.
Statut de l’implémentation
Sur la console Dynamic Yield, rendez-vous sur votre site. Le premier panneau de la page de votre site indique le statut de l’implémentation. Cette zone fournit un aperçu du statut de votre script, du contexte de la page, des événements et du flux de produits. Vous pouvez également télécharger un fichier de log pour obtenir des détails supplémentaires sur le statut de l’implémentation. Ce fichier de log couvre les 12 dernières heures pour le flux périodique et les 7 derniers jours pour l’API. Le contexte de la page, les événements et le statut du flux de produits ne sont disponibles que pour les sites de commerce électronique.
Le tableau suivant fournit des détails sur chaque statut possible.
| Élément | Statut | Description/Seuil |
|---|---|---|
| Script | Not implemented | Aucun script détecté |
| Implemented | Le script est détecté. Cela ne permet pas de vérifier que le script se trouve bien dans l’en-tête. | |
| Page Context | Not detected | Aucune information sur le contexte de la page n’a été envoyée au cours des 12 dernières heures. Il faut au moins 100 pages vues pour chaque type de page. |
| Validated | Il peut y avoir des erreurs dans un maximum de : 2 % de vos pages de produits, 2 % de vos pages de panier, ou 5 % de vos pages de catégories |
|
| Accepted with warnings | Il y a des erreurs dans : 2 à 7 % de vos pages de produits, 2 à 7 % de vos pages de panier, ou 5 à 10 % de vos pages de catégories |
|
|
1 error (Le nombre d’erreurs correspond au nombre de types de contexte de page qui ont dépassé le seuil d’erreur) |
Il y a des erreurs dans plus de : 7 % de vos pages de produits, 7 % de vos pages de panier, ou 10 % de vos pages de catégories |
|
| Events | Not received | Aucun événement reçu au cours des 12 dernières heures |
| Validated | Il peut y avoir des erreurs dans un maximum de : 2 % des événements d’ajout au panier, de synchronisation du panier, de suppression du panier ou d’achat 20 % de vos événements de connexion, d’abonnement ou d’inscription, ou 50 % des événements de filtre, de tri, de changement d’attribut, de mot-clé ou de visionnage de vidéo. |
|
| Accepted with warnings | Il y a des erreurs dans 2 à 7 % de vos événements d’ajout au panier, de synchronisation du panier, de suppression du panier ou d’achat. | |
|
1 error (Le nombre d’erreurs correspond au nombre de types d’événements qui ont dépassé le seuil d’erreur) |
Il y a des erreurs dans plus de : 7 % de vos événements d’ajout au panier, de synchronisation du panier, de suppression du panier ou d’achat, 20 % des événements de connexion, d’abonnement ou d’inscription, ou 50 % des événements de filtrage, de tri, de modification d’attribut, de mot-clé ou de visionnage de vidéo. |
|
| Product feed | Not synced | Vous n’avez pas encore essayé de synchroniser un flux de données. |
| Synced |
Synchronisation périodique : Vous avez synchronisé avec succès un flux de données Synchronisation par API : Il y a jusqu’à 0,5 % d’avertissements dans les demandes de synchronisation. |
|
| Synced with warnings |
Synchronisation périodique : Le flux a été synchronisé, mais certaines lignes individuelles n’ont pas été synchronisées en raison d’erreurs, telles que l’absence de certaines données. Consultez le fichier de log pour plus de détails. Synchronisation par API : Il y a 0,5 % à 2 % d’avertissements dans les demandes de synchronisation. Certaines actions n’ont pas été synchronisées en raison d’erreurs, telles que l’absence de certaines données. Consultez le fichier de log de l’API pour plus de détails. |
|
| Failed to sync |
Synchronisation périodique : Le flux de données n’a pas été synchronisé en raison d’une erreur. Consultez le fichier de log pour plus de détails. Synchronisation par API : Il y a plus de 2 % d’avertissements ou plus de 0,5 % d’erreurs dans les demandes de synchronisation. Certaines actions n’ont pas été synchronisées en raison d’erreurs, telles que l’absence de certaines données. Consultez les logs de l’API pour plus de détails. |
Remarque : le statut des événements et le contexte des pages sont mis à jour toutes les dix minutes.
Si vous estimez que les seuils décrits sont trop sensibles ou pas assez sensibles pour votre site, contactez notre équipe d’assistance pour qu’elle réalise des ajustements.
Remarque : après la résolution d’un problème, il peut s’écouler un certain temps avant que le statut d’erreur ou d’avertissement ne soit modifié. En effet, les seuils sont calculés sur la base des données combinées des 12 dernières heures ou des 7 derniers jours (mise à jour périodique ou de l’API, respectivement). Vous pouvez vérifier qu’un problème a bien été résolu en observant la diminution progressive du pourcentage d’erreurs dans le fichier de log au fil du temps.
Logs des événements et du contexte de la page
Le fichier de log comprend des pourcentages globaux d’éléments non valides, ainsi qu’un échantillon d’éléments non valides uniques organisés par type. Il ne s’agit pas d’un fichier de log complet avec des détails sur chaque événement, chaque ligne et chaque page vue.
Par exemple, le log des événements sur l’image suivante affiche une section pour chaque type d’événement déclenché, le pourcentage d’événements non valides et un échantillon des événements non valides avec leurs erreurs.
Log pour les flux de données
Les logs des flux de données diffèrent selon que le flux est synchronisé ou non. Si le flux est synchronisé avec des avertissements, le log contient la liste des lignes individuelles qui ne sont pas synchronisées et quelques détails. Si le flux n’est pas synchronisé du tout en raison d’une erreur, le log ne contient que les détails de l’erreur.
| Message d’erreur | Description |
|---|---|
| Internal error | La synchronisation du flux a échoué en raison d’une erreur inattendue. Ouvrez un ticket d’assistance. |
| Too many warnings | La synchronisation du flux a échoué car plus de 90 % des lignes du flux n’étaient pas valides. |
| Javascript error | La synchronisation du flux a échoué, car la fonction d’analyseur n’a pas renvoyé un flux valide. |
| Invalid headers | La synchronisation du flux a échoué, car une colonne requise était manquante. |
| Timeout | La synchronisation du flux a échoué, car l’URL n’a pas répondu dans un délai de 5 minutes. |
| Invalid format | La synchronisation du flux a échoué, car le fichier de flux n’était pas un fichier CSV, JSON ou XML valide. |
| URL not found | La synchronisation du flux a échoué, car l’URL n’a pas été trouvée ou une erreur s’est produite lors de la tentative de téléchargement à partir de l’URL. |
| File size exceeded | La synchronisation du flux a échoué, car la taille du fichier a dépassé la limite fixée pour votre compte. Ouvrez un ticket d’assistance pour déterminer si la taille limite de votre flux peut être augmentée. |
Implementation Helper (aide à l’implémentation)
L’outil Implementation Helper est un outil de débogage qui apparaît au-dessus de la page web lorsque vous naviguez sur votre site. Il vous permet de valider :
- Le contexte
- Les événements
- Les audiences
Pour utiliser l’outil Implementation Helper :
- Connectez-vous à la console Dynamic Yield.
- Ouvrez votre site avec votre navigateur (par exemple, Chrome).
- Survolez le bouton Dynamic Yield
et cliquez sur Implementation Helper
.
- Naviguez sur votre site pour voir les mises à jour en direct de la page sur laquelle vous vous trouvez, des événements que vous déclenchez, des audiences auxquelles vous appartenez, et bien plus encore.
L’outil vous permet de visualiser :
- L’implémentation du contexte : le statut du contexte de la page sur la page actuelle
- Les événements : des détails sur tous les événements déclenchés au cours de votre session.
-
Les audiences : les audiences auxquelles vous appartenez dans votre session actuelle.
Bien qu’Implementation Helper soit principalement utilisé lors de l’implémentation, vous pouvez l’ouvrir à tout moment pour vérifier l’application de certains changements tels que de nouveaux événements, ou pour déboguer votre site. - Statut de l’implémentation : un tableau de bord, disponible pour chacun de vos sites, qui vous indique le statut de votre script, le contexte de la page, les événements et le flux de données. Vous y trouverez également des fichiers de log téléchargeables qui vous permettront de déterminer exactement la cause d’une erreur. En savoir plus sur : Tableau de bord du statut d’implémentation.
-
Web Implementation Helper : Cet outil ouvre un panneau directement sur votre site web pendant que vous naviguez, simulant un entonnoir ou un cas d’utilisation. Le panneau présente en temps réel :
- Le contexte de la page actuelle
- Les audiences auxquelles vous appartenez actuellement
- Les événements que vous avez déclenchés
- Les notifications du tableau de bord : lorsque vous dépassez un seuil d’erreurs prédéfini, vous recevez des notifications d’erreurs sur votre tableau de bord. Les seuils sont configurables et peuvent être définis différemment pour chaque site. Si vous estimez que les seuils d’erreurs sont trop ou pas assez sensibles, contactez votre responsable de la réussite client.