Raccogliere informazioni su prodotti e soluzioni commerce

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

Questo documento utilizza Dettagli di ExperienceEvent Commerce gruppo di campi dello schema. La commerce il gruppo di campi è suddiviso in due parti: la commerce e productListItems array. La commerce consente di indicare le azioni che si stanno verificando productListItems array.

SUGGERIMENTO

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

Azioni relative ai prodotti

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

SUGGERIMENTO

Una misura ha due campi: id e value. Nella maggior parte dei casi, utilizzerai il value solo campo (ad esempio, 'value':1). La id consente di impostare un identificatore univoco da utilizzare per tenere traccia di quando la misura è stata inviata. Consulta la documentazione XDM per Misura.

Misura Consiglio Descrizione
cartAbandons Facoltativo Un carrello non è più accessibile o acquistabile dall’utente.
checkout Altamente consigliato Un utente non sta più navigando per i prodotti, ma sta acquistando un prodotto.
productListAdd Altamente consigliato Un prodotto viene aggiunto a un elenco. Assicurati di impostare il prodotto nel productListItems allo stesso tempo.
productListViews 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. Questo accade spesso nelle campagne di remarketing.
productListViews Altamente consigliato Viene visualizzato un elenco di prodotti.
productViews Altamente consigliato Visualizzazione di un prodotto. Assicurati 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 un utilizzo futuro.

Ecco un esempio di come impostarli 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 ISO 4217 divisa per il totale dell'ordine.
payments[paymentItems] L'elenco dei pagamenti su un ordine. A paymentItem include quanto segue.
currencyCode Facoltativo La ISO 4217 valuta per questo metodo di pagamento.
paymentAmount Altamente consigliato Valore del pagamento nel codice valuta specificato.
paymentType Altamente consigliato Tipo di pagamento (ad esempio, credit_card, gift_card, paypal). Vedi l'elenco dei valori noti per i dettagli.
transactionID Facoltativo Un ID univoco per questa transazione di pagamento.
priceTotal Altamente consigliato Totale per l'ordine dopo l'applicazione di tutti gli sconti e le imposte.
purchaseID Altamente consigliato Identificatore univoco assegnato dal venditore per l'acquisto.
purchaseOrderNumber Facoltativo Identificatore univoco assegnato dall'acquirente per l'acquisto.

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

Elenco dei prodotti

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

Campo Consiglio Descrizione
currencyCode Facoltativo La ISO 4217 valuta per il prodotto. Questa funzione è utile solo quando è possibile avere prodotti con diversi codici di valuta e quando viene applicata. Ad esempio, quando esiste un acquisto o aggiungi al carrello.
priceTotal Altamente consigliato Deve essere impostato solo se applicabile. Ad esempio, potrebbe non essere possibile impostare su productView perché diverse variazioni del prodotto possono avere prezzi diversi ma su un productListAdds.
prodotto Altamente consigliato ID XDM per il prodotto.
productAddMethod Altamente consigliato Il metodo utilizzato dal visitatore per aggiungere un elemento prodotto all’elenco. Imposta con productListAdds misure e devono essere utilizzate solo quando un prodotto è aggiunto all'elenco. Esempi add to cart button, quick adde upsell.
productName Altamente consigliato Questo è impostato sul nome visualizzato o il nome leggibile dall'utente 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 Archivia unità di conservazione. È l’identificatore univoco del prodotto.

Esempi

productViews event

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

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

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

order 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