Catégorie : Test AB
À quoi s'attendre
Cette intégration vous permettra de segmenter les utilisateurs en fonction de leur exposition aux expérimentations AB de Monetate. Vous pouvez créer un nouveau zoning basé sur la variation de Monetate de votre choix. Contentsquare récupère automatiquement à la fois les données et la capture précise de la variation sélectionnée.
Ce que nous collectons
Variables Dynamiques
Clé | Valeur | Type de Données |
AB_Mon_ID_Campagne | {campaignID} | Texte |
AB_Mon_Nom_Campagne | {campaignName} | Texte |
Mise en œuvre
Pour la solution côté serveur de Monetate, vous devez utiliser l'API Engine avec le drapeau "includeReporting" défini sur true. Veuillez consulter cette documentation pour référence. Une fois activé, cela renverra un objet avec les informations dont nous avons besoin :
Ajoutez et modifiez le code suivant dans le code côté serveur de votre serveur web.
Notez que dans le code ci-dessous, la seule partie que vous devez modifier est celle où vous voyez la section ENGINE_API_PAYLOAD qui n'est pas un objet réel. Cela doit être remplacé par la réponse d'objet réelle renvoyée par l'API Engine de Monetate. Ce code est entièrement en javascript et doit être rendu dans la réponse du serveur vers votre site à chaque page vue et pour chaque test. Veuillez ne pas modifier toute autre logique de code au-dessus de cela.
/* *Nom: Intégration CS côté serveur Monetate *Version: 1.0.0 */ function callback() { var version = "1.0.0"; if (!disableCallback) { disableCallback = true; if (window.CS_CONF) { CS_CONF.integrations = CS_CONF.integrations || []; CS_CONF.integrations.push("Monetate Server Side - v" + version); } } } var disableCallback = false; window._uxa = window._uxa || []; _uxa.push(["afterPageView", callback]); var tvp = "AB_Mon_SS_"; function sendToCS(csKey, csValue) { csKey = tvp + csKey; _uxa.push([ "trackDynamicVariable", { key: csKey, value: csValue, }, ]); } /* Seul le code suivant doit être modifié. Notez que le code [ENGINE_API_PAYLOAD] ci-dessous est simplement un espace réservé qui doit être remplacé par la réponse de charge utile que l'API Kibo Engine vous envoie en fonction de cette documentation : https://docs.kibocommerce.com/115777-the-engine-api/638179-implement-third-party-analytics-with-the-engine-api Notez que la charge utile pourrait contenir plusieurs index, c'est pourquoi il y a une boucle. Tout ce que vous avez à faire est de remplacer [ENGINE_API_PAYLOAD] par le tableau d'objet de réponse. */ for (let i = 0; i < [ENGINE_API_PAYLOAD].impressionReporting.length; i++) { var campaignName = [ENGINE_API_PAYLOAD].impressionReporting[i].experience_label; var experienceName = [ENGINE_API_PAYLOAD].impressionReporting[i].impressionReporting.variant_label; sendToCS(campaignName, experienceName); }
Pour la solution côté client Monetate résumez ci-dessous.
Accéder à votre back office Monetate https://marketer.monetate.net/ et assurez-vous que Contentsquare est activé dans les paramètres d'analytics tiers des expériences existantes
1. Sélectionnez votre projet
2. Accédez au menu déroulant ⚙️ 'Paramètres' et sélectionnez 'Intégration'
3. Accédez à l'onglet 'Analytics tiers' et Cliquez sur 'CONTENTSQUARE'
4. Accédez au catalogue des intégrations.
5. Recherchez et sélectionnez Monetate
7. Cliquez sur '+ Ajouter Nouveau'
8. Ajoutez le nom du compte API et le jeton d'accès API dans la console Contentsquare :
- Retournez à Monetate et cliquez sur 'Copier' à côté du 'nom du compte API'
- Insérez votre nom de compte API fourni par Monetate ci-dessus dans Contentsquare
- Répétez ces mêmes étapes pour le 'jeton d'accès API' puis cliquez sur 'Envoyer'
9. Donnez un nom à cette intégration, sélectionnez les sites pour lesquels les segments doivent être importés et cliquez sur 'Ajouter l'intégration'
Vous devriez alors voir l'intégration active dans votre menu d'intégrations
Exclusions d'IP
Avant de mettre l'intégration en ligne, vous devriez faire une comparaison entre les IP exclues dans Monetate et les IP exclues dans Contentsquare.
Vous devriez également ajouter les IP de bureau de Monetate aux règles d'exclusion de Contentsquare (veuillez parler à votre CSM Monetate pour les obtenir) et vous devriez exclure les IP de bureau de Contentsquare dans Monetate (votre CSM Contentsquare peut fournir ces informations).
Pour configurer ou vérifier les règles d'exclusion d'IP de Monetate, procédez comme suit :
1. Accédez au menu déroulant ⚙️ 'Paramètres' et sélectionnez 'Sites'
2. Accédez à l'onglet 'Groupes Stealth'
3. Cliquez sur '+ Créer un Groupe Stealth'
4. Saisissez une description de l'objectif du groupe et cliquez sur 'Enregistrer'.
Vérifier que cela fonctionne
Vous pouvez utiliser l'extension chrome pour vérifier que les résultats sont envoyés à CS
Au cas où vous auriez besoin de trouver l'ID de la campagne dans votre compte Monetate, qui est envoyé à Contentsquare en tant que variable dynamique, vous pouvez le trouver dans l'URL de chaque campagne comme ceci par exemple :