La fonction "connectif.managed.sendEvents" sert à envoyer à Connectif une liste d'événements, ainsi que toutes les autres informations supplémentaires pouvant être présentes sur la page. Grâce à elle, il est possible de notifier via JavaScript tout type d'événements sans avoir besoin d'implémenter les balises.
Cet article fait partie du guide pour créer une intégration sur mesure.
Si votre intégration se fait via un module, cette fonction sera insérée automatiquement dans votre eCommerce.
Comment l'utiliser
La fonction "connectif.managed.sendEvents" envoie automatiquement les données suivantes :
- Les informations du panier d'achat (données de la Balise "État actuel du panier d'achat").
- Les informations du contact actuel (données de la Balise "Informations du contact").
- Les informations sur l'abonnement aux notifications Web Push (plus d'infos sur Fonctionnalités Web Push).
- Les conteneurs disponibles pour le placement de bannières (données de la Balise "Bannière").
Cette fonction peut recevoir, de manière optionnelle, un tableau d'objets de type "événement". Si aucun événement n'est indiqué, les données de la liste précédente seront envoyées à Connectif sans aucun événement spécifique. Cela peut être utile pour resynchroniser le panier d'achat ou l'e-mail, sans avoir besoin de recharger entièrement la page.
Exigences
Il est important d'utiliser cette fonction lorsque Connectif est initialisé.
const isConnectifInitialized = window.connectif?.managed?.isInitialized();
Si ce n'est pas le cas, il sera nécessaire d'attendre l'événement "connectif.managed.initialized".
Voici un exemple de la manière d'envoyer des événements en s'assurant que Connectif est bien initialisé :
function trackPageVisit() {
window.connectif.managed.sendEvents([{ type: 'page-visit' }]);
}
if (window.connectif &&
window.connectif.managed &&
window.connectif.managed.isInitialized()) {
trackPageVisit();
} else {
document.addEventListener("connectif.managed.initialized", function onConnectifInitialized() {
trackPageVisit();
},
{ once: true });
}
Envoyer des informations sur l'objet "options"
La fonction peut également recevoir, de manière optionnelle, un deuxième objet "options", qui peut contenir l'un des champs suivants :
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| options.onResponded | Non | function | Callback qui sera appelé une fois que les événements auront été envoyés à Connectif. |
| options.cart | Non | object |
Indique l'objet de type Panier d'Achat qui sera envoyé à Connectif (au lieu de prendre le panier de la Balise "État actuel du panier d'achat"). |
| options.entityInfo | Non | object |
Indique l'objet contenant les informations du Contact qui seront envoyées à Connectif (au lieu de les récupérer de la Balise "Informations du contact"). |
| options.pageInfo | Non | object |
Indique l'objet contenant les informations de la page qui enrichit l'événement "page visitée" (au lieu de les récupérer des métadonnées de la page et des balises Balise "Catégorie de page" et Balise "Étiquette de page"). |
Après avoir reçu une réponse de Connectif, la fonction déclenchera les actions qui peuvent avoir été déterminées par les flux de Workflows, comme afficher un contenu inline, une popup, etc.
Exemples
Voici comment utiliser cette fonction pour suivre différents événements :
- Notifier l'événement de page visitée.
- Notifier l'événement de produit visité.
- Notifier l'événement d'achat effectué.
- Notifier les informations du panier.
- Notifier les informations du contact.
- Notifier l'événement de recherche.
- Notifier l'événement d'abonnement à la newsletter.
- Notifier l'événement de connexion.
- Notifier l'événement d'inscription.
- Notifier un événement personnalisé.
Félicitations !
Vous êtes arrivé à la fin de la leçon.
Vous avez encore des questions non résolues ?
Rappelez-vous que nos spécialistes Connectif sont à votre disposition. Pour les contacter, il vous suffit d'ouvrir un ticket auprès du Support 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 consulter les articles suivants :
- Ajouter le JavaScript de Connectif sur votre site, pour insérer le code et commencer à collecter des informations sur les visites de votre site.
- Intégration via balises, pour connaître toutes les notifications que vous pouvez envoyer depuis votre eCommerce vers Connectif et leur fonctionnement.
- Intégration avec Connectif via API, pour synchroniser les contacts, les produits, les achats et les coupons.
- Vérifier l'intégration avec l'eCommerce, pour s'assurer que toutes les données sont correctement synchronisées dans votre compte Connectif.