Raccolta di prodotti e commercio

Se sul sito sono presenti prodotti, si tratta di un insieme predefinito di elementi che potreste desiderare inviare per abilitare il maggior numero di funzionalità da Adobe. Anche se questo è un suggerimento, fornisce una serie molto forte di dati fin dall'inizio.

In questo documento viene utilizzato il mixin ExperienceEvent Commerce Details . La commerce miscelazione è suddivisa in due parti: l' commerce oggetto e l' productListItems array. L' commerce oggetto consente di indicare quali azioni vengono eseguite sull' productListItems array.

SUGGERIMENTO

Se avete familiarità con Adobe Analytics, The commerce è più correlato alla events variabile. La variabile productListItems è più strettamente correlata alla products variabile.

Azioni relative ai prodotti

Di seguito è riportato un elenco di measures elementi disponibili nell' commerce oggetto.

SUGGERIMENTO

Una misura ha due campi: id e value. Nella maggior parte dei casi, sarà utilizzato solo il value campo (ad esempio, 'value':1). Il id campo consente di impostare un identificatore univoco che consente di tenere traccia di quando la misura è stata inviata. Consulta la documentazione XDM per Measure.

Misura Consiglio Descrizione
cartAbandons Facoltativo Un carrello non è più accessibile o acquistabile dall'utente.
checkout Altamente consigliato Un utente non sta più consultando i prodotti ma sta acquistando un prodotto.
productListAdd Altamente consigliato Un prodotto viene aggiunto a un elenco. Assicuratevi di impostare il prodotto nello productListItems stesso momento.
productListOpen 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. Ciò accade spesso nelle campagne di remarketing.
productListViews Altamente consigliato Viene visualizzato un elenco di prodotti.
productViews Altamente consigliato Vista di un prodotto. Accertatevi 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 uso futuro.

Di seguito è riportato un esempio di come impostare questi valori 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 valuta ISO 4217 per il totale dell'ordine.
payments[paymentItems] L'elenco dei pagamenti su 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 della valuta specificato.
paymentType Altamente consigliato Tipo di pagamento (ad esempio, credit_card, gift_card, paypal). Per informazioni dettagliate, consultate l'elenco dei valori noti.
transactionID Facoltativo Un ID univoco per questa transazione di pagamento.
priceTotal Altamente consigliato Totale per questo ordine dopo che tutti gli sconti e le imposte sono stati applicati.
purchaseID Altamente consigliato Identificatore univoco assegnato dal venditore per l'acquisto.
purchaseOrderNumber Facoltativo Identificatore univoco assegnato dall'acquirente per l'acquisto.

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

Elenchi di prodotti

L'elenco dei prodotti indica quali prodotti sono correlati all'azione corrispondente. È un elenco di productListItems. Ogni prodotto ha una serie di campi opzionali.

Campo Consiglio Descrizione
currencyCode Facoltativo La valuta ISO 4217 per il prodotto. Questa funzione è utile solo quando è possibile avere prodotti con codici valuta diversi e quando viene applicata. Ad esempio, in caso di acquisto o aggiunta al carrello.
priceTotal Altamente consigliato Deve essere impostato solo se applicabile. Ad esempio, potrebbe non essere possibile impostare productView perché diverse variazioni del prodotto possono avere prezzi diversi ma su un productListAdds.
product Altamente consigliato L'ID XDM per il prodotto.
productAddMethod Altamente consigliato Metodo utilizzato per aggiungere un elemento prodotto all’elenco dal visitatore. Impostato con productListAdds misure, e dovrebbe essere utilizzato solo quando un prodotto viene aggiunto all'elenco. Esempi includono add to cart button, quick adde upsell.
productName Altamente consigliato Questo è impostato sul nome visualizzato o sul nome leggibile 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, saveForLaterse così via.
SKU Altamente consigliato Unità di conservazione dello store. È l’identificatore univoco del prodotto.

Esempi

productView event

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

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

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

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

In questa pagina