Analytics Platform Integration (intégration de plateforme analytique) est une extension d’Experience OS qui vous permet de suivre et d’analyser les performances de vos expériences personnalisées.
Le connecteur Analytics Platform Integration vous permet d’intégrer votre site à la plateforme d’analyse de votre choix afin de créer des rapports pour vos campagnes Dynamic Yield. Consultez les données relatives aux sessions et au comportement des utilisateurs concernant les expériences ou les variations, ou marquez les utilisateurs qui ont été exposés à une expérience spécifique.
Remarque : consultez également notre extension Google Analytics 4 integration, prête à l’emploi et sans code.
Mise en place d’une intégration de plateforme analytique personnalisée
- Rendez-vous dans Experience OS App Store › Analytics Platform Integration, puis cliquez sur Install.
- Cliquez sur Configure extension.
-
Sélectionnez les déclencheurs qui détermineront l’exécution du code de l’intégration personnalisée.
- Variation Impressions (standard) : analyse le comportement des utilisateurs qui ont reçu une variation.
- Recommendation Impressions : analyse le comportement des utilisateurs qui ont bénéficié d’une stratégie spécifique.
- Variations Rendered on a Page (variations rendues sur une page) : analyse le comportement des utilisateurs qui ont cliqué sur le contenu dynamique ou les campagnes de recommandation.
-
Rédiger un JavaScript personnalisé conforme à l’API de la plateforme concernée.
-
Le code JavaScript peut inclure des métadonnées telles que le nom de la variation, le nom de l’expérience ou de la campagne, la stratégie (pour les recommandations), etc.
-
Lors de la sélection des crochets, consultez la documentation incluse pour obtenir les conseils suivants :
- Comment fonctionne le code ?
- Exemple d’objet
- Description des attributs
- Exemple de code :
- Consentement présumé aux cookies uniquement : si vous utilisez l’une de nos API de gestion de la confidentialité des données des visiteurs, vous devez utiliser une API dédiée pour vous assurer qu’aucune donnée n’est envoyée à un tiers pour les utilisateurs qui n’ont pas donné leur consentement.
-
La nouvelle syntaxe incluse dans JavaScript ES6 n’est pas prise en charge.
-
- Par défaut, l’intégration de la plateforme d’analyse est servie lorsqu’une campagne est déclenchée conformément à cette configuration. Vous pouvez activer ou désactiver manuellement l’intégration pour des campagnes individuelles à l’aide de la procédure décrite dans Activation et désactivation d’une intégration personnalisée par campagne.
Gestion du connecteur d’intégration de la plateforme d’analyse
Dans l’application Web Personalization, cliquez sur l’onglet Extensions. Vous pouvez sélectionner l’une des trois options suivantes :
- Activate (activer)
- Deactivate (désactiver)
- Uninstall (désinstaller)
Activation et désactivation d’une intégration personnalisée par campagne.
Par défaut, l’intégration de la plateforme d’analyse personnalisée est activée pour toutes les campagnes. L’intégration peut être désactivée pour chaque campagne. Cette opération s’effectue dans les paramètres avancés de la campagne.
- Lorsque vous modifiez ou créez une campagne, accédez aux Advanced Settings (paramètres avancés).
- Désactivez (ou activez) l’option Track campaign performance in your analytics platform (suivre les performances de la campagne sur votre plateforme d’analyse) :
Dépannage des intégrations analytiques personnalisées
Si vous avez configuré votre intégration analytique personnalisée, mais que vous ne voyez pas les données des campagnes Dynamic Yield sur votre plateforme d’analyse, essayez ces méthodes pour débugger le code d’intégration et confirmer qu’il fonctionne comme prévu.
Si, après avoir essayé ces actions, les événements ne sont toujours pas déclenchés pour les campagnes Dynamic Yield, contactez l’assistance technique.
Console.log
L’utilisation de console.log() est une méthode classique de débogage du code. Elle écrit des chaînes de texte dans la console des outils de développement de votre navigateur (appuyez sur ⌘+⌥+J pour MacOS et Ctrl+Shift+J pour Windows). Dans l’exemple suivant, console.log() est utilisé pour vérifier que notre code s’exécute correctement et que des valeurs sont affectées à nos variables.
Pour aller plus loin, vous pouvez utiliser console.log() pour vérifier que les données de la campagne Dynamic Yield sont affectées aux variables passées dans la fonction afterVariationSelected.
Points d’arrêt
Les points d’arrêt (breakpoints) peuvent être utilisés pour arrêter l’exécution du code dans le navigateur, ce qui vous permet de parcourir le code ligne par ligne afin de l’examiner en détail.
Pour ajouter des points d’arrêt au code contenu dans votre intégration analytique personnalisée :
- Ouvrez les outils de développement de votre navigateur (appuyez sur ⌘+⌥+J pour MacOS et Ctrl+Shift+J pour Windows).
- Cliquez sur les trois points de la barre de menu, puis sur Open File (ouvrir un fichier).
- Recherchez « api_dynamic » et ouvrez le fichier JS en cliquant dessus.
- Cliquez sur Pretty-Print.
- Recherchez le nom de la fonction dans votre code d’intégration analytique personnalisé. Dans cet exemple, nous avons recherché « afterVariationSelected ». Cependant, cela peut être différent selon le type d’intégration personnalisée que vous utilisez. Reportez-vous à votre intégration dans Dynamic Yield si vous n’êtes pas sûr de ce que vous devez utiliser dans votre recherche.
- Cliquez sur les numéros de ligne pour ajouter des points d’arrêt à l’endroit où vous souhaitez que l’exécution du code s’interrompe. Dans cet exemple, nous avons ajouté un point d’arrêt pour stopper le code avant qu’il n’exécute l’événement gtag.
- Actualisez la page que vous dépannez. Sur la console des outils de développement, vous pouvez voir que la page cesse de se charger et que votre point d’arrêt est affiché.
Vous pouvez maintenant voir quelles valeurs sont assignées aux variables minifiées qui sont passées dans la fonction afterVariationSelected. Si vous relancez l’exécution du code, vous constaterez peut-être qu’il passe par le même point d’arrêt et s’y arrête plusieurs fois si vous lancez le code d’intégration des analyses personnalisées pour plusieurs campagnes sur la page.
Notez que vous ne verrez pas le code itérer dans les campagnes pour lesquelles l’intégration analytique personnalisée n’est pas activée dans les paramètres de la campagne. - Faites des tests en ajoutant des points d’arrêt supplémentaires dans le code, ou utilisez l’étape
pour parcourir le code une fois le point d’arrêt atteint.
Utiliser le bon code de mesure d’événement pour Google Analytics
Si vous ne voyez toujours pas les événements de la campagne Dynamic Yield dans Google Analytics, c’est peut-être parce que vous n’utilisez pas la bonne syntaxe dans votre code de mesure d’événement. Selon votre implémentation, vous devez utiliser la syntaxe ga() ou gtag().
Pour vérifier la syntaxe correcte du code pour votre site, consultez l’article Google Analytics 4 .