Collecte d’informations sur le commerce, les produits et les commandes

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 XDM Schéma de commerce groupe de champs.

Ce groupe de champs se compose de deux parties principales :

  • La variable commerce . Cet objet vous permet d’indiquer les actions qui se produisent dans la variable productListItems tableau.
  • La variable productListItems tableau.
CONSEIL

Si vous connaissez Adobe Analytics, la variable commerce contient des données similaires aux événements de commerce dans events Variable . La variable productListItems Le tableau d’objets contient des données similaires à products Variable .

La variable commerce objet

Cette section décrit les champs disponibles dans la variable commerce .

CONSEIL

Une mesure comporte deux champs : id et value. La plupart du temps, vous utilisez uniquement la variable value (par exemple, 'value':1). La variable id vous permet de définir un identifiant unique pour le suivi lorsque la mesure a été envoyée. Consultez la documentation XDM pour Mesure pour plus d’informations.

Mesure Recommandation Description
cartAbandons Facultative Un panier n’est plus accessible ou ne peut plus être acheté par l’utilisateur.
checkouts Fortement recommandé Un utilisateur ne recherche plus de produits mais est en train d’acheter un produit.
productListAdds Fortement 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 Fortement 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 Fortement recommandé Une liste de produits est consultée.
productViews Fortement recommandé Une consultation d’un produit s’est produite. Veillez à définir le produit consulté dans productListItems.
purchases Fortement recommandé Une commande est acceptée. Doit avoir une liste de produits.
saveForLaters Facultative Un produit est enregistré pour une utilisation ultérieure.

Commerce exemples d’objets

Développez la section ci-dessous pour voir un exemple de commande d’un SDK Web à l’aide d’un champ du commerce .

 productViews

Un SDK Web de base sendEvent paramètre d’appel productViews champ à 1:

alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

La variable order objet

La variable commerce contient un objet dédié pour la collecte des détails de commande. Cela s’appelle la variable order .

Cette section décrit tous les champs pris en charge par le 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 Fortement recommandé Valeur du paiement dans le code de devise spécifié.
paymentType Fortement 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 Fortement recommandé Total de cette commande une fois toutes les remises et taxes appliquées.
purchaseID Fortement 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 voir un exemple de commande de SDK Web à l’aide de la propriété commerce .

 Order exemple d’objet

Un SDK Web sendEvent paramètre d’appel order qui s’applique à plusieurs produits dans la variable productListItems tableau :

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

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 La variable ISO 4217 devise du produit. Ce champ s’applique généralement uniquement lorsque plusieurs produits de la liste de produits comportent des codes de devise différents.
priceTotal Fortement recommandé Définissez ce champ uniquement le cas échéant. Par exemple, il peut ne pas être possible de définir sur productView car différentes variations du produit peuvent avoir des prix différents, mais sur un productListAdds .
product Fortement recommandé Identifiant XDM du produit.
productAddMethod Fortement recommandé Méthode utilisée par le visiteur pour ajouter un produit à la liste. Défini sur productListAdds mesure et n’est utilisé que lorsqu’un produit est ajouté à la liste. Par exemple, add to cart button, quick add et upsell.
productName Fortement recommandé Nom d’affichage ou nom lisible du produit.
quantity Fortement recommandé Nombre d’unités du produit que le client a indiqué. Doit être défini sur productListAdds, productListRemoves, purchases, saveForLaters, etc.
SKU Fortement 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 voir des exemples de commandes du SDK Web à l’aide de la fonction productListItems .

 productListItems exemple

Un SDK Web sendEvent paramètre d’appel productViews pour plusieurs produits dans la variable productListItems tableau :

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

Un SDK Web sendEvent paramètre d’appel productListAdds pour plusieurs produits dans productListItems tableau :

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 SDK Web sendEvent paramètre d’appel checkouts pour plusieurs produits dans productListItems tableau :

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
      }
    ]
  }
});

Sur cette page