L' événement “Notifier les informations du panier” sert à décrire le panier d'achat du contact à un moment donné. Il notifie, via JavaScript, les produits et l'état du panier d'un contact en utilisant la fonction connectif.managed.sendEvents.
Cet article fait partie du guide pour créer une intégration sur mesure.
Si votre intégration se fait via un module, cette notification sera insérée automatiquement dans votre e-commerce.
Comment l'utiliser
La notification des informations du panier utilise l'option entityInfo dans la méthode sendEvents pour enrichir les informations envoyées. Cette notification décrit le panier dans son ensemble, et Connectif détecte automatiquement les modifications et génère les événements appropriés lorsqu'un produit est ajouté ou supprimé du panier.
Cette notification via JavaScript est une alternative à l'implémentation de la balise "État actuel du panier d'achat" dans le code HTML de votre boutique ou site web.
Notifier le panier d'achat
Cet objet représente un panier d'achat complet à un moment donné. Il inclut les propriétés suivantes :
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| cartId | Oui | string | Identifiant unique du panier. |
| totalQuantity | Oui | number | Nombre total de produits dans le panier. |
| totalPrice | Oui | number | Prix total du panier. |
| products | Oui | Product Basket Item | Articles contenus dans le panier, avec leur quantité et leur prix total. |
Notifier les produits avec Product Basket Item
Cet objet représente les produits, leur quantité et le prix total dans un panier d'achat ou une commande.
Il inclut toutes les propriétés du type d'objet Produit (plus d'informations sur Notifier l'événement de produit visité), en plus des suivantes :
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| quantity | Oui | number | Quantité d'unités de ce produit. |
| price | Oui | number | Prix total des produits représentés par cet élément du panier de produits. Normalement, il est égal à quantity * unitPrice. |
Autres considérations
Il est très important de définir un identifiant de panier ("cartId") et de notifier Connectif également lorsque le panier est vidé, afin d'éviter la génération d'événements de paniers abandonnés.
Exemple
La notification aura cet aspect :
const cart = {
cartId: '123456789',
totalQuantity: 1,
totalPrice: 10.2,
products: [{
quantity: 1,
price: 10.2,
productDetailUrl: 'https://mywebsite.com/myproduct-detail-url',
productId: '12345678910',
name: 'Mon produit',
description: 'description du produit',
imageUrl: 'https://mywebsite.com/images/myproduct',
unitPrice: 10.2,
availability: 'InStock',
categories: ['/Accueil'],
tags: ['tag1','tag2'],
brand: 'Marque',
reviewCount: 1,
rating: 2,
ratingCount: 2,
thumbnailUrl: 'https://mywebsite.com/images/thumb/myproduct',
priority: 20,
unitPriceOriginal: 10.2,
unitPriceWithoutVAT: 8,
discountedAmount: 0,
discountedPercentage: 0,
publishedAt: '2020-05-20T15:24:20Z',
customField1: '',
customField2: '',
customField3: ''
}]
};
connectif.managed.sendEvents([
// ici mes événements si nécessaire
], { entityInfo, cart });
Félicitations !
Vous êtes arrivé à la fin de la leçon.
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 de support en cliquant sur le bouton bleu "Aide" de votre tableau de bord.
Continuez à apprendre !
Pour tirer pleinement parti 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 découvrir toutes les notifications que vous pouvez envoyer depuis votre e-commerce 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'e-commerce, pour vous assurer que toutes les données sont correctement synchronisées dans votre compte Connectif.