Riferimento dati Magento 1

Cosa imparerai

Scopri quali dati di Magento 1 vengono importati in Klaviyo quando integri le 2 piattaforme. L'integrazione di Klaviyo con Magento importa tutto lo storico dei dati nel tuo negozio Magento al momento della sincronizzazione storica iniziale. Una volta attivata, l'integrazione inizierà a sincronizzare metrica e dati cliente quasi in tempo reale. Esempi di questi dati includono le informazioni associate agli ordini effettuati in passato, agli ordini evasi, ecc.

In Klaviyo, puoi accedere alla scheda Analisi del tuo account nella barra laterale sinistra per visualizzare tutte le metriche del tuo account; le metriche con un’icona Magento sono quelle sincronizzate dalla tua integrazione Magento.

Metriche di Magento

Ordine annullato

Questo evento viene tracciato quando un cliente crea un ordine nel tuo negozio Magento, ma poi annulla l’ordine prima dell’evasione. Klaviyo traccia i dati associati, incluse tutte le informazioni sui prodotti relative agli articoli acquistati. Le informazioni sui prodotti includono nomi dei prodotti, immagini e informazioni sulla variante che puoi utilizzare nelle e-mail di follow-up dell’acquisto.

Puoi filtrare e targetizzare gli eventi Canceled Order in base ai seguenti criteri:

• Valore: valore totale dell’ordine (subtotale + costo di spedizione - eventuali sconti).
• Elementi: i nomi dei prodotti nell'ordine di una persona.
  es.: t-shirt o pantaloni. Se ordinato più volte, mostrerà più occorrenze dello stesso articolo
• Categorie degli articoli: L'insieme completo delle categorie degli articoli nell'ordine di una persona; (ad esempio t-shirt, uomo, pantaloni e saldi).
• Conteggio articoli: il numero di articoli nell’ordine (ad esempio, 2).
• Codice valuta: la valuta specifica pagata per un articolo in base al paese (ad es., USD, EUR).
• Scontato: se a questo articolo specifico è applicato uno sconto (cioè true/false).
• Coupon: il codice coupon applicato.
• Articoli unici: il singolo articolo incluso in un ordine (ad es. magliette, pantaloncini). Se vengono ordinati più prodotti, l’articolo unico verrà visualizzato una sola volta.
• Categorie di articoli univoche: le categorie in cui sono raggruppati gli articoli univoci (ad es. uomo, saldi).
• Attributi (facoltativi): Attributi personalizzati del prodotto.

Pagamento completato

Questo evento viene tracciato quando un cliente completa il checkout nel tuo negozio Magento. Storicamente, l'evento Checkout Completed non viene sincronizzato, quindi non è sempre una misura accurata quando si guardano i totali degli eventi nel tempo. Per il tracciamento dei ricavi e la segmentazione, usa l'evento Ordine effettuato.

Puoi filtrare e targetizzare gli eventi Checkout Completed in base ai seguenti criteri:

• Valore: Il valore totale dell'ordine.
• Codici sconto: qualsiasi coupon o codice sconto applicato.
• Items: i nomi dei prodotti nel carrello di qualcuno (ad es., t-shirt o pants).
• Numero di articoli: la quantità totale di articoli nel carrello di una persona.
• Sconti totali (facoltativo): valore totale in dollari di eventuali coupon o sconti.

Pagamento iniziato

Questo evento viene tracciato quando un cliente inserisce le informazioni di contatto e di spedizione nella prima pagina della procedura di pagamento di Magento e poi fa clic su continua. Klaviyo tiene traccia dei dati prodotto correlati sugli articoli nel carrello di una persona, inclusi nomi prodotto, immagini e informazioni sulla variante, che puoi usare nelle tue e-mail di carrello abbandonato. Questo evento ha una proprietà URL del checkout che rimanda al carrello esatto di ogni cliente e che può essere usata per ricostruire il carrello se un cliente apre l’e-mail da un nuovo dispositivo.

Puoi filtrare e targetizzare gli eventi Checkout Started in base ai seguenti criteri:

• Valore: il valore del carrello al momento del checkout (subtotale + costo di spedizione - eventuali sconti).
• Items: i nomi dei prodotti nel carrello di qualcuno (ad es., t-shirt o pants).
• Numero di articoli: la quantità totale di articoli nel carrello di una persona.
• Codici sconto (facoltativo): eventuali coupon o codici sconto applicati.
• Sconti totali (facoltativo): valore totale in dollari di eventuali coupon o sconti.

Ordine evaso

Questo evento viene tracciato quando contrassegni un ordine nel tuo negozio Magento come spedito. Klaviyo traccia le informazioni sui prodotti correlati relative agli articoli acquistati da qualcuno, inclusi nomi dei prodotti, immagini e informazioni sulla variante, che possono essere usate nelle e-mail di follow-up post-acquisto.

Puoi filtrare e targetizzare gli eventi Fulfilled Order in base ai seguenti criteri:

• Valore: valore totale dell’ordine (subtotale + costo di spedizione - eventuali sconti).
• Items: I nomi dei prodotti nell'ordine di qualcuno (ad esempio t-shirt o pantaloni). Se ordinato più volte, appariranno più occorrenze dello stesso articolo.
• Categorie articolo: L'insieme completo delle categorie degli articoli nell'ordine di una persona (ad esempio t-shirt, uomo, pantaloni e saldi).
• Numero di articoli: il numero di articoli nell'ordine. (ad es., 2).
• Codice valuta: la valuta specifica pagata per un articolo in base al paese (ad es., USD, EUR).
• Scontato: se a questo articolo specifico è applicato uno sconto (cioè true/false).
• Coupon: il codice coupon applicato.
• Articoli unici: l’articolo singolo creato in un ordine (ad esempio, magliette, shorts). Se vengono ordinati più prodotti, l’articolo unico verrà mostrato una sola volta.
• Categorie di articoli univoche: le categorie in cui sono raggruppati gli articoli univoci (ad es. uomo, saldi).
• Attributi (facoltativi): Attributi personalizzati del prodotto.

Prodotto ordinato

Questo evento viene tracciato quando un cliente effettua l'ordine. Viene tracciato un evento Ordered Product per ogni articolo acquistato. Ad esempio, se qualcuno acquista una t-shirt e un paio di pantaloni, viene tracciato un evento Placed Order e vengono registrati due eventi Ordered Product: uno per la t-shirt e uno per i pantaloni.

L'evento Ordered Product include informazioni dettagliate su ciascun prodotto acquistato da un utente. Ciò è utile quando crei segmenti comportamentali basati sulle opzioni della variante del prodotto e su altre informazioni dettagliate che non sono disponibili nell'evento Placed Order. Puoi filtrare e targetizzare gli eventi Ordered Product in base ai seguenti criteri:

• Valore: prezzo totale dell'articolo (non include i costi di spedizione né eventuali sconti applicati).
• Nome: il nome assegnato a questo elemento specifico.
• SKU: lo SKU specifico assegnato per tracciare un articolo (ad esempio, REDMEDIUMTSHIRT).
• Categorie: L'insieme completo delle raccolte dei prodotti nell'ordine di una persona (ad esempio t-shirt, uomo, pantaloni e saldi).
• Prezzo: il valore in dollari del prodotto specifico (ad esempio magliette 25,50, scarpe 50,25).
• Costo: Il costo per realizzare un prodotto (ad es. camicie 13,85, scarpe 20,00).
• Codice valuta: la valuta specifica pagata per un articolo in base al paese (ad esempio, USD, EUR).
• Scontato: se a questo articolo specifico è stato applicato uno sconto (ovvero true o false).
• ProductID: ID del prodotto specifico nel tuo negozio.
• Quantità: Quantità ordinata.
• Attributi (facoltativi): Attributi personalizzati del prodotto.

Ordine effettuato

Questo evento viene tracciato quando un cliente completa il processo di checkout e crea un ordine nel tuo negozio Magento. Klaviyo traccia i dati correlati, incluse le informazioni sul prodotto degli articoli acquistati, come nomi dei prodotti, immagini e informazioni sulla variante, che puoi usare nelle e-mail di follow-up post-acquisto. Puoi filtrare e targetizzare gli eventi Placed Order in base ai seguenti criteri:

• Valore: valore totale dell'ordine (subtotale + spedizione - eventuali sconti).
• Articoli: i nomi dei prodotti nell'ordine di qualcuno, ad esempio t-shirt o pantaloni. Se ordinato più volte, verranno mostrati più esemplari dello stesso articolo.
• Categorie articolo: l'insieme completo delle categorie degli articoli nell'ordine di qualcuno (ad esempio magliette, articoli da uomo, pantaloni e saldi).
• Conteggio articoli: il numero di articoli nell'ordine (ad es., 2).
• Codice valuta: la valuta specifica pagata per un articolo in base al Paese (ad es., USD, EUR).
• Scontato: se a questo articolo specifico è applicato uno sconto (cioè true/false).
• Coupon: il codice coupon applicato.
• Articoli unici: il singolo articolo creato in un ordine (ad esempio, magliette, pantaloncini). Se vengono ordinati più prodotti, l’articolo unico verrà visualizzato solo una volta.
• Categorie univoche degli articoli: le categorie in cui sono raggruppati gli articoli univoci (ad esempio uomo, saldi).
• Attributi (facoltativo): è possibile sincronizzare fino a 10 attributi prodotto personalizzati per gli ordini effettuati. Questa sincronizzazione deve essere abilitata prima che i dati degli attributi personalizzati confluiscano nel tuo account Klaviyo. Consulta la sezione seguente su come configurarlo.

Ordine rimborsato

Questo evento viene tracciato quando un ordine viene rimborsato in Magento.

• Valore: valore totale dell'ordine (subtotale + spedizione - eventuali sconti).
• Coupon: il codice coupon applicato.
• Codice valuta: la valuta specifica pagata per un articolo in base al Paese (ad es., USD, EUR).
• Scontato: se a questo articolo specifico è stato applicato uno sconto (ovvero true/false).
• Categorie articolo: l'insieme completo delle categorie degli articoli nell'ordine di qualcuno (ad esempio magliette, articoli da uomo, pantaloni e saldi).
• Numero di articoli: Il numero di articoli nell'ordine (ad esempio, 2).
• Items: I nomi dei prodotti nell'ordine di qualcuno (ad esempio t-shirt o pantaloni). Se ordinato più volte, verranno mostrati più esemplari dello stesso articolo.
• Categorie di articoli uniche: le categorie in cui sono raggruppati gli articoli unici (ad es., uomo, saldi).
• Articoli univoci: Il singolo articolo creato in un ordine, ad es.: camicie, pantaloncini. Se vengono ordinati più prodotti, l'articolo univoco verrà visualizzato una sola volta.

Le entrate, o il valore di Ordine effettuato, vengono calcolate come segue: (prezzo degli ordini + spedizione - sconti). Per filtrare un segmento in base a $value, filtra il segmento usando Entrate.

Pagamento è disponibile come proprietà di secondo livello nel campo extra. Non puoi filtrare le proprietà di secondo livello per la segmentazione, ma puoi usare questi dati come variabile evento nei tuoi modelli e-mail.

Dati del cliente sincronizzati

Klaviyo crea un contatto dalla creazione di un ordine esistente, di un record cliente esistente o quando viene avviato un checkout. Klaviyo creerà un nuovo profilo Klaviyo per ogni contatto sincronizzato e compilerà questo profilo con le seguenti informazioni:

• E-mail
• Nome e cognome
• Città, provincia/regione, CAP, Paese
• Numero di telefono
• Account Magento creato (ad esempio 2015-05-01 00:00:00)
• Gruppo clienti Magento (ad esempio, all’ingrosso)
• Negozio Magento (ad es., Negozio USA)
• Data di nascita (ad es. 1990-01-01)
• Genere
• website_ID non verrà importato
• Le sospensioni non vengono copiate in Klaviyo, quindi non saranno presenti nella piattaforma Klaviyo.

Se aggiorni il gruppo clienti in Magento, anche dopo che il profilo originale è stato creato in Klaviyo, il gruppo clienti verrà aggiornato in Klaviyo.

Sincronizza attributi prodotto personalizzati per gli ordini effettuati

Klaviyo può sincronizzare fino a 10 attributi prodotto personalizzati per la metrica Ordine effettuato. Gli attributi prodotto personalizzati non confluiranno automaticamente in Klaviyo; tuttavia, puoi richiedere a Klaviyo di importarli. Per farlo, dovresti raccogliere l’ID dell’attributo personalizzato (istruzioni di seguito) e inviare una richiesta al nostro team di assistenza.

Trova i Custom Product IDs nel pannello Amministratore di Magento andando su Catalog > Attributes > Manage Attributes e facendo clic sull'attributo.

L'ID si trova nell'url in questo modo:

Verifica i dati sugli ordini sincronizzati

Klaviyo importa tutti i tuoi dati Magento. Per verificarlo, puoi confrontare il numero di ordini in un determinato giorno con quello nell'interfaccia di Magento e confermare che corrispondono. Fai clic su Analisi nella barra laterale sinistra, trova la metrica Placed Order e fai clic su di essa. Questo ti porterà alla pagina del grafico della metrica e, per impostazione predefinita, mostrerà gli ultimi 30 giorni di dati. Puoi vedere un esempio del grafico della metrica visualizzato di seguito.

Passa il mouse sul punto dati di ieri oppure guarda la tabella dei dati sotto il grafico per vedere quanti ordini hai avuto ieri. Confronta quel numero con quello memorizzato in Magento e dovresti vedere che corrispondono esattamente. In caso contrario, il problema più probabile è che il fuso orario del tuo account Klaviyo non corrisponde al fuso orario di Magento. Per controllare l'impostazione del fuso orario:

1. Clicca sul nome della tua organizzazione in basso a sinistra.
2. Fai clic su Impostazioni.
3. Seleziona Organizzazione.

Potresti notare che il valore Entrate nel tuo pannello di controllo Klaviyo non corrisponde sempre al valore delle entrate che vedi in Magento; questo perché Klaviyo non sottrae gli ordini annullati e rimborsati dal nostro calcolo delle entrate.

Proprietà per gli ordini Magento sincronizzati

Di seguito sono riportati payload JSON di esempio per le metriche Placed Order, Ordered Product e Fulfilled Order che corrispondono alle proprietà che memorizziamo per gli ordini sincronizzati tramite l'API SOAP di Magento.

Questo è utile per inviare le proprietà corrette per gli ordini che verranno combinati con i dati degli ordini Magento.

Ordine effettuato

// 
// PLACED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Placed Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}

Prodotto ordinato

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Ordered Product",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "123456789", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

Ordine evaso

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Fulfilled Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}

Risorse aggiuntive