Panier / Contenu de commande

 

Avant-propos

Avant de commencer l’’implémentation du plugin SalesTracker, veuillez-vous assurer d’’avoir initialisé le Tracker JavaScript AT Internet et sélectionné le plugin depuis l’interface Tag Composer

 

Méthodes de marquage

Le plugin JavaScript SalesTracker propose la mesure des consultations de panier et des contenus de commande.

Le Tracker dispose pour cela de deux méthodes « cart.set() » et « cart.add() ».

Les propriétés précédées de * nécessitent l’option SalesTracker pour être prises en compte.

La méthode « cart.set() » prend un objet en paramètre dont les propriétés sont les suivantes :

  • * cartId : Numéro de panier.
  • * isBasketPage : Indicateur de page de type panier (true/false).

La méthode « cart.add() » prend un objet « product » en paramètre dont les propriétés sont les suivantes :

  • * category1 à category6 : Catégories du produit (6 niveaux maximum) au format ‘ID[category_label]’.
  • * productId : Identifiant produit au format ‘ID[product_label]’.
  • * quantity : Quantité de produit.
  • * unitPriceTaxIncluded : Prix unitaire TTC.
  • * unitPriceTaxFree : Prix unitaire HT.
  • * discountTaxIncluded : Remise TTC.
  • * discountTaxFree : Remise HT.
  • * promotionalCode : Code promo.

Voir Annexe pour plus de détails concernant le format des catégories et des identifiants produit.

Vous devez associer votre marqueur SalesTracker avec un marqueur de Page « tag.page.set() » pour qu’il soit traité, voir Mesure de pages pour plus d’informations.

 

Marquer une consultation de panier

Le marquage d’une consultation de panier passe par l’utilisation de la méthode « cart.set() » avec la propriété « isBasketPage » à true ainsi que par l’utilisation de la méthode « cart.add() » pour la déclaration des produits présents dans le panier.

Voici un modèle de code de consultation de panier :

var tag = new ATInternet.Tracker.Tag();
// set page
tag.page.set({
    name:'pageName'
});
// set cart
tag.cart.set({cartId: 8235, isBasketPage: true});
tag.cart.add({
    product: {
        category1: '1[Computers_and_Networking]',
        category2: '25[Computers]',
        category3: '56[Laptops]',
        productId: '564[laptop_ACER_A56]',
        quantity: 1,
        unitPriceTaxIncluded: 549,
        unitPriceTaxFree: 456.2,
        discountTaxIncluded: 10,
        discountTaxFree: 8.04,
        promotionalCode: 'Offer_New_Customer'
    }
});
tag.cart.add({
    product: {
        category1: '1[Computers_and_Networking]',
        category2: '25[Computers]',
        category3: '56[Laptops]',
        productId: '42[laptop_ASUS_N550JK]',
        quantity: 1,
        unitPriceTaxIncluded: 999,
        unitPriceTaxFree: 840,
        discountTaxIncluded: 10,
        discountTaxFree: 8.04,
        promotionalCode: 'Offre_New_Customer'
    }
});
tag.dispatch();

Explications

Le panier consulté se compose d’e deux produits :

1 ordinateur portable ACER A56 d’un montant de 549€€ TTC (soit 456,22€ HT), une remise est appliquée sur ce produit d’un montant de 10€€ (soit 8,04€ HT).

1 ordinateur portable ASUS N550JK d’un montant de 999€€ TTC (soit 840€ HT), une remise est appliquée sur ce produit d’un montant de 10€€ (soit 8,04€ HT).

Sont obligatoires tous les produits du panier avec leurs catégories. L’identifiant du panier doit être renseigné « cartId » ; il doit être identique à celui présent dans le marqueur de contenu de la commande ; dans le cas contraire le panier sera considéré comme abandonné.

 

Marquer un contenu de commande

Le marqueur posé sur votre site doit faire remonter sur nos serveurs l’’ensemble des informations liées au contenu de la commande/réservation, pour connaître les produits, leur quantité et le montant ([Qté x prix unitaire]- remise).

Ces marqueurs sont pris en compte uniquement sur des pages à objectif principal.

Voici un modèle de code de récupération des informations du contenu d’une commande :

var tag = new ATInternet.Tracker.Tag();
// set page
tag.page.set({
    name:'pageName'
});
// set order
tag.order.set({...});
// set order content
tag.cart.set({cartId: 8235});
tag.cart.add({
    product: {
        category1: '1[Computers_and_Networking]',
        category2: '25[Computers]',
        category3: '56[Laptops]',
        productId: '564[laptop_ACER_A56]',
        quantity: 1,
        unitPriceTaxIncluded: 549,
        unitPriceTaxFree: 456.2,
        discountTaxIncluded: 10,
        discountTaxFree: 8.04,
        promotionalCode: 'Offer_New_Customer'
    }
});
tag.dispatch();

Explications

La commande se compose d’’un produit :

1 ordinateur portable ACER A56 d’’un montant de 549€ TTC (soit 456,22 HT), une remise est appliquée sur ce produit d’un montant de 10€€ (soit 8,04€ HT).

Cette commande vous permet d’’ajouter les catégories suivantes :

  • Computers and Networking
  • Computers
  • Laptops

Pour déterminer le chiffre d’’affaires par catégorie, il est nécessaire de renseigner la catégorie dans le contenu de la commande.

 

Les remises de produits

Des remises peuvent s’’appliquer au produit en plus de la commande (voir la rubrique Commande pour plus d’informations concernant les remises globales).

De ce fait :

  • Si les 2 remises sont renseignées (commande + produit), la remise de commande doit être supérieure ou égale à la remise de produit. Dans ce cas, la remise de produit est incluse dans la remise commande.
  • Si la remise de commande n’est pas renseignée, un cumul des remises de produit est affecté au niveau de la commande.

Le montant de remise à renseigner doit être la somme sur toute la quantité de produits achetés. En prenant l’exemple d’un produit dont le prix unitaire est « 100€ » et la quantité est « 2 », nous distinguons plusieurs cas de figure :

– La remise produit est globale pour l’’ensemble des quantités de ce produit dans le cas d’’une remise du type « 2 produits achetés, 15€ offerts ».

var tag = new ATInternet.Tracker.Tag();
// set page
tag.page.set({
    name:'pageName'
});
// set order 
tag.order.set({...});
// set order content
tag.cart.set({cartId: 8235});
tag.cart.add({
    product: {
        category1: '1[Computers_and_Networking]',
        productId: '250[laptop]',
        quantity: 2,
        unitPriceTaxIncluded: 100,
        unitPriceTaxFree: 80,
        discountTaxIncluded: 15,
        discountTaxFree: 12,
        promotionalCode: 'promotional_code'
    }
});
tag.dispatch();

– Dans le cas d’une remise unitaire du type « 10% sur ce produit, quelque soit la quantité commandée », vous devez appliquer la remise en fonction de la quantité de produits commandés.

var tag = new ATInternet.Tracker.Tag();
// set page
tag.page.set({
    name:'pageName'
});
// set order 
tag.order.set({...}); 
// set order content
tag.cart.set({cartId: 8235});
tag.cart.add({
    product: {
        category1: '1[Computers_and_Networking]',
        productId: '250[laptop]',
        quantity: 2,
        unitPriceTaxIncluded: 100,
        unitPriceTaxFree: 80,
        discountTaxIncluded: 20,
        discountTaxFree: 16,
        promotionalCode: 'promotional_code'
    }
});
tag.dispatch();
 

Annexe : règles de marquage

  • Eviter absolument les caractères spéciaux de type « espace » et lettres avec accents.
  • Si un des champs texte contient un espace, le hit est ignoré.
  • Les libellés des champs ne doivent pas contenir de caractères spéciaux. Si un libellé existe déjà pour un identifiant donné, les libellés rencontrés par la suite ne seront pas conservés.
  • Les identifiants produits sont obligatoires.
  • Les identifiants de catégories de produits sont optionnels. Ils sont uniques, contrairement aux identifiants de sous-catégories qui peuvent être utilisés plusieurs fois avec un libellé distinct. Si vous ne renseignez pas un libellé dans la catégorie (uniquement ID), le libellé qui remontera dans l’’interface sera « #ID ».
  • Taille des identifiants et libellés :
    • Référence de la commande : 50 caractères.
    • Catégorie de produit (‘ID[category_label]’)
      • ID : nombre entier de 10 chiffres maximum.
      • category_label : nom de catégorie pouvant atteindre 150 caractères.
    • Identifiant produit (‘ID[product_label]’)
      • ID : référence alphanumérique pouvant atteindre 50 caractères.
      • product_label : nom de produit pouvant atteindre 150 caractères.
    • Tous les montants renseignés dans le marquage sont tronqués à 2 chiffres après la virgule et considérés comme valides si inférieurs à 999 999 999,99. Au-delà le montant renseigné sera considéré égal à 0.
Dernière mise à jour : 03/03/2020