Riferimento dati Magento 2
Scopri quali dati Klaviyo importa dal tuo negozio Magento 2 quando integri le due piattaforme. La sincronizzazione storica iniziale importa fino a 5 anni di dati su ordini e clienti, incluse le informazioni associate agli ordini effettuati ed evasi in passato. Una volta abilitata, l’integrazione sincronizza anche i dati su ordini e clienti ogni 30 minuti.
In Klaviyo, vai a Analisi > Metriche nella barra laterale sinistra per visualizzare tutte le metriche del tuo account; le metriche con un’icona Magento 2 sono gli eventi sincronizzati dalla tua integrazione Magento 2. Vedrai anche gli eventi di tracciamento onsite di Klaviyo con un’icona a forma di ingranaggio; anche questi vengono tracciati tramite l’integrazione.


Come Klaviyo determina le metriche di Magento 2
Metriche dell'ordine
Klaviyo registra un evento Placed Order per ogni ordine che sincronizza. Utilizza anche lo Status attuale dell’ordine e la cronologia degli stati in Magento 2 per registrare metriche aggiuntive sugli ordini.
Quando un ordine viene creato o aggiornato, Klaviyo verifica lo stato corrente e lo storico degli stati. La tabella di seguito mostra le mappature standard. Gli ordini con pending_payment o con uno stato personalizzato configurato per essere ignorato vengono esclusi.
Stato dell'ordine Magento | Metriche attivate in Klaviyo |
Completo | Ordine effettuato e ordine evaso |
annullato, annullato | Ordine effettuato e ordine annullato |
pagamento interrotto | Ordine effettuato e pagamento annullato |
Chiuso | Ordine effettuato e ordine rimborsato |
Tutti gli altri stati dell'ordine, eccetto gli stati ignorati | Ordine effettuato |
Se hai stati dell’ordine personalizzati che non dovrebbero attivare una metrica Placed Order , o non sono in linea con la tabella sopra, facci sapere così possiamo configurare gli stati personalizzati in modo che vengano ignorati o mappati su eventi dell’ordine aggiuntivi.
Gli ordini con stato "pending_payment" verranno ignorati.
Metrica Pagamento avviato
Con una procedura di pagamento standard di Magento, questo evento viene attivato quando un cliente inserisce le informazioni di contatto e di spedizione nella prima pagina della procedura di pagamento di Magento e clicca su Continua.
L’evento Started Checkout si basa su un carrello (chiamato preventivo in Magento) con un indirizzo e-mail associato. Klaviyo lo sincronizza solo se, quando viene eseguita la sincronizzazione, il carrello è ancora attivo e contiene articoli.
Se il cliente completa l’ordine prima che il carrello si sincronizzi, il carrello non è più attivo e Klaviyo lo ignora. Un evento Placed Order viene registrato quando l’ordine si sincronizza, a meno che il suo stato non venga ignorato. Un evento Started Checkout che è già stato sincronizzato rimane in Klaviyo. Tieni presente che la sincronizzazione degli eventi Started Checkout in Klaviyo potrebbe richiedere fino a 1 ora.
Metrica Spedizione evasa
Questa metrica viene attivata quando viene creata una nuova spedizione nel tuo negozio Magento 2.
Dati della metrica Magento 2
Questa sezione tratta le metriche di Magento 2 e i dati disponibili per il filtraggio quando crei segmenti e flussi.
Ordine annullato
Questo evento viene attivato quando lo stato di un ordine viene modificato in annullato o annullato nel tuo negozio Magento 2.
- ProductCategories
le categorie dei prodotti nell’ordine annullato. - Valore
Il valore dell’ordine annullato. - Scontato
(Vero o Falso) Lo stato dello sconto dell’ordine annullato. - NomiProdotto
I nomi dei prodotti nell’ordine annullato. - ItemCount
Il numero di righe dell’ordine, non la quantità totale di unità. - OrderCurrencyCode
Il codice valuta utilizzato con l'ordine annullato. - ID regole prezzo carrello
Un array di ID regole prezzo carrello (stringhe di ID numerici) che include le regole applicate automaticamente e la regola per un coupon applicato. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
Ordine evaso
Questo evento viene tracciato quando imposti lo stato di un ordine su completato nel tuo negozio Magento 2.
- CategorieProdotto
Le categorie dei prodotti nell'ordine. - Valore
Il valore dell'ordine. - Scontato
Se l'ordine è scontato o meno. - NomiProdotti
I nomi dei prodotti nell’ordine. - ItemCount
Il numero di righe dell’ordine, non la quantità totale di unità. - OrderCurrencyCode
Il codice valuta utilizzato con l'ordine. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
Spedizione evasa
Questo evento è tracciato quando viene creata una nuova Spedizione nel tuo negozio Magento 2.
- Nome negozio
Il nome del negozio in cui è stato effettuato l'ordine. - ID negozio
L'ID del negozio in cui è stato effettuato l'ordine. - BillingAddress
L’indirizzo di fatturazione per l’ordine. - Traccia
Informazioni sul tracciamento della spedizione. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
Prodotto ordinato
Klaviyo registra 1 evento Ordered Product per unità ordinata, fino a 100 eventi per voce di riga. Ad esempio, un ordine di 3 unità della stessa maglietta genera 3 eventi Ordered Product, ciascuno con una quantità pari a 1. Per i prodotti venduti in quantità frazionarie, Klaviyo registra 1 evento con la quantità ordinata.
- SKU
Lo SKU del prodotto. - OrderCurrencyCode
Il codice valuta del prodotto. - Prezzo
Il valore del prodotto. - Categorie
La categoria del prodotto. - Scontato
(True or False) Se è stato applicato uno sconto al prodotto. - Quantità
La quantità rappresentata da questo evento: 1 per gli acquisti in unità intere oppure la quantità ordinata per i prodotti venduti in quantità frazionate. - Valore
Il valore del prodotto. - ProductID
L'ID del prodotto. - RootProductID
L’ID del prodotto principale. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
La metrica Prodotto ordinato ha una serie di altri campi dati disponibili per il tracciamento. Visualizza i dati non elaborati di un singolo evento Ordered Product per vedere tutti i dati disponibili per questo evento.
Ordine effettuato
Questo evento viene tracciato quando una persona effettua un ordine.
- CategorieProdotto
Le categorie dei prodotti nell'ordine. - Valore
Il valore dell'ordine. - Scontato
Se l'ordine è scontato o meno. - NomiProdotti
I nomi dei prodotti nell’ordine. - ItemCount
Il numero di righe dell’ordine, non la quantità totale di unità. - OrderCurrencyCode
Il codice valuta utilizzato con l'ordine. - ID regole prezzo carrello
Un array di ID regole prezzo carrello (stringhe di ID numerici) che include le regole applicate automaticamente e la regola per un coupon applicato. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
Ordine rimborsato
Questo evento viene attivato quando lo stato di un ordine viene chiuso in Magento 2. Un rimborso parziale che lascia l’ordine in un altro stato non attiva Ordine rimborsato tramite la mappatura standard degli stati.
- Valore
Il valore dell'ordine. - Scontato
Se l'ordine è scontato o meno. - NomiProdotti
I nomi di tutti i prodotti nell’ordine. - ItemCount
Il numero di righe dell’ordine, non la quantità totale di unità. - OrderCurrencyCode
Il codice valuta utilizzato con l'ordine. - CategorieProdotto
Le categorie dei prodotti nell'ordine. - ID regole prezzo carrello
Un array di ID regole prezzo carrello (stringhe di ID numerici) che include le regole applicate automaticamente e la regola per un coupon applicato. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
Pagamento avviato
Questo evento si attiva quando un cliente con un indirizzo e-mail noto avvia il checkout e il carrello è ancora attivo con degli articoli quando Klaviyo lo sincronizza. In una pagina di checkout standard, il cliente inserisce le informazioni di contatto e di spedizione e fa clic su Continua. Se completa il checkout prima che il carrello venga sincronizzato, Klaviyo salta Started Checkout e registra Placed Order quando l’ordine viene sincronizzato, a meno che il suo stato non venga ignorato. Il completamento di un ordine non rimuove un evento Checkout avviato che è già stato sincronizzato.
- Valore
Il valore dell’ordine durante il checkout. - ItemCount
Il numero di voci di riga nel carrello, non la quantità totale di unità. - Articoli
Gli articoli nell'ordine. - CategorieProdotto
Le categorie dei prodotti nell'ordine. - NomiProdotti
I nomi dei prodotti nell’ordine. - NomeNegozio
Il nome del negozio in cui è stato avviato l'ordine. - ID negozio
L'ID del negozio in cui è stato avviato l'ordine. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo.
Aggiunto al carrello
Tieni presente che questa metrica viene tracciata solo se utilizzi la versione 4.0.0 e successive dell'estensione Klaviyo. Questa metrica viene tracciata quando un cliente per cui Klaviyo ha impostato un cookie aggiunge un articolo al carrello.
Include informazioni dettagliate sull'articolo aggiunto. È utile quando crei segmenti in base ai prodotti che gli utenti hanno aggiunto al carrello o quando crei un flusso per carrello abbandonato. Puoi filtrare e targetizzare le metriche Added To Cart in base ai seguenti criteri:
- MaskedQuoteId
MaskedQuoteId o identificatore univoco per i clienti che hanno effettuato l’accesso. - CategorieArticoliAggiunti
Le categorie a cui appartiene l’articolo. - AddedItemProductName
Il nome del prodotto nel tuo negozio (ad esempio, maglietta rossa). - AddedItemDescription
la descrizione dell'articolo. - AddedItemImageURLKey
L'URL dell'immagine dell'articolo. - AddedItemPrice
Il prezzo dell’articolo. - AddedItemProductID
L’ID personalizzato del prodotto nel tuo negozio Magento 2, ad esempio 1234. - AddedItemSKU
Lo SKU dell’articolo nel tuo negozio (ad es. REDMEDIUMTSHIRT). - AddedItemURL
L’URL dell’articolo. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo. - integration_key
La tua piattaforma e-commerce (Magento 2).
Usa il valore MaskedQuoteId dell’evento Added To Cart per creare un link che ricostruisce il carrello del cliente quando torna da un’e-mail su un altro dispositivo. Usa il seguente URL:
{{ organization.url|trim_slash }}/reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}Prodotto visualizzato
Questa metrica viene tracciata quando un cliente che Klaviyo è in grado di identificare visualizza un prodotto sul tuo sito. Puoi filtrare e targetizzare le metriche Viewed Product in base ai seguenti criteri:
- ProductID
L'ID del prodotto. - Nome
Il nome del prodotto. - SKU
Lo SKU del prodotto. - URL
L'URL del prodotto. - Prezzo
Il prezzo del prodotto. - FinalPrice
Il prezzo finale dopo eventuali sconti. - Categorie
Un array contenente le categorie a cui appartiene il prodotto. - URL immagine
L'URL dell'immagine del prodotto. - external_catalog_id
Utilizzato nell'organizzazione del catalogo in Klaviyo. - integration_key
La tua piattaforma e-commerce (Magento 2).
Attivo sul sito
Questa metrica viene monitorata quando un cliente che Klaviyo riesce a identificare è attivo sul tuo sito. Puoi usare l’attività Active on Site nei segmenti e nei flussi, ma le proprietà evento riportate di seguito non sono disponibili per i filtri dei segmenti o del flusso. Puoi esaminarli nei dati non elaborati dell’evento:
- utm_medium
Il mezzo per il parametro di tracciamento UTM (ad esempio, campaign). - kx_present
Vero quando il parametro kx è presente nell’URL. Il campo viene omesso quando il parametro è assente. - os
Il sistema operativo del dispositivo dell'utente. - initial_page_path
Il percorso URL della pagina iniziale su cui è arrivato l'utente. - browser
Il tipo di browser dell'utente. - pagina
L'URL della pagina su cui l'utente era attivo. - utm_campaign
Il parametro di tracciamento UTM per la campagna. - utm_source
La sorgente UTM (ad es. Klaviyo).
Dati del cliente sincronizzati
Klaviyo crea o aggiorna i profili a partire da ordini sincronizzati, record dei clienti e checkout avviati. Le seguenti informazioni vengono aggiunte quando sono disponibili nei dati di origine:
- Nome e cognome
- Città, provincia/regione, CAP, Paese
- Numero di telefono
- Account Magento creato (ad es., YYYY-mm-dd hh:mm:ss; 2015-05-21 13:04:00)
- Gruppo clienti Magento (ad esempio, all’ingrosso)
- Negozio Magento (ad es., Negozio USA)
- Data di nascita (ad es., YYYY-mm-dd; 1990-03-25)
- Genere
Se aggiorni il gruppo di clienti in Magento 2, anche dopo che il profilo originale è stato creato in Klaviyo, il gruppo di clienti verrà aggiornato in Klaviyo.
MagentoWebsiteID viene sincronizzato quando il cliente o l'ordine ha un negozio Magento associato. Le sospensioni non vengono copiate in Klaviyo.
Klaviyo supporta un URL root multimediale personalizzato per le immagini dei prodotti ospitate su un URL di base diverso. Consulta la guida alla configurazione di Magento 2 per le istruzioni di configurazione.
Valore delle entrate
Quando usi la metrica Placed Order di Magento 2 per misurare le entrate, gli ordini annullati e rimborsati non vengono sottratti automaticamente. Questo può far sì che le entrate mostrate in Klaviyo siano diverse dalle entrate mostrate in Magento.
Risorse aggiuntive
- Primi passi con Magento 2.x (CE ed EE)
Scopri come integrare Klaviyo con il tuo negozio Magento 2 CE o EE. Devi installare l'estensione Klaviyo in Magento, configurare l'estensione e configurare OAuth, quindi abilitare l'integrazione in Klaviyo. Questa guida illustra tutti i passaggi di integrazione richiesti e come verificare che la sincronizzazione dello storico dei dati abbia successo.
- Risoluzione dei problemi di integrazione con Magento 2
Scopri come risolvere i problemi della configurazione OAuth di Magento 2 seguendo i passaggi per la risoluzione dei problemi descritti di seguito. Se riscontri ancora problemi dopo aver eseguito questi passaggi, contattaci nella nostra Community o il nostro team di assistenza.