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 :
commerce
. Cet objet vous permet d’indiquer les actions qui se produisent dans la variable productListItems
tableau.productListItems
tableau.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 .
commerce
objetCette section décrit les champs disponibles dans la variable commerce
.
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’objetsDé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
}
}
}
});
order
objetLa 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. |
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’objetUn 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
}
]
}
});
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. |
Développez les sections ci-dessous pour voir des exemples de commandes du SDK Web à l’aide de la fonction productListItems
.
productListItems
exempleUn 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
examplaeUn 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
exempleUn 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
}
]
}
});