Dans ce guide, vous trouverez toutes les informations nécessaires pour intégrer votre site web à Connectif, depuis les types de synchronisation les plus courants pour savoir lequel convient le mieux à vos besoins techniques et à votre entreprise, jusqu'à apprendre à vérifier que la connexion entre l'eCommerce et Connectif fonctionne correctement.
Comment effectuer une intégration sur mesure entre votre eCommerce et Connectif ?
Le type d'intégration avec Connectif que vous choisirez dépendra de vos besoins et du type de site web, ainsi que des ressources techniques disponibles. Connaître toutes les options et les étapes de mise en œuvre vous permettra d'avoir une vision globale et de choisir celle qui convient le mieux à votre eCommerce.
1. Choix et mise en œuvre de l'intégration adaptée
La manière la plus simple de synchroniser l'eCommerce avec Connectif est d'utiliser l'un des modules existants pour les différentes plateformes, actuellement disponibles pour :
Que faire si votre boutique ne figure pas dans la liste ci-dessus ?
Si votre boutique en ligne n'utilise aucun des CMS mentionnés, vous devrez mettre en œuvre une intégration sur mesure. Vous trouverez ci-dessous quatre manières possibles de le faire, les éléments que vous pouvez intégrer dans chaque cas et les étapes pour compléter la synchronisation.
Type d'événement | Rendu côté serveur | Rendu côté client | Intégration via JavaScript | Intégration via API |
---|---|---|---|---|
Informations de contact | ||||
Activité de contact | ||||
Catalogue de produits | ||||
Achats | ||||
Coupons |
1.1. Intégration via des balises HTML rendues côté serveur
Pourquoi choisir cette méthode ?
L'intégration via des balises HTML rendues côté serveur est probablement la méthode la plus rapide pour envoyer des informations à Connectif de manière personnalisée. Elle consiste à générer et afficher ces balises sur les pages concernées afin que les données qu'elles contiennent soient automatiquement envoyées à Connectif.
Qu’est-ce qui peut être intégré ?
Avec cette méthode, il est possible d'intégrer toutes les balises HTML, ainsi que de synchroniser le catalogue de produits.
À quoi faut-il faire attention ?
Pour que l'intégration via des balises HTML fonctionne correctement, il est nécessaire que des changements de page et d'URL se produisent lorsque le contact navigue sur le site web. Par conséquent, cette méthode d'intégration est recommandée pour les sites qui ne sont pas des Single Page Applications (SPA) et qui permettent le rendu HTML côté serveur.
1.2. Intégration via des balises HTML rendues côté client
Pourquoi choisir cette méthode ?
L'intégration via des balises HTML rendues côté client est la meilleure option si vous utilisez Google Tag Manager et dataLayer, ou si vous souhaitez envoyer des informations à Connectif via des balises HTML sans faire de rendu côté serveur.
Qu’est-ce qui peut être intégré ?
Avec cette méthode, il est possible d'intégrer toutes les balises HTML, mais il n'est pas possible de synchroniser le catalogue de produits. Deux options s'offrent à vous pour intégrer le catalogue :
- Générer la balise HTML "cn_product_visited" côté serveur.
- Désactiver la vérification automatique des produits et les synchroniser via l'API.
À quoi faut-il faire attention ?
Comme pour les balises HTML rendues côté serveur, cette méthode ne fonctionnera pas correctement si aucun changement de page ou d'URL ne se produit lorsque le contact navigue sur le site web. Par conséquent, cette méthode d'intégration convient aux sites qui ne sont pas des Single Page Applications (SPA).
1.3. Intégration via l'envoi d'événements JavaScript
Pourquoi choisir cette méthode ?
L'intégration via des événements JavaScript est la méthode la plus avancée et offre un contrôle accru sur le moment où les événements qui suivent les informations des contacts sont envoyés. Elle est particulièrement recommandée pour les Single Page Applications (SPA) qui doivent contrôler quand un changement de page a lieu pour envoyer l'événement “page-visit”.
Qu’est-ce qui peut être intégré ?
Avec cette méthode, il est possible d'intégrer tous les événements JavaScript, mais il n'est pas possible de synchroniser le catalogue de produits. Deux options sont disponibles pour intégrer le catalogue :
- Générer la balise HTML "cn_product_visited" côté serveur.
- Désactiver la vérification automatique des produits et les synchroniser via l'API.
À quoi faut-il faire attention ?
Vous pouvez également envoyer des notifications personnalisées en utilisant cette méthode, via la création d’une notification personnalisée pour recevoir des données dans Connectif.
1.4. Intégration via l'API de Connectif
Pourquoi choisir cette méthode ?
L'intégration via API est la méthode qui offre un contrôle total sur les données envoyées, permettant par exemple d'envoyer un achat une fois qu'il a été vérifié en backend, ou de synchroniser les modifications des produits au moment où elles sont mises à jour dans la boutique.
C'est le seul moyen d'envoyer l'événement d'achat au moment où il est confirmé, sans attendre que le contact visite à nouveau la page.
Qu’est-ce qui peut être intégré ?
Avec cette méthode, il est possible d'intégrer les Contacts, Produits, Achats et Coupons. Les autres événements devront être envoyés par l'une des autres méthodes proposées :
- Rendre les balises HTML côté serveur.
- Rendre les balises HTML côté client.
- Configurer l'envoi d'événements JavaScript.
À quoi faut-il faire attention ?
Il est important de noter que l'API a une limite de 100 requêtes par minute (rate limit), il est donc recommandé de consulter l'API de Connectif en cas de synchronisation impliquant un envoi massif de données.
2. Réglage des paramètres dans Connectif
Une fois que vous envoyez des informations à Connectif depuis votre boutique en ligne, vous devrez vérifier l'état de la configuration de l'intégration web et des paramètres de commerce électronique :
-
Vérifiez la configuration de l'intégration web dans Connectif.
Ici, vous définissez les domaines autorisés à envoyer des informations à votre compte Connectif et le comportement du script Connectif concernant son initialisation. -
Vérifiez la configuration de l'intégration e-commerce dans Connectif.
Ici, vous configurez la synchronisation et la vérification des produits, selon la méthode choisie pour envoyer ces informations à Connectif. -
Authentifiez le domaine email. Ici, vous validez le domaine ou les domaines à partir desquels les emails des workflows seront envoyés. Sans cette étape, il ne sera pas possible d'envoyer des emails.
3. Vérification de la synchronisation
Une fois l'intégration réalisée et avant de passer en production, il est nécessaire de vérifier que tous les événements sont correctement envoyés. Pour effectuer une vérification de la synchronisation, vous devrez simuler l'interaction d'un contact sur le site et confirmer que toutes les activités sont collectées dans Connectif.
Questions fréquentes
Vous avez des doutes sur certains processus ? Vous trouverez ici des informations utiles :
1. Que faire si votre panier est mis à jour via AJAX ?
Dans ce cas, vous devrez configurer l'événement AJAX du panier pour indiquer les modifications dans le panier sans recharger la page.
2. Comment le cache impacte-t-il votre intégration sur mesure ?
Connectif est un outil de personnalisation et, en tant que tel, il vise à améliorer l'expérience des contacts naviguant sur votre site, en adaptant le contenu qui leur est affiché tout en collectant des informations pour enrichir vos connaissances sur vos clients.
Pour cette raison, il est très important de contrôler quelles parties de la page sont mises en cache afin de maintenir cette personnalisation. Il existe deux types de cache, selon la partie de la page concernée et le moment où elle est actualisée :
- Cache de page
Ce sont les systèmes qui renvoient le même contenu à tous les visiteurs en fonction uniquement de l'URL visitée. Il est déconseillé d'utiliser ce type de cache car il n'est pas compatible avec la personnalisation offerte par Connectif.
- Cache de blocs
Ce sont les systèmes qui permettent de mettre en cache certaines parties de la page, tout en générant d'autres blocs HTML chaque fois que la page est visitée. Ce type de cache est compatible avec Connectif, car les parties statiques peuvent être mises en cache tandis que les parties utilisées par Connectif pour personnaliser et collecter des informations ne le sont pas et peuvent continuer à fonctionner correctement.
3. Comment envoyer des événements personnalisés ?
Pour envoyer des événements personnalisés, vous devrez créer une intégration pour recevoir des données dans Connectif et générer la notification via JavaScript.
4. Quels navigateurs prennent en charge le script de Connectif ?
La compatibilité du script JavaScript de Connectif avec les différents navigateurs dépend de leur part de marché.
Connectif identifie, via browser list, les navigateurs ayant plus de 2 % de part de marché pour assurer leur compatibilité. Ces informations sont obtenues à partir de https://caniuse.com/usage-table.
Pour garantir une large compatibilité tout en optimisant la taille du JavaScript et son chargement dans le navigateur des contacts, Connectif utilise Babel.
Continuez d'apprendre !
Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de consulter les articles suivants :
-
Onboarding, pour acquérir de l'aisance avec notre interface.
-
Workflows initiaux, pour mettre en œuvre vos premières stratégies dans votre compte.
-
Intégrations avec des systèmes externes, pour vous intégrer à Facebook, des formulaires et des webhooks de votre site.
-
Documentation de l'API de Connectif, pour trouver toutes les appels API disponibles.