Raccogliere informazioni su prodotti e commercio

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.

SUGGERIMENTO

Se hai familiarità con Adobe Analytics, il commerce è strettamente correlato al events variabile. Il productListItems è più strettamente correlato al products variabile.

Azioni relative ai prodotti

Di seguito è riportato un elenco di measures disponibile in commerce oggetto.

SUGGERIMENTO

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

Elenchi di prodotti

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, saveForLaterse così via.
SKU Altamente consigliato Conservare l'unità. È l’identificatore univoco del prodotto.

Esempi

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

In questa pagina