1. Centre d'aide
  2. Intégrez votre Commerce
  3. Intégration personnalisée
  4. En utilisant des tags
  5. Étiquettes à placer sur les pages de succès de commande (checkout success)

Étiquette de "Achat effectué"

Création
Mise à jour
S’abonner

La balise “Achat réalisé” est un extrait de code HTML utilisé pour décrire un achat effectué.

  

Cet article fait partie des étapes pour créer une intégration personnalisée.
Si votre intégration est réalisée via un module, cette balise sera insérée automatiquement dans votre eCommerce.

 

Quelle est cette balise et où l’utiliser ?

La balise “cn_purchase" doit être insérée sur la première page visitée après un achat. Généralement, il s’agira de la page de confirmation d’achat.

 

Propriétés

Les différentes propriétés d’un achat doivent être définies à l’intérieur de la balise “cn_purchase" sous forme de balises filles, en indiquant le nom de la propriété dans l’attribut “class".

Chaque produit différent du panier est indiqué à l’aide d’une balise avec la classe "product_basket_item", qui inclut la quantité et le montant.

 

Si vous souhaitez en savoir plus sur l’objet "Product Basket Item", consultez cet article.

Les propriétés à inclure dans la balise sont :

Nom Obligatoire Type Multiples Description
total_quantity Oui entier Non 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 unités d’un autre, total_quantity sera égal à 10.
total_price Oui décimal Non Montant total de l’achat.
payment_method Non chaîne Non Méthode de paiement utilisée pour l’achat.
purchase_date Non chaîne Non Date et heure de l’achat. Format attendu : ISO_8601, par exemple 2024-09-13T10:49:31Z.
product_basket_item Non Product Basket Item Oui Articles inclus dans l’achat, avec leur quantité et leur montant.
source_name Non chaîne Non Nom de la source, pour apporter du contexte ou des détails sur le type de source de l’achat.
source_type Non chaîne Non

Nom de la source de l’achat. Les valeurs possibles sont : "marketplace", "digital-store", "point-of-sale", "third-party" et "other".
purchase_id Oui chaîne Non Identifiant unique de l’achat.
cart_id Non chaîne Non Identifiant unique du panier à l’origine de cet achat.
 

Bien que facultatif, l'utilisation du champ "cart_id" est recommandée pour changer l'état du panier en acheté et éviter des événements de Panier abandonné incorrects.

 

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

Une fois les propriétés incluses, la balise aura cet aspect :

<div class="cn_purchase " style="display:none">
   <span class="cart_id">crt8679803</span>
   <span class="purchase_id">prchs5241</span>
   <span class="purchase_date">2017-09-29 14:12:37.430Z</span>
   <span class="total_quantity">3</span>
   <span class="total_price">180.75</span>
   <span class="payment_method">Carte de crédit</span>
   <span class="source_type">digital-store</span>
   <span class="source_name">My online store</span>
   <div class="product_basket_item">
      <span class="quantity">3</span>
      <span class="price">180.75</span>
      <span class="url">http://example.org/products/pr9658</span>
      <span class="product_id">pr9658</span>
      <span class="name">Clavier Gaming Logitech Pro v.1.5</span>
      <span class="description">Clavier sans fil rétroéclairé haut de gamme, personnalisable et résistant aux liquides et aux chutes.</span>
      <span class="image_url">http://example.org/img/products/pr9658.jpg</span>
      <span class="unit_price">60.25</span>
      <span class="availability">InStock</span>
      <span class="category">/Informatique/Claviers/Logitech</span>
      <span class="category">/Informatique/Gaming</span>
      <span class="tag">Bleu</span>
      <span class="tag">Gaming</span>
      <span class="tag">Rétroéclairé</span>
      <span class="tag">Sans fil</span>
      <span class="brand">Logitech</span>
      <span class="review_count">9</span>
      <span class="rating_value">4.5</span>
      <span class="thumbnail_url">http://example.org/img/thumbnails/products/pr9658.jpg</span>
      <span class="related_external_product_id">pr10636</span>
      <span class="related_external_product_id">pr11939</span>
      <span class="related_external_product_id">pr12653</span>
      <span class="published_at">2020-05-20T15:24:20Z</span>
      <span class="custom_field_1">Informations personnalisées d'exemple</span>
   </div>
</div>

 

 
 

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

  

Des questions restent sans réponse ?
N’oubliez pas 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 poursuivre avec les articles suivants :