DocumentazioneExperience PlatformRaccolta dati

Raccogliere informazioni su prodotti e ordini

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Se la tua organizzazione vende prodotti o servizi, puoi utilizzare questa pagina come guida su come tracciare tali prodotti e servizi.

In questa pagina viene utilizzato il gruppo di campi Schema Commerce XDM.

Questo gruppo di campi è costituito da due parti principali:

  • Oggetto commerce. Questo oggetto consente di indicare quali azioni vengono eseguite sull'array productListItems.
  • Array productListItems.
TIP
Se si ha familiarità con Adobe Analytics, l'oggetto commerce contiene dati simili agli eventi commerce nella variabile events. L'array di oggetti productListItems contiene dati simili alla variabile products.

Oggetto commerce commerce-object

Questa sezione descrive i campi disponibili nell'oggetto commerce.

TIP
Una misura ha due campi: id e value. Nella maggior parte dei casi si utilizza solo il campo value (ad esempio 'value':1). Il campo id consente di impostare un identificatore univoco per il tracciamento al momento dell'invio della misura. Per ulteriori informazioni, consulta la documentazione XDM per Measure.
Misura
Consiglio
Descrizione
cartAbandons
Facoltativo
Un carrello non è più accessibile o acquistabile dall’utente.
checkouts
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. Questa azione si verifica spesso nelle campagne di remarketing.
productListViews
Altamente consigliato
Viene visualizzato un elenco di prodotti.
productViews
Altamente consigliato
Si è verificata una visualizzazione di un prodotto. Assicurarsi di impostare il prodotto visualizzato in productListItems.
purchases
Altamente consigliato
Un ordine è accettato. Deve avere un elenco di prodotti.
saveForLaters
Facoltativo
Un prodotto viene salvato per un utilizzo futuro.

Commerce esempi di oggetti

Espandere la sezione seguente per visualizzare un esempio di un comando Web SDK che utilizza un campo dell'oggetto commerce.

productViews

Chiamata di base di Web SDK sendEvent che imposta il campo productViews su 1:

code language-javascript 
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

Oggetto order order-object

L'oggetto commerce contiene un oggetto dedicato per la raccolta dei dettagli dell'ordine. Questo è denominato oggetto order.

Questa sezione descrive tutti i campi supportati dall'oggetto order.

Campo
Opzione
Consiglio
Descrizione
currencyCode
Valuta ISO 4217 per il totale dell'ordine.
payments[]
Elenco dei pagamenti in 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 valuta specificato.
paymentType
Altamente consigliato
Tipo di pagamento (ad esempio credit_card, gift_card, paypal). Per ulteriori informazioni, vedere l'elenco di valori noti.
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.

Esempi di oggetti dell’ordine

Espandere la sezione seguente per visualizzare un esempio di un comando Web SDK che utilizza l'oggetto commerce.

Order esempio di oggetto

Una chiamata Web SDK sendEvent che imposta l'oggetto order che si applica a più prodotti nell'array productListItems:

code language-javascript 
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
      }
    ]
  }
});

Oggetto elenco prodotti product-list-object

L’elenco dei prodotti indica quali prodotti sono correlati all’azione corrispondente. È un elenco di productListItems. Ogni prodotto ha diversi campi facoltativi.

Campo
Consiglio
Descrizione
currencyCode
Facoltativo
La valuta ISO 4217 per il prodotto. Questo campo si applica in genere solo quando nell’elenco dei prodotti sono presenti più prodotti con codici di valuta diversi.
priceTotal
Altamente consigliato
Imposta questo campo solo se applicabile. Ad esempio, potrebbe non essere possibile impostare sull'evento productView perché diverse varianti del prodotto possono avere prezzi diversi ma su un evento productListAdds.
product
Altamente consigliato
L’ID XDM del prodotto.
productAddMethod
Altamente consigliato
Il metodo utilizzato dal visitatore per aggiungere un elemento di prodotto all’elenco. Impostato con productListAdds misure e utilizzato solo quando un prodotto viene aggiunto all'elenco. Gli esempi includono add to cart button, quick add e upsell.
productName
Altamente consigliato
Il nome visualizzato o leggibile del prodotto.
quantity
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.

Esempi di elenco dei prodotti

Espandere le sezioni seguenti per visualizzare esempi di comandi Web SDK che utilizzano l'oggetto productListItems.

productListItems esempio

Una chiamata Web SDK sendEvent che imposta productViews per più prodotti nell'array productListItems:

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});
productListAdds esempio

Una chiamata Web SDK sendEvent che imposta l'evento productListAdds per più prodotti nell'array productListItems:

code language-javascript 
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 esempio

Una chiamata Web SDK sendEvent che imposta l'evento checkouts per più prodotti nell'array productListItems:

code language-javascript 
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
      }
    ]
  }
});
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1