Catégorie : Test AB
Cette intégration est uniquement disponible pour les projets web.
À quoi s'attendre
Cette intégration vous permettra de segmenter les utilisateurs selon l'exposition aux expériences Monetate. Vous pourrez créer de nouveaux zonings basés sur les variations Monetate de votre choix. Contentsquare retrouvera alors automatiquement à la fois les données et la capture précise de la variation sélectionnée.
Ce que nous collectons
Variables dynamiques
Key | Value | Type de données |
AB_Mon_Campaign ID | {campaignID} | Texte |
AB_Mon_Campaign Name | {campaignName} | Texte |
Implémentation
Pour la solution Monetate côté serveur, vous devez utiliser l'API du moteur avec l'option "includeReporting" configurée sur "true". Veuillez vous référer à cette documentation. Une fois activée, elle retournera un objet avec l'information dont nous avons besoin :
Ajoutez et modifiez le code suivant dans le code côté serveur de votre serveur web.
Notez que la seule partie du code ci-dessous que vous devez modifier est la section ENGINE_API_PAYLOAD qui n'est pas un vrai objet. Celle-ci doit être remplacée par la réponse de l'objet que vous avez reçu de l'API de moteur de Monetate mentionné précédemment. Ce code est entièrement en JavaScript et doit être rendu dans la réponse du serveur à votre site à chaque page vue et pour chaque test. Veuillez ne modifiez aucune autre logique de code au-dessus de celle-ci.
/* *Name: Monetate Server Side CS Integration *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, }, ]); } /* Only the following code needs to be tweaked. Note the[ENGINE_API_PAYLOAD] below code is merely a placeholder which should be replaced by the payload response that the Kibo Engine API sends to you based on this documentation: https://docs.kibocommerce.com/115777-the-engine-api/638179-implement-third-party-analytics-with-the-engine-api Note that the payload could contain multiple indexes which is why there is a loop. All you need to do is replace [ENGINE_API_PAYLOAD] with the response object array. */ 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 Monetate côté client, reprenez votre lecture ici.
Rendez-vous dans votre back office Monetate https://marketer.monetate.net/ et assurez-vous que Contentsquare est activé sur les paramètres d'analyse de tiers pour les expériences existantes.
1. Sélectionnez votre projet
2. Rendez-vous dans le menu déroulant ⚙️ "Paramètres" et sélectionnez "Intégration"
3. Ouvrez l'onglet "Analytics de partis tiers" et cliquez sur "CONTENTSQUARE"
4. Ouvrez un nouvel onglet et connectez-vous à Contentsquare, puis rendez-vous dans la Console.
5. Accédez au projet avec lequel vous souhaitez utiliser Monetate.
6. Rendez-vous dans la section "Intégrations" de l'onglet et sélectionnez Monetate
7. Cliquez sur "+ Ajouter un nouveau"
8. Ajoutez le nom de compte de l'API et le token d'accès de l'API à la Console Contentsquare :
- Retournez sur 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 "Token d'accès d'API" et cliquez sur "Envoyer"
9. Donnez un nom à cette intégration, sélectionnez les sites pour lesquels des segments doivent être importés et cliquez sur "Ajouter l'intégration"
Vous devriez alors voir l'intégration active dans le menu de vos intégrations.
Exclusions d'adresses IP
Avant de mettre en place l'intégration, comparez les adresses IP qui sont exclues dans Monetate et celles qui sont exclues dans Contentsquare.
Vous devez aussi ajouter les adresses IP des bureaux de Monetate aux règles d'exclusion de Contentsquare (contactez votre CSM Monetate pour les obtenir) et exclure les adresses IP des bureaux de Contentsquare dans Monetate (votre CSM Contentsquare pourra vous les fournir).
Pour configurer ou vérifiez les règles d'exclusion d'adresses IP Monetate, effectuez les actions suivantes :
1. Rendez-vous dans le menu déroulant ⚙️ "Paramètres" et sélectionnez "Sites"
2. Rendez-vous dans l'onglet "Groupes furtifs"
3. Cliquez sur "+ Créer un groupe furtif"
4. Renseignez une description de l'objectif du groupe et cliquez sur "Enregistrer".
Vérifier que ça fonctionne
Vous pouvez utiliser l'extension Chrome pour vérifier que les résultats sont bien envoyés à Contentsquare.
Si vous avez besoin de trouver un ID de campagne dans votre compte Monetate, qui sont envoyés à Contentsquare sous forme de variable dynamique, vous pouvez le trouver dans l'URL de chaque campagne, comme ici par exemple :