Show Menu
SUJETS×

Produits

Si votre site contient des produits, il s’agit d’un ensemble par défaut d’éléments que vous souhaiterez peut-être envoyer pour activer les fonctionnalités essentielles d’Adobe. Bien qu’il s’agisse d’une suggestion, un ensemble très solide de données est fourni dès le départ.
Ce document utilise le mixin ExperienceEvent Commerce Details . Le mixin commerce est divisé en deux parties : l’objet commerce et le tableau productListItems . L’objet commerce vous permet d’indiquer les actions qui se produisent dans le tableau productListItems .

Actions liées aux produits

Vous trouverez ci-dessous une liste de measures disponibles dans l’objet commerce .
Mesure
Recommandation
Description
Facultative
Un panier n’est plus accessible ou ne peut plus être acheté par l’utilisateur.
Fortement recommandée
Un utilisateur ne recherche plus de produits mais est en train d’acheter un produit.
Fortement recommandée
Un produit est ajouté à une liste. Veillez à définir le produit dans productListItems en même temps.
Facultative
Une liste de produits est créée. (Par exemple, un nouveau panier est créé.)
Fortement recommandée
Un produit est supprimé d’une liste de produits.
Facultative
Une liste de produits est réactivée par l’utilisateur. Cela se produit souvent dans les campagnes de remarketing.
Fortement recommandée
Une liste de produits est consultée.
Fortement recommandée
Une consultation de produit s’est produite. Veillez à définir le produit consulté dans productListItems .
Fortement recommandée
Une commande est acceptée. Doit avoir une liste de produits.
Facultative
Un produit est enregistré pour une utilisation ultérieure.
Voici un exemple de la manière dont vous définiriez ces Measures dans le SDK.
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

L’objet de commerce dispose également d’un champ spécial pour la collecte des détails de commande appelé order .
Commande
Option
Recommandation
Description
Devise ISO 4217 pour le total de la commande.
Liste des paiements dans une commande. paymentItem comprend ce qui suit.
Facultatif
Devise ISO 4217 pour ce mode de paiement.
Fortement recommandé
Valeur du paiement dans le code de devise spécifié.
Fortement recommandé
Type de paiement (par exemple, credit_card , gift_card , paypal ). Voir la liste des valeurs connues pour obtenir des détails.
Facultatif
Identifiant unique pour cette transaction de paiement.
Fortement recommandé
Total de cette commande une fois toutes les remises et taxes appliquées.
Fortement recommandé
Identifiant unique attribué par le vendeur pour cet achat.
Facultatif
Identifiant unique attribué par l’acheteur pour cet achat.
Voici un exemple d’achat type dans le SDK.
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
      }
    ]
  }
});

Listes 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 un certain nombre de champs facultatifs.
Champ
Recommandation
Description
Facultatif
Devise ISO 4217 pour le produit. Cette valeur n’est utile que lorsque vous pouvez avoir des produits avec des codes de devise différents et lorsqu’elle est applicable. Par exemple, en cas d’achat ou d’ajout au panier.
Fortement recommandé
Ne doit être défini que le cas échéant. Par exemple, il peut ne pas être possible d’effectuer une définition sur productView , car différentes variantes du produit peuvent avoir des prix différents, mais sur productListAdds .
Fortement recommandé
Identifiant XDM du produit.
Fortement recommandé
Méthode utilisée par le visiteur pour ajouter un produit à la liste. Défini avec des mesures productListAdds et ne doit être utilisé que lorsqu’un produit est ajouté à la liste. Par exemple, add to cart button , quick add et upsell .
Fortement recommandé
Il s’agit du nom d’affichage ou du nom lisible du produit.
Fortement recommandé
Nombre d’unités du produit que le client a indiqué. Doit être défini sur productListAdds , productListRemoves , purchases , saveForLaters , etc.
Fortement recommandé
Unité de gestion des stocks. Il s’agit de l’identifiant unique du produit.

Exemples

Événement productView
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});

Événement productView
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"
      }
    ]
  }
});

Événement checkout
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
      }
    ]
  }
});

Événement purchase
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
      }
    ]
  }
});