Evénements Panier (Sales Insights)

 

Avant-propos

Cette documentation de marquage ne s’applique qu’à partir de la version 5.18.0 du Tracker.

Avant de commencer l’implémentation de Sales Insights, veuillez-vous assurer d’avoir lu l’introduction aux événements.
Si vous ne voyez pas le menu « Sales Insights » dans Explorer, contactez-nous pour que nous activions la fonctionnalité pour vous.

 

Evénements Panier

Le plugin fournit différentes fonctions utiles pour la mesure :

    • des affichages de panier,

      Il est possible d’activer en plus un marquage automatique de contenu de panier SalesTracker en surchargeant la variable de configuration « autoSalesTracker » disponible dans le sous-objet « Ecommerce » :

      var config = {
          Ecommerce: {
              autoSalesTracker: true
          }
      };
      var tag = new ATInternet.Tracker.Tag(config);
    • des mises à jour de panier,
    • des étapes de livraison et de paiement,
    • des paniers en attente de paiement.

Il est possible d’activer en plus un marquage automatique de commande SalesTracker en surchargeant la variable de configuration « autoSalesTracker » disponible dans le sous-objet « Ecommerce » :

var config = {
    Ecommerce: {
        autoSalesTracker: true
    }
};
var tag = new ATInternet.Tracker.Tag(config);

Voir la liste complète des variables de configuration Ecommerce pouvant être surchargées en bas de page.

 

Affichage de panier

Le Tracker dispose de méthodes de déclaration :

  • tag.ecommerce.displayCart.cart.set()
  • tag.ecommerce.displayCart.products.set()

La mesure d’un affichage de panier se fait par la déclaration d’un objet panier et d’un tableau de produits.
Le panier se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du panier (obligatoire).
  • « currency » – String : Devise.
  • « turnovertaxincluded » – Float : Montant total TTC du panier.
  • « turnovertaxfree » – Float : Montant total HT du panier.
  • « quantity » – Number : Nombre total de produits dans le panier.
  • « nbdistinctproduct » – Number : Nombre de produits distincts dans le panier.

Le tableau de produits peut contenir un ou plusieurs produits.

Un produit se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du produit (obligatoire).
  • « $ » – String : Nom du produit.
  • « pricetaxincluded » – Float : Prix TTC.
  • « pricetaxfree » – Float : Prix HT.
  • « quantity » – Number : Nombre de produits dans le panier.
  • « category1 » – String : Catégorie de niveau 1 du produit (jusqu’à 6 niveaux d’arborescence possibles ; de « category1 » à « category6 »).

La déclaration de produits est facultative pour l’analyse Ecommerce. Les produits, s’ils sont déclarés, permettront seulement d’enrichir l’analyse des ventes/commandes SalesTracker. Les paramètres à déclarer se limitent donc aux paramètres nécessaires au marquage SalesTracker.

Exemple

var tag = new ATInternet.Tracker.Tag();
tag.ecommerce.displayCart.cart.set({
    "id": "34",
    "currency": "EUR",
    "turnovertaxincluded": 549,
    "turnovertaxfree": 456.2,
    "quantity": 1,
    "nbdistinctproduct": 1
});
tag.ecommerce.displayCart.products.set([{
    "id": "1",
    "$": "laptop_ACER_A56",
    "pricetaxincluded": 549,
    "pricetaxfree": 456.2,
    "quantity": 1,
    "category1": "Home",
    "category2": "Computers_and_Networking",
    "category3": "Computers",
    "category4": "Laptops",
    "category5": "Acer",
    "category6": "Chromebook"
}]);
tag.dispatch();
 

Mise à jour de panier

Le Tracker dispose d’une méthode de déclaration :

  • tag.ecommerce.updateCart.cart.set()

La mesure de mise à jour de panier se fait par la déclaration d’un objet panier.

Le panier se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du panier (obligatoire).
  • « currency » – String : Devise.
  • « turnovertaxincluded » – Float : Montant total TTC du panier.
  • « turnovertaxfree » – Float : Montant total HT du panier.
  • « quantity » – Number : Nombre total de produits dans le panier.
  • « nbdistinctproduct » – Number : Nombre de produits distincts dans le panier.

Exemple

var tag = new ATInternet.Tracker.Tag();
tag.ecommerce.updateCart.cart.set({
    "id": "34",
    "currency": "EUR",
    "turnoverTaxIncluded": 1098,
    "turnoverTaxFree": 912.4,
    "quantity": 2,
    "nbdistinctproduct": 1
});
tag.dispatch();
 

Affichage de l’étape de livraison

Le Tracker dispose de méthodes de déclaration :

  • tag.ecommerce.deliveryCheckout.cart.set()
  • tag.ecommerce.deliveryCheckout.shipping.set()

La mesure de l’étape de livraison se fait par la déclaration d’un objet panier et d’un objet livraison.

Le panier se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du panier (obligatoire).
  • « currency » – String : Devise.
  • « turnovertaxincluded » – Float : Montant total TTC du panier.
  • « turnovertaxfree » – Float : Montant total HT du panier.
  • « quantity » – Number : Nombre total de produits dans le panier.
  • « nbdistinctproduct » – Number : Nombre de produits distincts dans le panier.

Les données de livraison se déclarent sous la forme d’un objet pouvant contenir différentes propriétés (à renseigner si connues à cette étape) :

  • « delivery » – String : Nom du transporteur.
  • « costtaxincluded » – Float : Montant des frais de livraison TTC.
  • « costtaxfree » – Float : Montant des frais de livraison HT.

Les données de livraison ne doivent être renseignées qu’une seule fois, soit lors de l’étape de livraison, soit lors de l’étape de paiement.

Exemple

var tag = new ATInternet.Tracker.Tag();
tag.ecommerce.deliveryCheckout.cart.set({
    "id": "34",
    "currency": "EUR",
    "turnovertaxincluded": 557.4,
    "turnovertaxfree": 463.2,
    "quantity": 1,
    "nbdistinctproduct": 1
});
tag.ecommerce.deliveryCheckout.shipping.set({
    "delivery": "My carrier",
    "costtaxincluded": 8.4,
    "costtaxfree": 7
});
tag.dispatch();
 

Affichage de l’étape de paiement

Le Tracker dispose de méthodes de déclaration :

  • tag.ecommerce.paymentCheckout.cart.set()
  • tag.ecommerce.paymentCheckout.shipping.set()

La mesure de l’étape de paiement se fait par la déclaration d’un objet panier et d’un objet livraison.

Le panier se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du panier (obligatoire).
  • « currency » – String : Devise.
  • « turnovertaxincluded » – Float : Montant total TTC du panier (frais de livraison inclus).
  • « turnovertaxfree » – Float : Montant total HT du panier (frais de livraison inclus).
  • « quantity » – Number : Nombre total de produits dans le panier.
  • « nbdistinctproduct » – Number : Nombre de produits distincts dans le panier.

Les données de livraison se déclarent sous la forme d’un objet pouvant contenir différentes propriétés :

  • « delivery » – String : Nom du transporteur.
  • « costtaxincluded » – Float : Montant des frais de livraison TTC.
  • « costtaxfree » – Float : Montant des frais de livraison HT.

Les données de livraison ne doivent être renseignées qu’une seule fois, soit lors de l’étape de livraison, soit lors de l’étape de paiement.

Exemple

var tag = new ATInternet.Tracker.Tag();
tag.ecommerce.paymentCheckout.cart.set({
    "id": "34",
    "currency": "EUR",
    "turnovertaxincluded": 557.4, //Shipping fees included
    "turnovertaxfree": 463.2, //Shipping fees included
    "quantity": 1,
    "nbdistinctproduct": 1
});
tag.ecommerce.paymentCheckout.shipping.set({
    "delivery": "My carrier",
    "costtaxincluded": 8.4,
    "costtaxfree": 7
});
tag.dispatch();
 

Panier en attente de paiement

Un panier en attente de paiement doit être validé par une confirmation de transaction côté serveur.

Le Tracker dispose de méthodes de déclaration disponibles depuis la version 5.18.0 :

  • tag.ecommerce.cartAwaitingPayment.cart.set()
  • tag.ecommerce.cartAwaitingPayment.products.set()
  • tag.ecommerce.cartAwaitingPayment.shipping.set()
  • tag.ecommerce.cartAwaitingPayment.payment.set()
  • tag.ecommerce.cartAwaitingPayment.transaction.set()

La mesure d’un panier en attente de paiement se fait par la déclaration d’un objet panier, d’un objet livraison, d’un objet paiement et d’un objet transaction.
Le panier se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du panier (obligatoire).
  • « currency » – String : Devise.
  • « turnovertaxincluded » – Float : Montant total TTC du panier (frais de livraison inclus).
  • « turnovertaxfree » – Float : Montant total HT du panier (frais de livraison inclus).
  • « creation_utc » – Date: Date de creation du panier (timestamp UTC en secondes).
  • « quantity » – Number : Nombre total de produits dans le panier.
  • « nbdistinctproduct » – Number : Nombre de produits distincts dans le panier.

Un produit se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « id » – String : Identifiant du produit (obligatoire).
  • « variant » – String : Variante du produit (taille, couleur, etc.).
  • « $ » – String : Nom du produit.
  • « brand » – String : Marque du produit.
  • « discount » – Boolean : Produit remisé (0 pour non ; 1 pour oui).
  • « pricetaxincluded » – Float : Prix TTC.
  • « pricetaxfree » – Float : Prix HT.
  • « currency » – String : Devise.
  • « stock » – Boolean : Produit en stock (0 pour non ; 1 pour oui).
  • « quantity » – Number : Nombre de produits en attente de paiement.
  • « category1 » – String : Catégorie de niveau 1 du produit (jusqu’à 6 niveaux d’arborescence possibles ; de « category1 » à « category6 »).

Les données de livraison se déclarent sous la forme d’un objet pouvant contenir différentes propriétés :

  • « delivery » – String : Nom du transporteur.
  • « costtaxincluded » – Float : Montant des frais de livraison TTC.
  • « costtaxfree » – Float : Montant des frais de livraison HT.

Le moyen de paiement se déclare sous la forme d’un objet à une propriété :

  • « mode » – String : Moyen de paiement.

La transaction se déclare sous la forme d’un objet pouvant contenir différentes propriétés :

  • « promocode » – Array : Tableau de codes promotionnels pouvant contenir un ou plusieurs codes. Un code promotionnel se déclare sous la forme d’un libellé.
  • « firstpurchase » – String : Première commande du client (0 pour non ; 1 pour oui).

Exemple

var tag = new ATInternet.Tracker.Tag();
tag.ecommerce.cartAwaitingPayment.cart.set({
    "id": "34",
    "currency": "EUR",
    "turnovertaxincluded": 557.4, //Shipping fees included
    "turnovertaxfree": 463.2, //Shipping fees included
    "creation_utc": 1514973161, //UTC timestamp in seconds
    "quantity": 1,
    "nbdistinctproduct": 1
});
tag.ecommerce.cartAwaitingPayment.products.set([{
    "id": "1",
    "variant": "1",
    "$": "laptop_A56",
    "brand": "ACER",
    "discount": 1,
    "pricetaxincluded": 549,
    "pricetaxfree": 456.2,
    "currency": "EUR",
    "stock": 1,
    "quantity": 1,
    "category1": "Computers_and_Networking",
    "category2": "Computers",
    "category3": "Laptops"
}]);
tag.ecommerce.cartAwaitingPayment.shipping.set({
    "delivery": "My carrier",
    "costtaxincluded": 8.4,
    "costtaxfree": 7
});
tag.ecommerce.cartAwaitingPayment.payment.set({"mode": "Credit card"});
tag.ecommerce.cartAwaitingPayment.transaction.set({
    "promocode": ["DQQYRZSJ", "UN1ENE27"],
    "firstpurchase": 1
});
tag.dispatch();
 

Annexes

 

Méthodes de marquage

  • tag.ecommerce.displayCart.cart.set
  • tag.ecommerce.displayCart.products.set
  • tag.ecommerce.updateCart.cart.set
  • tag.ecommerce.deliveryCheckout.cart.set
  • tag.ecommerce.deliveryCheckout.shipping.set
  • tag.ecommerce.paymentCheckout.cart.set
  • tag.ecommerce.paymentCheckout.shipping.set
  • tag.ecommerce.cartAwaitingPayment.cart.set (depuis la version 5.18.0)
  • tag.ecommerce.cartAwaitingPayment.products.set (depuis la version 5.18.0)
  • tag.ecommerce.cartAwaitingPayment.shipping.set (depuis la version 5.18.0)
  • tag.ecommerce.cartAwaitingPayment.payment.set (depuis la version 5.18.0)
  • tag.ecommerce.cartAwaitingPayment.transaction.set (depuis la version 5.18.0)
 

Variables de configuration

Nom Valeur par défaut Description Version
Ecommerce.collectDomain «  » Domaine de collecte Sales Insights  >= 5.13.0
Ecommerce.autoSalesTracker false Activer la mesure automatique de contenu de panier SalesTracker sur un événement d’affichage de panier  >= 5.13.0
 

Cet article vous a-t-il été utile ?

Dernière mise à jour : 13/08/2019