DocumentationExperience PlatformCollecte de données

Collecter des informations sur le commerce, les produits et les commandes

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Si votre entreprise vend des produits ou des services, vous pouvez utiliser cette page comme guide sur la manière de suivre ces produits et services.

Cette page utilise le groupe de champs Schéma XDM Commerce.

Ce groupe de champs se compose de deux parties principales :

  • Objet commerce. Cet objet vous permet d’indiquer les actions qui se produisent sur le tableau productListItems.
  • Le tableau productListItems.
TIP
Si vous connaissez Adobe Analytics, l’objet commerce contient des données similaires aux événements commerciaux dans la variable events . Le tableau d’objets productListItems contient des données similaires à la variable products.

Objet commerce commerce-object

Cette section décrit les champs disponibles dans l’objet commerce.

TIP
Une mesure comporte deux champs : id et value. La plupart du temps, vous n’utilisez que le champ value (par exemple, 'value':1). Le champ id vous permet de définir un identifiant unique pour le suivi lors de l’envoi de la mesure. Pour plus d’informations, consultez la documentation XDM relative à Measure.
Mesure
Recommandation
Description
cartAbandons
Facultative
Un panier n’est plus accessible ou ne peut plus être acheté par l’utilisateur.
checkouts
Hautement recommandé
Un utilisateur ne recherche plus de produits mais est en train d’acheter un produit.
productListAdds
Hautement recommandé
Un produit est ajouté à une liste. Veillez à définir le produit dans productListItems en même temps.
productListOpens
Facultative
Une liste de produits est créée. Par exemple, un nouveau panier est créé.
productListRemovals
Hautement recommandé
Un produit est supprimé d’une liste de produits.
productListReopens
Facultative
Une liste de produits est réactivée par l’utilisateur. Cette action se produit souvent dans les campagnes de remarketing.
productListViews
Hautement recommandé
Une liste de produits est consultée.
productViews
Hautement recommandé
Une vue d’un produit s’est produite. Veillez à définir le produit consulté dans productListItems.
purchases
Hautement recommandé
Une commande est acceptée. Doit avoir une liste de produits.
saveForLaters
Facultative
Un produit est enregistré pour une utilisation ultérieure.

Exemples d’objets Commerce

Développez la section ci-dessous pour afficher un exemple de commande Web SDK utilisant un champ de l’objet commerce .

productViews

Un appel de sendEvent Web SDK de base définissant le champ productViews sur 1 :

code language-javascript 
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

Objet order order-object

L’objet commerce contient un objet dédié à la collecte des détails de la commande. Il s’agit de l’objet order.

Cette section décrit tous les champs pris en charge par l’objet order.

Champ
Option
Recommandation
Description
currencyCode
Devise ISO 4217 pour le total de la commande.
payments[]
Liste des paiements dans une commande. paymentItem comprend ce qui suit.
currencyCode
Facultatif
Devise ISO 4217 pour ce mode de paiement.
paymentAmount
Hautement recommandé
Valeur du paiement dans le code de devise spécifié.
paymentType
Hautement recommandé
Type de paiement (par exemple, credit_card, gift_card, paypal). Voir la liste des valeurs connues pour obtenir des détails.
transactionID
Facultatif
ID unique pour cette transaction de paiement.
priceTotal
Hautement recommandé
Total de cette commande une fois toutes les remises et taxes appliquées.
purchaseID
Hautement recommandé
Identifiant unique attribué par le vendeur pour cet achat.
purchaseOrderNumber
Facultatif
Identifiant unique attribué par l’acheteur pour cet achat.

Exemples d’objets de commande

Développez la section ci-dessous pour afficher un exemple de commande Web SDK utilisant l’objet commerce.

Exemple d’objet Order

Un appel de sendEvent Web SDK définissant l’objet order qui s’applique à plusieurs produits dans le tableau productListItems :

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currencyCode":"USD",
        "priceTotal":39.98,
        "payments":[
          {
            "transactionID":"amx12345",
            "paymentAmount":39.98,
            "paymentType":"credit_card",
            "currencyCode":"USD"
          }
        ]
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "priceTotal":29.99,
        "quantity":1
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "priceTotal":9.99,
        "quantity":1
      }
    ]
  }
});

Objet de liste de produits product-list-object

La liste de produits indique quels produits sont liés à l’action correspondante. Il s’agit d’une liste de productListItems. Chaque produit comporte plusieurs champs facultatifs.

Champ
Recommandation
Description
currencyCode
Facultatif
Devise ISO 4217 du produit. Ce champ s’applique uniquement lorsque la liste de produits comporte plusieurs produits avec différents codes de devise.
priceTotal
Hautement recommandé
Définissez ce champ uniquement le cas échéant. Par exemple, il se peut qu’il ne soit pas possible de définir sur productView événement , car différentes variations du produit peuvent avoir des prix différents, mais sur un événement productListAdds.
product
Hautement recommandé
Identifiant XDM du produit.
productAddMethod
Hautement recommandé
Méthode utilisée par le visiteur pour ajouter un produit à la liste. Défini avec des mesures productListAdds et utilisé uniquement lorsqu’un produit est ajouté à la liste. Par exemple, add to cart button, quick add et upsell.
productName
Hautement recommandé
Nom d’affichage ou nom lisible par l’utilisateur du produit.
quantity
Hautement recommandé
Nombre d’unités du produit que le client a indiqué. Doit être défini sur productListAdds, productListRemoves, purchases, saveForLaters, etc.
SKU
Hautement recommandé
Unité de gestion des stocks. Il s’agit de l’identifiant unique du produit.

Exemples de listes de produits

Développez les sections ci-dessous pour afficher des exemples de commandes Web SDK utilisant l’objet productListItems.

productListItems exemple

Un appel de sendEvent Web SDK définissant la productViews de plusieurs produits dans le tableau productListItems :

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});
productListAdds exemple

Un appel de sendEvent Web SDK définissant l’événement productListAdds pour plusieurs produits dans le tableau de productListItems :

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productListAdds":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99,
        "productAddMethod":"Add to Cart Button"
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99,
        "productAddMethod":"Add-on"
      }
    ]
  }
});
checkouts exemple

Un appel de sendEvent Web SDK définissant l’événement checkouts pour plusieurs produits dans le tableau de productListItems :

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "checkouts":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99
      }
    ]
  }
});
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1