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 la méthode Détails du commerce ExperienceEvent groupe de champs de schéma. Le commerce
Le groupe de champs est divisé en deux parties : la valeur commerce
et le productListItems
tableau. L’objet commerce
vous permet d’indiquer les actions qui se produisent dans le tableau productListItems
.
Si vous maîtrisez Adobe Analytics, commerce
est plus étroitement lié à la variable events
. productListItems
est plus étroitement lié à la variable products
.
Vous trouverez ci-dessous une liste de measures
disponibles dans l’objet commerce
.
Une mesure comporte deux champs : id
et value
. La plupart du temps, vous utiliserez uniquement le champ value
(par exemple, 'value':1
). Le champ id
vous permet de définir un identifiant unique que vous pouvez utiliser pour suivre le moment où la mesure a été envoyée. Voir la documentation XDM pour Mesure.
Mesure | Recommandation | Description |
---|---|---|
cartAbandons | Facultative | Un panier n’est plus accessible ou ne peut plus être acheté par l’utilisateur. |
checkouts | Fortement recommandée | Un utilisateur ne recherche plus de produits mais est en train d’acheter un produit. |
productListAdds | Fortement recommandée | 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ée | Un produit est supprimé d’une liste de produits. |
productListReopens | Facultative | Une liste de produits est réactivée par l’utilisateur. Cela se produit souvent dans les campagnes de remarketing. |
productListViews | Fortement recommandée | Une liste de produits est consultée. |
productViews | Fortement recommandée | Une consultation de produit s’est produite. Veillez à définir le produit consulté dans productListItems . |
purchases | Fortement recommandée | Une commande est acceptée. Doit avoir une liste de produits. |
saveForLaters | 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 |
---|---|---|---|
currencyCode | Devise ISO 4217 pour le total de la commande. | ||
payments[paymentItems] | 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. |
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
}
]
}
});
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 |
---|---|---|
currencyCode | 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. |
priceTotal | Fortement recommandé | Ne doit être défini que 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 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 . |
productName | Fortement recommandé | Il s’agit du nom d’affichage ou du 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. |
Événement productViews
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
Événement productListAdds
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 checkouts
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 order
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
}
]
}
});