Riferimento dati Magento 1

Imparerai

Scopra quali dati di Magento 1 vengono importati in Klaviyo quando si integrano le due piattaforme. L'integrazione di Klaviyo con Magento raccoglie tutti i dati storici del suo negozio Magento al momento della sincronizzazione storica iniziale. Una volta attivata, l'integrazione inizierà a sincronizzare le metriche e i dati dei clienti quasi in tempo reale. Esempi di questi dati sono le informazioni associate agli ordini effettuati in passato, agli ordini evasi, ecc.

In Klaviyo, può navigare nella scheda Analytics del suo account nella barra laterale sinistra per visualizzare tutte le metriche del suo account; le metriche con un'icona Magento sono quelle sincronizzate dalla sua integrazione Magento.

Metriche di Magento

Ordine annullato

Questo evento viene rilevato quando un cliente crea un ordine nel suo negozio Magento, ma poi annulla l'ordine prima dell'evasione. Klaviyo tiene traccia dei dati associati, comprese tutte le informazioni sui prodotti acquistati. Le informazioni sui prodotti includono nomi di prodotti, immagini e informazioni sulle varianti che può utilizzare nelle e-mail di follow-up degli acquisti.

Può filtrare e indirizzare gli eventi Ordine annullato in base ai seguenti criteri:

• Valore: Valore totale dell'ordine (sub-totale + spese di spedizione - eventuali sconti).
• Articoli: I nomi dei prodotti nell'ordine di una persona.
  es: maglietta o pantaloni. In caso di ordine multiplo, verranno visualizzati più articoli dello stesso tipo.
• Categorie di articoli: L'insieme completo delle categorie degli articoli nell'ordine di una persona; (ad esempio, magliette, uomo, pantaloni e vendita).
• 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 esempio, USD, EUR).
• Scontato: Se questo articolo specifico ha uno sconto applicato (cioè, vero/falso).
• Coupon: Il codice coupon applicato.
• Articoli unici: Il singolo articolo incluso in un ordine (ad esempio, magliette, pantaloncini). Se vengono ordinati più prodotti, l'articolo unico verrà visualizzato solo una volta.
• Categorie di articoli unici: Le categorie in cui sono raggruppati gli articoli unici (ad esempio, uomo, vendita).
• Attributi (opzionale): Attributi personalizzati del prodotto.

Checkout completato

Questo evento viene rilevato quando un cliente completa il checkout nel suo negozio Magento. L'evento Checkout Completato non si sincronizza storicamente, quindi non è sempre una misura accurata quando si guarda al totale degli eventi nel tempo. Per il monitoraggio delle entrate e la segmentazione, utilizzi l'evento Ordine effettuato.

Può filtrare e indirizzare gli eventi Checkout Completato in base ai seguenti criteri:

• Valore: Il valore totale dell'ordine. 
• Codici sconto: Qualsiasi coupon o codice sconto applicato.
• Articoli: I nomi dei prodotti nel carrello di una persona (ad esempio, maglietta o pantaloni).
• Conteggio articoli: La quantità totale di articoli nel carrello di una persona.
• Totale sconti (opzionale): Valore totale in dollari di eventuali coupon o sconti.

Il checkout è iniziato

Questo evento viene tracciato quando un cliente inserisce i suoi dati di contatto e di spedizione nella prima pagina del processo di checkout di Magento e poi clicca su Continua. Klaviyo tiene traccia dei dati relativi agli articoli presenti nel carrello di una persona, compresi i nomi dei prodotti, le immagini e le informazioni sulle varianti, che può utilizzare nelle e-mail sui carrelli abbandonati. Questo evento ha una proprietà URL di checkout che rimanda al carrello esatto di ogni cliente e che può essere utilizzata per ricostruire il carrello se un cliente apre l'e-mail da un nuovo dispositivo.

Può filtrare e indirizzare gli eventi Checkout Started in base ai seguenti criteri:

• Valore: Il valore del carrello al momento del checkout (sub-totale + spese di spedizione - eventuali sconti).
• Articoli: I nomi dei prodotti nel carrello di una persona (ad esempio, maglietta o pantaloni).
• Conteggio articoli: La quantità totale di articoli nel carrello di una persona.
• Codici sconto (opzionale): Eventuali coupon o codici sconto applicati.
• Totale sconti (opzionale): Valore totale in dollari di eventuali coupon o sconti.

Ordine evaso

Questo evento viene rilevato quando contrassegna un ordine nel suo negozio Magento come spedito. Klaviyo tiene traccia delle informazioni relative agli articoli acquistati, compresi i nomi dei prodotti, le immagini e le informazioni sulle varianti, che possono essere utilizzate nelle e-mail di follow-up dell'acquisto.

Può filtrare e indirizzare gli eventi Ordine evaso in base ai seguenti criteri:

• Valore: Valore totale dell'ordine (sub-totale + spese di spedizione - eventuali sconti).
• Articoli: I nomi dei prodotti nell'ordine di una persona (ad esempio, maglietta o pantaloni). Se l'ordine è multiplo, appariranno multipli dello stesso articolo. 
• Categorie di articoli: L'insieme completo delle categorie degli articoli nell'ordine di una persona (ad esempio, magliette, uomo, pantaloni e vendita).
• 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 esempio, USD, EUR).
• Scontato: Se questo articolo specifico ha uno sconto applicato (cioè, vero/falso).
• 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 di articoli unici: Le categorie in cui sono raggruppati gli articoli unici (ad esempio, uomo, vendita).
• Attributi (opzionale): Attributi personalizzati del prodotto.

Prodotto ordinato

Questo evento viene tracciato quando un cliente effettua un ordine. Viene tracciato un evento Prodotto ordinato per ogni articolo acquistato. Ad esempio, se qualcuno acquista una maglietta e un paio di pantaloni, viene tracciato un evento Ordine effettuato e vengono registrati due eventi Prodotto ordinato: un evento per la maglietta e un evento per i pantaloni.

L'evento Prodotto ordinato include informazioni dettagliate su ogni prodotto acquistato. Questo è utile per creare segmenti comportamentali basati su opzioni di varianti di prodotto e altre informazioni dettagliate che non sono disponibili nell'evento Ordine effettuato. Può filtrare e indirizzare gli eventi Prodotto ordinato in base ai seguenti criteri:

• Valore: Prezzo totale dell'articolo (non include le spese di spedizione o eventuali sconti).
• Nome: Il nome dato a questo articolo specifico.
• SKU: Lo SKU specifico assegnato per tracciare un articolo (ad esempio, REDMEDIUMTSHIRT).
• Categorie: L'insieme completo delle collezioni dei prodotti nell'ordine di qualcuno (ad esempio, magliette, uomo, pantaloni e vendita).
• Prezzo: Il valore in dollari del prodotto specifico (ad esempio, camicie 25.50, scarpe 50.25).
• Costo: Il costo per realizzare un prodotto (ad esempio, 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 questo articolo specifico ha uno sconto applicato (cioè, vero o falso).
• ProductID: ID di un prodotto specifico nel suo negozio.
• Quantità: Quantità ordinata.
• Attributi (opzionale): Attributi personalizzati del prodotto.

Ordine effettuato

Questo evento viene rilevato quando un cliente completa il processo di checkout e crea un ordine nel suo negozio Magento. Klaviyo tiene traccia dei dati correlati, comprese le informazioni sui prodotti acquistati, inclusi i nomi dei prodotti, le immagini e le informazioni sulle varianti, che può utilizzare nelle e-mail di follow-up dell'acquisto. Può filtrare e indirizzare gli eventi di Ordine piazzato in base ai seguenti criteri:

• Valore: Valore totale dell'ordine (sub-totale + spedizione - eventuali sconti).
• Articoli: I nomi dei prodotti nell'ordine di una persona, ad esempio: maglietta o pantaloni. In caso di ordini multipli, verranno visualizzati più articoli dello stesso tipo. 
• Categorie di articoli: L'insieme completo delle categorie degli articoli nell'ordine di una persona (ad esempio, magliette, uomo, pantaloni e vendita).
• 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 esempio, USD, EUR).
• Scontato: Se questo articolo specifico ha uno sconto applicato (cioè, vero/falso).
• Coupon: Il codice coupon applicato.
• Articoli unici: Il singolo articolo creato in un ordine (ad esempio, camicie, pantaloncini). Se vengono ordinati più prodotti, l'articolo unico verrà visualizzato solo una volta.
• Categorie di articoli unici: Le categorie in cui sono raggruppati gli articoli unici (ad esempio, uomo, vendita).
• Attributi (opzionale): È possibile sincronizzare fino a 10 attributi di prodotto personalizzati per gli ordini effettuati Questa sincronizzazione deve essere attivata prima che i dati degli attributi personalizzati confluiscano nel suo account Klaviyo. Veda la sezione sottostante su come impostarlo.

Ordine rimborsato

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

• Valore: Valore totale dell'ordine (sub-totale + spedizione - eventuali sconti).
• Coupon: Il codice coupon applicato.
• 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 (cioè, vero/falso).
• Categorie di articoli: L'insieme completo delle categorie degli articoli nell'ordine di una persona (ad esempio, magliette, uomo, pantaloni e vendita).
• Conteggio articoli: Il numero di articoli nell'ordine (ad esempio, 2).
• Articoli: I nomi dei prodotti nell'ordine di una persona (ad esempio, maglietta o pantaloni). In caso di ordini multipli, verranno visualizzati più articoli dello stesso tipo.
• Categorie di articoli unici: Le categorie in cui sono raggruppati gli articoli unici (ad esempio, uomo, vendita).
• Articoli unici: Il singolo articolo creato in un ordine, ad esempio: camicie, pantaloncini .Se vengono ordinati più prodotti, l'articolo unico verrà visualizzato solo una volta.

Le entrate, o il valore dell'ordine, sono calcolate come segue: (prezzo degli ordini + spedizione - sconti). Per filtrare un segmento in base a $valore, filtrare il segmento usando Revenue.

Il pagamento è disponibile come proprietà di secondo livello sotto il campo extra. Non può filtrare le proprietà di secondo livello per la segmentazione, ma può utilizzare questi dati come variabile di evento nei suoi modelli e-mail.

Dati dei clienti sincronizzati

Klaviyo crea un contatto a partire 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 popolerà questo profilo con le seguenti informazioni:

• Email
• Nome e cognome
• Città, Stato/Regione, Codice postale, Paese
• Numero di telefono
• Account Magento creato (ad esempio, 2015-05-01 00:00:00)
• Gruppo di clienti Magento (ad esempio, Wholesale)
• Magento Store (ad esempio, US Store)
• Data di nascita (ad esempio, 1990-01-01)
• Genere
• il sito web_ID non verrà estratto
• Le soppressioni non vengono copiate in Klaviyo, quindi non saranno presenti nella piattaforma Klaviyo.

Se aggiorna il gruppo clienti in Magento, anche dopo che il profilo originale è stato creato in Klaviyo, il gruppo clienti si aggiornerà in Klaviyo.

Sincronizza gli attributi dei prodotti personalizzati per gli ordini effettuati

Klaviyo può sincronizzare fino a 10 attributi di prodotto personalizzati per la metrica Ordine effettuato. Gli attributi dei prodotti personalizzati non confluiranno automaticamente in Klaviyo; tuttavia, può richiedere a Klaviyo di inserirli. Per farlo, deve raccogliere l'ID dell'attributo personalizzato (istruzioni qui sotto) e inviare una richiesta al nostro team di assistenza.

Trovi gli ID prodotto personalizzati nel pannello di amministrazione di Magento, accedendo al catalogo > Attributi > Gestisci attributi e cliccando sull'attributo.

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

Verifichi i dati degli ordini sincronizzati

Klaviyo importa tutti i dati di Magento. Per verificarlo, può confrontare il numero di ordini in un determinato giorno con quello presente nell'interfaccia di Magento e confermare che corrispondono. Clicchi su Analytics nella barra laterale sinistra, trovi la metrica Ordine effettuato e ci clicchi sopra. Questo la porterà alla pagina del grafico metrico e mostrerà gli ultimi 30 giorni di dati per impostazione predefinita. Può vedere un esempio del grafico metrico visualizzato qui sotto.

Passi il mouse sul punto dati di ieri o guardi nella tabella dei dati sotto il grafico per vedere quanti ordini ha avuto ieri. Confronti questo numero con quello memorizzato in Magento e vedrà che corrispondono esattamente. Se non lo fanno, il problema più probabile è che il fuso orario del suo account Klaviyo non corrisponde a quello di Magento. Per verificare l'impostazione del fuso orario:

1. Fai clic sul nome della tua organizzazione in basso a sinistra.
2. Clicchi su Impostazioni.
3. Selezionare l' organizzazione.

Potrebbe notare che il valore di Revenue sulla sua dashboard Klaviyo non corrisponde sempre al valore delle entrate che vede in Magento; questo perché Klaviyo non sottrae gli ordini cancellati e rimborsati dal nostro calcolo delle entrate.

// 
// ORDINE EFFETTUATO
// ------------------------------------------

{
  "token": "PUBLIC_API_KEY",
  "servizio": "magento",
  "evento": "Ordine effettuato",
  "customer_properties": {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "proprietà": {
   "$event_id": "1234",
   "$valore": 29.98,
   "$extra": {},
   "Codice valuta": "USD",
   "Conteggio articoli": 2,
   "Articoli": ["Winnie the Pooh, "Racconto di due città"], // Se un articolo viene ordinato più di una volta, lo duplica. Ad esempio, se qualcuno ordina due magliette, il risultato sarebbe: ["T-Shirt", "T-Shirt"]
   "Scontato": vero,
   "Coupon": "COUPON123",
   "Articoli unici": ["Winnie the Pooh", "Racconto di due città"],
   "Categorie di articoli": ["Narrativa", "Classici", "Bambini"],
   "Categorie di articoli unici": ["Narrativa", "Classici", "Bambini"]
  },
  "tempo": 1387302423
}

// 
// PRODOTTO ORDINATO
// ------------------------------------------

{
  "token": "PUBLIC_API_KEY",
  "servizio": "magento",
  "evento": "Prodotto ordinato",
  "customer_properties": {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "proprietà": {
   "$event_id": "123456789", // LineId (unico)
   "$valore": 9.99,
   "Codice valuta": "USD",
   "Nome": "Winnie the Pooh",
   "SKU": "WINNIEPOOH,
   "ProductID": "567",
   "Categorie": ["Narrativa", "Classici"],
   "Prezzo": 9.99,
   "Scontato": vero,
   "Costo": 5.00, // (opzionale),
   "Attributo: Colore": "Rosso" // attributi del prodotto (facoltativi)
   "$extra": {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "tempo": 1387302423
}

// 
// ORDINE EVASO
// ------------------------------------------

{
  "token": "PUBLIC_API_KEY",
  "servizio": "magento",
  "evento": "Ordine evaso",
  "customer_properties": {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "proprietà": {
   "$event_id": "1234",
   "$valore": 29.98,
   "$extra": {},
   "Codice valuta": "USD",
   "Conteggio articoli": 2,
   "Articoli": ["Winnie the Pooh, "A Tale of Two Cities"], // Se un articolo viene ordinato più di una volta, duplicarlo. Ad esempio, se qualcuno ordina due magliette, il risultato sarebbe: ["T-Shirt", "T-Shirt"]
   "Scontato": vero,
   "Coupon": "COUPON123",
   "Articoli unici": ["Winnie the Pooh", "Racconto di due città"],
   "Categorie di articoli": ["Narrativa", "Classici", "Bambini"],
   "Categorie di articoli unici": ["Narrativa", "Classici", "Bambini"]
  },
  "tempo": 1387302423
}

Risorse aggiuntive

• Come integrarsi con Magento 1.x (CE ed EE)
• Riferimento ai requisiti del sistema di integrazione Magento