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 l'événement d'achat effectué

Création
Mise à jour
S’abonner

L’ événement “Notifier l’événement d’achat réalisé” est utilisé pour décrire un achat effectué par le client. Pour cela, il notifie, via JavaScript, lorsqu’un utilisateur réalise un achat à l’aide de connectif.managed.sendEvents.

  

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

 

Comment l’utiliser

La notification d’informations du panier utilise l’option entityInfo de la méthode sendEvents pour enrichir les informations envoyées dans les événements.

  

Cet événement constitue une alternative à l’implémentation de la balise "Achat réalisé" dans le HTML de votre boutique ou site web.

 

Notifier l’achat réalisé

Cet objet représente le modèle de Panier d’achat qui inclut les propriétés suivantes :

Nom Obligatoire Type Description
purchaseId Oui string Identifiant unique de l’achat.
cartId Non string Identifiant unique du panier à l’origine de cet achat.
totalQuantity Oui number Quantité totale de produits dans l’achat (y compris les doublons).
Par exemple : si un panier contient 3 unités d’un produit et 7 d’un autre, totalQuantity sera égal à 10.
totalPrice Oui number Montant total de l’achat.
purchaseDate Non string Date de l’achat. Le format attendu est ISO_8601.
paymentMethod Non string Méthode de paiement.
products Oui Product Basket Item Articles inclus dans l’achat, avec leur quantité et leur prix.
source_name Non string Le nom de la source, pour fournir un contexte ou des détails sur le type de source de l’achat.
source_type Non string

Le nom de la source où l’achat a été réalisé. Les valeurs possibles sont : "marketplace", "digital-store", "point-of-sale", "third-party" et "other".
 

Bien qu’il soit optionnel, le champ cartId est fortement recommandé pour pouvoir marquer le panier comme acheté et éviter des événements incorrects de Panier abandonné.

 

Organisation des valeurs de la source (source_type)

Ci‑dessous sont expliquées chacune des valeurs possibles de la source d’achat (source_type) :

Valeur Description Exemple
third-party Ventes redirigées via des distributeurs, détaillants ou réseaux de partenaires (pas les marketplaces).

Vente en gros, Distributeurs, Affiliés...
other Cas particuliers ou canaux spéciaux qui ne rentrent pas dans les catégories ci‑dessus.

Télé‑ventes, Salons & événements, Commerce social...
marketplace Plateformes de commerce électronique tierces où vous listez vos produits.

Amazon Marketplace, eBay, Zalando...
digital-store Ventes depuis le site Web ou l’application eCommerce du détaillant.

Direct, Recherche organique, Recherche payante, Email Marketing...
point-of-sale Ventes en magasin physiques traitées via un système de point de vente (POS).

Caisse en magasin, Kiosque en magasin, Boutiques pop‑up...

 

Exemple

La notification ressemblera à ceci :

connectif.managed.sendEvents([
    {
        "type": "purchase",
        "purchase": {
            "cartId": "cart-0098caf9-42f4-44e9-afdd-45eafe892293",
            "totalQuantity": 1,
            "totalPrice": 51.88,
            "products": [{
                "name": "My Product",
                "productDetailUrl": "https://myshop.com/product/details/59a31949a1a562d4979fbca2",
                "productId": "59a31949a1a562d4979fbca2",
                "unitPrice": 51.88,
                "availability": "outofstock",
                "imageUrl": "https://myshop.com/img/59a31949a1a562d4979fbca2.jpg",
                "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
                "priority": 10,
                "rating": 4,
                "tags": ["tag1", "tag2", "tag3"],
                "relatedExternalProductIds": ["59a31953a1a562d4979fbd90", "59a31b2ba1a562d4979fe5b8"],
                "brand": "Jata",
                "publishedAt": "2020-05-03T10:15:00Z",
                "quantity": 1,
                "price": 51.88
            }],
            "purchaseId": "purchase-e3418b5a-8709-4593-a7c8-d8a7f12df737",
            "purchaseDate": "2020-06-26T12:52:51.591Z",
            "paymentMethod": "Credit Card"
            "source_type": "digital-store"
            "source_name": "My online store"
        }
    },
    {
        "type": "page-visit"
    }], { entityInfo });
  

Normalement, l’enregistrement de l’achat sera notifié avec l'événement de visite de page. Il s’agit généralement de la visite de la page de confirmation de la commande ou de l'achat.

 

 

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

  

Des doutes restent sans réponse ?
Rappelez-vous que nos spécialistes Connectif sont à votre disposition. Pour les contacter, il vous suffit d’ouvrir un ticket au 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 continuer avec les articles suivants :