Se sul sito sono presenti prodotti, si tratta di un set predefinito di elementi che puoi inviare per abilitare il maggior numero di funzionalità da Adobe. Anche se questo è un suggerimento, fornisce un set di dati molto forte fin dall'inizio.
Questo documento utilizza Dettagli di ExperienceEvent Commerce gruppo di campi dello schema. La commerce
il gruppo di campi è suddiviso in due parti: la commerce
e productListItems
array. La commerce
consente di indicare le azioni che si stanno verificando productListItems
array.
Se hai familiarità con Adobe Analytics, l’ commerce
è strettamente correlato al events
variabile. La productListItems
è più strettamente correlato al products
variabile.
Di seguito è riportato un elenco di measures
disponibile nella commerce
oggetto.
Una misura ha due campi: id
e value
. Nella maggior parte dei casi, utilizzerai il value
solo campo (ad esempio, 'value':1
). La id
consente di impostare un identificatore univoco da utilizzare per tenere traccia di quando la misura è stata inviata. Consulta la documentazione XDM per Misura.
Misura | Consiglio | Descrizione |
---|---|---|
cartAbandons | Facoltativo | Un carrello non è più accessibile o acquistabile dall’utente. |
checkout | Altamente consigliato | Un utente non sta più navigando per i prodotti, ma sta acquistando un prodotto. |
productListAdd | Altamente consigliato | Un prodotto viene aggiunto a un elenco. Assicurati di impostare il prodotto nel productListItems allo stesso tempo. |
productListViews | 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. Questo accade spesso nelle campagne di remarketing. |
productListViews | Altamente consigliato | Viene visualizzato un elenco di prodotti. |
productViews | Altamente consigliato | Visualizzazione di un prodotto. Assicurati 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 un utilizzo futuro. |
Ecco un esempio di come impostarli 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 ISO 4217 divisa per il totale dell'ordine. | ||
payments[paymentItems] | L'elenco dei pagamenti su un ordine. A paymentItem include quanto segue. | ||
currencyCode | Facoltativo | La ISO 4217 valuta per questo metodo di pagamento. | |
paymentAmount | Altamente consigliato | Valore del pagamento nel codice valuta specificato. | |
paymentType | Altamente consigliato | Tipo di pagamento (ad esempio, credit_card , gift_card , paypal ). Vedi l'elenco dei valori noti per i dettagli. |
|
transactionID | Facoltativo | Un ID univoco per questa transazione di pagamento. | |
priceTotal | Altamente consigliato | Totale per l'ordine dopo l'applicazione di tutti gli sconti e le imposte. | |
purchaseID | Altamente consigliato | Identificatore univoco assegnato dal venditore per l'acquisto. | |
purchaseOrderNumber | Facoltativo | Identificatore univoco assegnato dall'acquirente per l'acquisto. |
Ecco un 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 dispone di una serie di campi facoltativi.
Campo | Consiglio | Descrizione |
---|---|---|
currencyCode | Facoltativo | La ISO 4217 valuta per il prodotto. Questa funzione è utile solo quando è possibile avere prodotti con diversi codici di valuta e quando viene applicata. Ad esempio, quando esiste un acquisto o aggiungi al carrello. |
priceTotal | Altamente consigliato | Deve essere impostato solo se applicabile. Ad esempio, potrebbe non essere possibile impostare su productView evento perché diverse variazioni del prodotto possono avere prezzi diversi ma su un productListAdds evento. |
prodotto | Altamente consigliato | ID XDM per il prodotto. |
productAddMethod | Altamente consigliato | Il metodo utilizzato dal visitatore per aggiungere un elemento prodotto all’elenco. Imposta con productListAdds misure e devono essere utilizzate solo quando un prodotto è aggiunto all'elenco. Esempi add to cart button , quick add e upsell . |
productName | Altamente consigliato | Questo è impostato sul nome visualizzato o il nome leggibile dall'utente 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 | Archivia unità di conservazione. È l’identificatore univoco del prodotto. |
productViews
event
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAdds
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"
}
]
}
});
checkouts
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
}
]
}
});
order
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
}
]
}
});