Se sul sito sono presenti prodotti, si tratta di un set predefinito di elementi che potresti voler inviare per abilitare il maggior numero di funzionalità di Adobe. Anche se questo è un suggerimento, fornisce un set molto forte di dati fin dall'inizio.
Questo documento utilizza Dettagli di ExperienceEvent Commerce gruppo di campi dello schema. Il commerce
è suddiviso in due parti: commerce
oggetto e productListItems
array. Il commerce
oggetto consente di indicare le azioni che si verificano per productListItems
array.
Se hai familiarità con Adobe Analytics, il commerce
è strettamente correlato al events
variabile. Il productListItems
è più strettamente correlato al products
variabile.
Di seguito è riportato un elenco di measures
disponibile in commerce
oggetto.
Una misura ha due campi: id
e value
. Nella maggior parte dei casi, utilizzerai value
solo campo (ad esempio, 'value':1
). Il id
consente di impostare un identificatore univoco da utilizzare per tenere traccia di quando è stata inviata la misura. Consulta la documentazione di XDM per Misura.
Misura | Consiglio | Descrizione |
---|---|---|
cartAbandons | Facoltativo | Un carrello non è più accessibile o acquistabile dall’utente. |
checkout | Altamente consigliato | Un utente non cerca più prodotti, ma sta acquistando un prodotto. |
productListAdds | Altamente consigliato | Un prodotto viene aggiunto a un elenco. Assicurarsi di impostare il prodotto in productListItems contemporaneamente. |
productListOpens | 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. |
productListReopens | 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 | Si è verificata una visualizzazione di un prodotto. Assicurati di impostare il prodotto visualizzato in productListItems . |
acquisti | Altamente consigliato | Un ordine è accettato. Deve avere un elenco di prodotti. |
saveForLaters | Facoltativo | Un prodotto viene salvato per un utilizzo futuro. |
Di seguito è riportato un esempio di impostazione 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 | Il ISO 4217 valuta per il totale dell’ordine. | ||
payments[paymentItems] | Elenco dei pagamenti in un ordine. A paymentItem include quanto segue. | ||
currencyCode | Facoltativo | Il ISO 4217 valuta per questo metodo di pagamento. | |
paymentAmount | Altamente consigliato | Il valore del pagamento nel codice valuta specificato. | |
paymentType | Altamente consigliato | Tipo di pagamento (ad esempio, credit_card , gift_card , paypal ). Consulta l’elenco di valori noti per i dettagli. |
|
transactionID | Facoltativo | Un ID univoco per questa transazione di pagamento. | |
priceTotal | Altamente consigliato | Totale per questo ordine dopo l'applicazione di tutti gli sconti e le imposte. | |
purchaseID | Altamente consigliato | L'identificatore univoco assegnato dal venditore per questo acquisto. | |
purchaseOrderNumber | Facoltativo | Un identificatore univoco assegnato dall’acquirente a questo acquisto. |
Ecco un esempio di un 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 diversi campi facoltativi.
Campo | Consiglio | Descrizione |
---|---|---|
currencyCode | Facoltativo | Il ISO 4217 valuta per il prodotto. Questa funzione è utile solo quando si possono avere prodotti con codici valuta diversi e quando è applicabile. Ad esempio, in caso di acquisto o di aggiunta al carrello. |
priceTotal | Altamente consigliato | Deve essere impostato solo se applicabile. Ad esempio, potrebbe non essere possibile impostare su productView evento perché diverse varianti del prodotto possono avere prezzi diversi, ma su productListAdds evento. |
prodotto | Altamente consigliato | L’ID XDM del prodotto. |
productAddMethod | Altamente consigliato | Il metodo utilizzato dal visitatore per aggiungere un elemento di prodotto all’elenco. Imposta con productListAdds e devono essere utilizzati solo quando un prodotto viene aggiunto all’elenco. Alcuni esempi includono add to cart button , quick add , e upsell . |
productName | Altamente consigliato | È impostato sul nome visualizzato o sul nome leggibile del prodotto. |
quantità | Altamente consigliato | Il numero di unità del prodotto che il cliente ha indicato di richiedere. Deve essere impostato su productListAdds , productListRemoves , purchases , saveForLaters e così via. |
SKU | Altamente consigliato | Conservare l'unità. È l’identificatore univoco del prodotto. |
productViews
evento
alloy("sendEvent",{
"xdm":{
"commerce":{
"productViews":{
"value":1
}
},
"productListItems":[
{
"SKU":"HT105",
"name":"The Big Floppy Hat",
},
{
"SKU":"HT104",
"name":"The Small Floppy Hat",
}
]
}
});
productListAdds
evento
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
evento
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
evento
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
}
]
}
});