Catégorie : Test AB d'optimisation de recherche
Cette intégration n'est disponible que pour les projets web.
À quoi s'attendre
Cette intégration vous permettra de convertir les variantes de résultats d'Algolia en variables dynamiques dans Contentsquare, et vous donnera ainsi la possibilité de segmenter et d'analyser les utilisateurs selon leur expérience de recherche. Cette intégration est restreinte à un seul index de recherche par projet et requiert une implémentation de la version 4+ de l'ensemble de la bibliothèque d'Algolia.
Ce que nous collectons
Variables dynamiques
| Key | Value | Type de données |
| AB_AG_{Experiment ID} | {Variant Index Number} | Texte |
AB_AG_{Experiment ID}
La key de la variable dynamique est l'ID d'expérience associé avec le test et sa value est la position de l'index du variant (1 représentant le premier variant, 2 le second, etc.). Retrouvez ces values dans les paramètres de test AB d'Algolia.
Implémentation
Étapes d'implémentation
Étape 1
Cette intégration nécessite d'implémenter l'ensemble de la version 4 (ou +) de la bibliothèque JavaScript d'Algolia. La version lite et les versions plus anciennes ne contiennent pas les fonctionnalités d'analyses requises. Pour plus d'informations, cliquez ici.
Afin d'activer cette intégration, vous devrez fournir 4 paramètres à Contentsquare :
- Une key API Algolia avec permissions de recherche et d'analyse.
- L'ID d'application d'Algolia.
- La région d'analyse d'Algolia.
- L'index de recherche que vous souhaitez analyser.
Voici un guide rapide sur la manière de trouver ces paramètres :
Générer une key API pour l'analyse
Sur la page des paramètres d'Algolia, cliquez sur la section "Keys API" :
Cliquez sur l'onglet "Toutes les keys API", puis sur le bouton "Nouvelle key API".
Créez une key avec un index de recherche approprié et, sous "ACL", sélectionnez UNIQUEMENT les permissions "Recherche" et "Analyse" :
De retour sur l'onglet de "Toutes les keys API", vous trouverez celle que vous avez générée. C'est cette key que vous devez fournir à Contentsquare :
Important : Ne nous fournissez pas une key API avec des droits administratifs. La key requise doit être exposé dans un code côté client, et ne devrait contenir que les permissions requises minimales nécessaires au fonctionnement de l'intégration afin d'éviter tout usage mal intentionné.
ID d'application Algolia
L'ID d'application se trouve dans les paramètres des keys API Algolia :
Région d'analyse
Cliquez sur le paramètre "Infrastructure" dans la catégorie "Paramètres d'organisation" des paramètres d'Algolia :
Vous trouverez la région sous l'onglet "Analytics" :
Faîtes nous parvenir le code de 2 caractères de la région (Allemagne = "de", France = "fr", ...).
Index de recherche
Veuillez également nous fournir l'index de recherche que vous utilisez et que vous souhaitez analyser (celui-ci devrait correspondre à l'ID d'application que vous utilisez et à l'index de recherche fourni dans la key API que vous avez générée).
Une fois les 4 paramètres requis collectés, passez à l'étape 2.
Étape 2
Envoyez un e-mail à notre équipe Support avec les informations que vous avez collectées dans l'étape précédente et demandez l'activation de l'intégration Algolia.
Vérifier que ça fonctionne
Vous pouvez utiliser l'extension Chrome pour vous assurer que les résultats sont bien envoyés à Contentsquare.