Raccogliere informazioni su prodotti e ordini

Ultimo aggiornamento: 2023-11-14
  • Argomenti:
  • Web SDK
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer
    User
    Admin
    Leader

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

Questa pagina utilizza XDM Schema Commerce gruppo di campi.

Questo gruppo di campi è costituito da due parti principali:

  • Il commerce oggetto. Questo oggetto ti consente di indicare quali azioni vengono eseguite productListItems array.
  • Il productListItems array.
SUGGERIMENTO

Se hai familiarità con Adobe Analytics, il commerce L'oggetto contiene dati simili agli eventi di e-commerce in events variabile. Il productListItems l'array di oggetti contiene dati simili a products variabile.

Il commerce oggetto

Questa sezione descrive i campi disponibili nel commerce oggetto.

SUGGERIMENTO

Una misura ha due campi: id e value. Nella maggior parte dei casi, si utilizza solo value campo (ad esempio, 'value':1). Il id consente di impostare un identificatore univoco per il tracciamento al momento dell’invio della misura. Consulta la documentazione di XDM per Misura per ulteriori informazioni.

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. Assicurati 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

Espandi la sezione seguente per visualizzare un esempio di comando Web SDK che utilizza un campo del commerce oggetto.

 productViews

Un Web SDK di base sendEvent chiamata impostazione della productViews campo a 1:

alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

Il order oggetto

Il commerce L'oggetto contiene un oggetto dedicato per la raccolta dei dettagli dell'ordine. Questa funzione è denominata order oggetto.

Questa sezione descrive tutti i campi supportati da order oggetto.

Campo Opzione Consiglio Descrizione
currencyCode Il ISO 4217 valuta per il totale dell’ordine.
payments[] 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.

Esempi di oggetti dell’ordine

Espandi la sezione seguente per visualizzare un esempio di comando Web SDK utilizzando commerce oggetto.

 Order esempio di oggetto

SDK per web sendEvent chiamata impostazione della order oggetto che si applica a più prodotti nel productListItems array:

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

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 Il ISO 4217 valuta 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 su productView evento perché diverse varianti del prodotto possono avere prezzi diversi, ma su productListAdds evento.
product 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 viene utilizzato solo quando un prodotto viene aggiunto all’elenco. Alcuni 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, saveForLaterse così via.
SKU Altamente consigliato Conservare l'unità. È l’identificatore univoco del prodotto.

Esempi di elenco dei prodotti

Espandi le sezioni seguenti per visualizzare esempi di comandi Web SDK utilizzando productListItems oggetto.

 productListItems esempio

SDK per web sendEvent chiamata impostazione della productViews per più prodotti in productListItems array:

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

SDK per web sendEvent chiamata impostazione della productListAdds evento per più prodotti in productListItems array:

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

SDK per web sendEvent chiamata impostazione della checkouts evento per più prodotti in productListItems array:

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

In questa pagina