L'intégration via API est l'option d'intégration personnalisée avec Connectif qui permet un contrôle total sur les données envoyées, mais elle ne permet de synchroniser que les Contacts, Produits, Achats et Coupons. Les autres événements devront être intégrés par l'une des autres options, des balises HTML ou des événements JavaScript.
Pour effectuer ce type d'intégration, vous aurez besoin d'un expert avec des connaissances en programmation pour pouvoir récupérer les données de votre eCommerce et effectuer des appels HTTP à une API REST.
Avant de commencer : avantages et limitations d'une intégration via API
Concernant les avantages :
- Elle ne dépend pas du client, car il s'agit d'un appel HTTP où vous pouvez contrôler la réponse reçue pour vous assurer que l'événement est bien arrivé et traité correctement.
- Il est possible d'effectuer des importations massives, alors que les autres options mettent toujours à jour un par un.
Les limitations possibles d'une intégration via API sont les suivantes :
- Nécessite un département informatique capable d'effectuer les appels nécessaires à l'API de Connectif.
- Il existe un nombre maximal d'appels API autorisé par minute. Pour les opérations massives, il est recommandé d'utiliser l'API d'importation, où un seul appel peut synchroniser plusieurs éléments.
- Il n'est pas possible d'intégrer tous les événements via l'API, il est donc nécessaire de combiner cette option avec d'autres méthodes d'intégration.
Apprenez comment fonctionne l'API de Connectif dans cet article.
Comment intégrer Connectif via API ?
1. Ajouter le JavaScript de Connectif
Configurez le JavaScript de Connectif sur le site pour qu'il se charge sur toutes les pages et permettre l'intégration via des événements.
2. Synchroniser via API
Configurez la synchronisation des informations sur :
- Contacts: pour enregistrer les données des visiteurs de l'eCommerce.
- Produits: pour synchroniser le catalogue.
- Achats: pour décrire les achats réalisés par les clients.
-
Coupons: pour synchroniser les codes de coupon et leurs usages.
3. Synchroniser les autres événements par une autre méthode
3.1. Balises HTML rendues côté serveur ou client :
- Balise "État actuel du panier d'achat": pour décrire le panier d'achat du contact à un moment donné.
- Balise "Étiquette de page": pour attribuer une étiquette à une page.
La synchronisation du catalogue de produits sera réalisée via API, il sera donc nécessaire de désactiver la synchronisation et la vérification automatiques. Pour envoyer l'événement "Contact a visité un produit", il n'est pas nécessaire que le HTML soit rendu côté serveur.
- Balise "Contact a recherché un produit": pour identifier une visite d'un produit comme résultat direct d'une recherche de celui-ci.
- Balise "Contact s'est connecté": pour indiquer que le contact s'est authentifié.
- Balise "Contact s'est inscrit": pour indiquer une nouvelle inscription.
-
Balise "Abonnement à la newsletter": pour indiquer qu'un contact s'est abonné à la newsletter.
3.2. Événements envoyés via JavaScript :
- Notification de page visitée: pour indiquer que le contact a visité une page lors de sa navigation sur le site.
- Notification de produit visité: pour indiquer que le contact a visité un produit spécifique lors de sa navigation sur le site.
- Notification d'informations sur le panier: pour décrire le panier d'achat que le contact a à un moment donné..
- Notification de recherche effectuée: pour indiquer qu'une recherche a été effectuée et identifier les termes utilisés.
- Notification de connexion: pour indiquer que le contact s'est authentifié.
- Notification d'inscription: pour indiquer une nouvelle inscription.
-
Notification d'abonnement à la newsletter: pour indiquer qu'un contact s'est abonné à la newsletter.
5. Configurer les Web Push
Pour compléter l'intégration, vous devez également configurer le Service Worker afin de recevoir les abonnements aux Web Push et d'envoyer des notifications à vos contacts.
- Commencez à gérer les notifications Web Push.
6. Valider l'intégration
Une fois l'envoi d'informations vers Connectif implémenté, l'étape suivante consiste à valider que l'intégration a été correctement effectuée.
Félicitations !
Vous êtes arrivé à la fin de la leçon.
Avez-vous des questions en suspens ?
Rappelez-vous que vous avez à votre disposition nos spécialistes Connectif. Pour les contacter, il vous suffit d'ouvrir un ticket d'assistance en cliquant sur le bouton bleu "Aide" de votre tableau de bord.
Continuez à apprendre !
Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :
-
Onboarding, pour maîtriser notre interface.
-
Workflows initiaux, pour mettre en place vos premières stratégies sur le compte.
-
Intégrations avec des systèmes externes, pour vous connecter avec Facebook, les formulaires et les webhooks de votre site.
-
Événements qui consomment des Activités, pour mieux comprendre la consommation de votre compte.