1. Centre d'aide
  2. Intégrez votre Commerce
  3. Intégration personnalisée
  4. À travers des événements JavaScript
  5. Notifie l'envoi des événements JavaScript

Notifier les informations du panier

Création
Mise à jour
S’abonner

L’ événement « Notifier les informations du panier » sert à décrire le panier que le contact possède à un moment donné. Pour cela, il notifie via JavaScript les produits et l’état du panier d’un contact en utilisant connectif.managed.sendEvents.

  

Cet article fait partie du guide pour créer une intégration personnalisée.
Si votre intégration se fait via module, cette notification sera insérée automatiquement dans votre eCommerce.

 

Comment l’utiliser

La notification des informations du panier utilise l’option entityInfo de la méthode sendEvents pour enrichir les informations des événements envoyés. Cette notification décrit le panier complet ; Connectif se charge de détecter les changements et de générer les événements appropriés lorsqu’un produit est ajouté ou retiré du panier.

  

Cette notification via JavaScript constitue une alternative à l’implémentation de la Balise « État actuel du panier d’achats » dans le HTML de votre boutique ou page web.

Notifier le panier d’achats

Cet objet représente un panier complet à un moment donné. Il comprend les propriétés suivantes :

Nombre Obligatoire Tipo Descripción
cartId Oui string Identifiant unique du panier.
totalQuantity Oui number Quantité totale de produits dans le panier.
CartRecoveryUrl Non Cart recovery url URL associée au panier via laquelle on peut accéder pour récupérer/acheter tous les produits liés.
totalPrice Oui number Prix total du panier.
products Oui Product Basket Item Articles contenus dans le panier, avec leurs quantités et montants.

Notifier les produits via Product Basket Item

Cet objet représente les produits, leurs quantités et leur prix total dans un panier ou achat.

Il inclut toutes les propriétés du type objet Produit (plus d’infos dans Notify product visited event), plus les suivantes :

Nombre Obligatoria Tipo Descripción
quantity Oui number Quantité d’unités de ce produit.
price Oui number Prix accumulé des produits représentés par ce Product Basket Item. Habituellement 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 panier abandonné.

 

Exemple

La notification aura cette apparence :

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: 'My product',
        description: 'product description',
        imageUrl: 'https://mywebsite.com/images/myproduct',
        unitPrice: 10.2,
        availability: 'InStock',
        categories: ['/Home'],
        tags: ['tag1','tag2'],
        brand: 'Brand',
        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: '',
        customField2: ''
    }]
};
connectif.managed.sendEvents([
  // here my events if any
], { entityInfo, cart });

 

 

Félicitations !
Vous êtes arrivé à la fin de la leçon.

  

Doutes non résolus ?
Souvenez‑vous que nos spécialistes Connectif sont à votre disposition. Pour les contacter, il suffit d’ouvrir un ticket auprès du 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 poursuivre avec les articles suivants :