Se sul sito sono presenti prodotti, si tratta di un insieme predefinito di elementi che potreste desiderare inviare per abilitare il maggior numero di funzionalità da Adobe. Anche se questo è un suggerimento, fornisce una serie molto forte di dati fin dall'inizio.
In questo documento viene utilizzato il mixin ExperienceEvent Commerce Details . La commerce
miscelazione è suddivisa in due parti: l' commerce
oggetto e l' productListItems
array. L' commerce
oggetto consente di indicare quali azioni vengono eseguite sull' productListItems
array.
Se avete familiarità con Adobe Analytics, The commerce
è più correlato alla events
variabile. La variabile productListItems
è più strettamente correlata alla products
variabile.
Di seguito è riportato un elenco di measures
elementi disponibili nell' commerce
oggetto.
Una misura ha due campi: id
e value
. Nella maggior parte dei casi, sarà utilizzato solo il value
campo (ad esempio, 'value':1
). Il id
campo consente di impostare un identificatore univoco che consente di tenere traccia di quando la misura è stata inviata. Consulta la documentazione XDM per Measure.
Misura | Consiglio | Descrizione |
---|---|---|
cartAbandons | Facoltativo | Un carrello non è più accessibile o acquistabile dall'utente. |
checkout | Altamente consigliato | Un utente non sta più consultando i prodotti ma sta acquistando un prodotto. |
productListAdd | Altamente consigliato | Un prodotto viene aggiunto a un elenco. Assicuratevi di impostare il prodotto nello productListItems stesso momento. |
productListOpen | Facoltativo | Viene creato un nuovo elenco di prodotti. Ad esempio, viene creato un nuovo carrello. |
productListRemovals | Altamente consigliato | Un prodotto viene rimosso da un elenco di prodotti. |
productListReopen | Facoltativo | Un elenco di prodotti viene riattivato dall'utente. Ciò accade spesso nelle campagne di remarketing. |
productListViews | Altamente consigliato | Viene visualizzato un elenco di prodotti. |
productViews | Altamente consigliato | Vista di un prodotto. Accertatevi di impostare il prodotto visualizzato nel productListItems . |
acquisti | Altamente consigliato | Un ordine è accettato. Deve avere un elenco di prodotti. |
saveForLaters | Facoltativo | Un prodotto viene salvato per uso futuro. |
Di seguito è riportato un esempio di come impostare questi valori Measures
nell’SDK.
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
L'oggetto commerce dispone anche di un campo speciale per la raccolta dei dettagli dell'ordine denominato order
.
Ordine | Opzione | Consiglio | Descrizione |
---|---|---|---|
currencyCode | La valuta ISO 4217 per il totale dell'ordine. | ||
payments[paymentItems] | L'elenco dei pagamenti su un ordine. Un oggetto paymentItem include quanto segue: | ||
currencyCode | Facoltativo | La valuta ISO 4217 per questo metodo di pagamento. | |
paymentAmount | Altamente consigliato | Il valore del pagamento nel codice della valuta specificato. | |
paymentType | Altamente consigliato | Tipo di pagamento (ad esempio, credit_card , gift_card , paypal ). Per informazioni dettagliate, consultate l'elenco dei valori noti. |
|
transactionID | Facoltativo | Un ID univoco per questa transazione di pagamento. | |
priceTotal | Altamente consigliato | Totale per questo ordine dopo che tutti gli sconti e le imposte sono stati applicati. | |
purchaseID | Altamente consigliato | Identificatore univoco assegnato dal venditore per l'acquisto. | |
purchaseOrderNumber | Facoltativo | Identificatore univoco assegnato dall'acquirente per l'acquisto. |
Esempio di acquisto tipico nell’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
}
]
}
});
L'elenco dei prodotti indica quali prodotti sono correlati all'azione corrispondente. È un elenco di productListItems. Ogni prodotto ha una serie di campi opzionali.
Campo | Consiglio | Descrizione |
---|---|---|
currencyCode | Facoltativo | La valuta ISO 4217 per il prodotto. Questa funzione è utile solo quando è possibile avere prodotti con codici valuta diversi e quando viene applicata. Ad esempio, in caso di acquisto o aggiunta al carrello. |
priceTotal | Altamente consigliato | Deve essere impostato solo se applicabile. Ad esempio, potrebbe non essere possibile impostare productView perché diverse variazioni del prodotto possono avere prezzi diversi ma su un productListAdds . |
product | Altamente consigliato | L'ID XDM per il prodotto. |
productAddMethod | Altamente consigliato | Metodo utilizzato per aggiungere un elemento prodotto all’elenco dal visitatore. Impostato con productListAdds misure, e dovrebbe essere utilizzato solo quando un prodotto viene aggiunto all'elenco. Esempi includono add to cart button , quick add e upsell . |
productName | Altamente consigliato | Questo è impostato sul nome visualizzato o sul nome leggibile del prodotto. |
quantità | Altamente consigliato | Il numero di unità che il cliente ha indicato di aver bisogno del prodotto. Deve essere impostato su productListAdds , productListRemoves , purchases , saveForLaters e così via. |
SKU | Altamente consigliato | Unità di conservazione dello store. È l’identificatore univoco del prodotto. |
productView
event
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productView
event
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"
}
]
}
});
checkout
event
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
}
]
}
});
purchase
event
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
}
]
}
});