Riferimento dati Magento 1

Cosa imparerai

Scopri quali dati sincronizza in Klaviyo la tua integrazione Magento 1 esistente, inclusi ordini storici, record cliente e prodotti. Dopo la sincronizzazione storica iniziale, ordini, clienti e prodotti vengono sincronizzati ogni 30 minuti.

In Klaviyo, vai a Analisi > Metrica nella barra laterale sinistra per visualizzare la metrica del tuo account. Le metriche con un’icona Magento sono sincronizzate dalle tue integrazioni 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.

Questi eventi includono i seguenti dati dell’ordine. Puoi usare le proprietà di primo livello per filtrare e segmentare gli eventi; i dettagli degli attributi in extra sono disponibili per il contenuto dei messaggi.

• Valore: Il totale complessivo dell’ordine da Magento, incluse imposte e spedizione, dopo gli sconti.
• Articoli: i nomi dei prodotti di ciascun articolo della riga dell'ordine (ad es. maglietta o pantaloni). Un nome può comparire più di una volta se compare in articoli separati della riga.
• Categorie degli articoli: le categorie dei prodotti nell'ordine (ad es. magliette, articoli da uomo, pantaloni e saldi).
• Numero di articoli: il numero di righe dell’ordine (ad esempio 2). Non è la somma delle quantità ordinate.
• Codice valuta: il codice valuta per l’ordine (ad es. USD o EUR).
• Scontato: se all'ordine è stato applicato uno sconto (vero o falso).
• Coupon: il codice coupon applicato.
• Articoli unici: i nomi dei prodotti nell'ordine con i duplicati rimossi (ad es. magliette o pantaloncini).
• Categorie di articoli uniche: le categorie dei prodotti nell’ordine, con i duplicati rimossi (ad es. uomo o saldi).
• Attributi (facoltativi): attributi del prodotto nei dettagli dell’articolo in extra. Usa gli eventi Ordered Product per filtrare in base ai singoli attributi del prodotto.

Pagamento completato

Questo evento è tracciato quando un cliente completa una procedura di pagamento nel tuo negozio Magento. Gli eventi Checkout Completed non vengono sincronizzati in modo retroattivo, quindi i relativi totali potrebbero non riflettere tutte le procedure di pagamento passate. Usa gli eventi Placed Order per la reportistica sui ricavi e la segmentazione.

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

Con gli stati dell’ordine standard di Magento, questo evento viene tracciato quando un ordine raggiunge lo stato completato. Klaviyo traccia le informazioni sui prodotti correlati agli articoli che una persona ha acquistato, inclusi nomi dei prodotti, immagini e informazioni sulla variante che puoi usare nelle e-mail di follow-up post-acquisto.

Questi eventi includono i seguenti dati dell’ordine. Puoi usare le proprietà di primo livello per filtrare e segmentare gli eventi; i dettagli degli attributi in extra sono disponibili per il contenuto dei messaggi.

• Valore: Il totale complessivo dell’ordine da Magento, incluse imposte e spedizione, dopo gli sconti.
• Articoli: i nomi dei prodotti di ciascun articolo della riga dell'ordine (ad es. maglietta o pantaloni). Un nome può comparire più di una volta se compare in articoli separati della riga.
• Categorie degli articoli: le categorie dei prodotti nell'ordine (ad es. magliette, articoli da uomo, pantaloni e saldi).
• Numero di articoli: il numero di righe dell’ordine (ad esempio 2). Non è la somma delle quantità ordinate.
• Codice valuta: il codice valuta per l’ordine (ad es. USD o EUR).
• Scontato: se all'ordine è stato applicato uno sconto (vero o falso).
• Coupon: il codice coupon applicato.
• Articoli unici: i nomi dei prodotti nell'ordine con i duplicati rimossi (ad es. magliette o pantaloncini).
• Categorie di articoli uniche: le categorie dei prodotti nell’ordine, con i duplicati rimossi (ad es. uomo o saldi).
• Attributi (facoltativi): attributi del prodotto nei dettagli dell’articolo in extra. Usa gli eventi Ordered Product per filtrare in base ai singoli attributi del prodotto.

Prodotto ordinato

Questo evento viene tracciato quando un cliente effettua l’ordine. Per le quantità in numeri interi, viene tracciato 1 evento Prodotto ordinato per ogni unità acquistata, fino a 100 eventi per riga dell’ordine. Ad esempio, se qualcuno compra una t-shirt e un paio di pantaloni, vengono registrati 1 evento Ordine effettuato e 2 eventi Prodotto ordinato: 1 per la t-shirt e 1 per i pantaloni. Per i prodotti venduti in quantità decimali, Klaviyo registra 1 evento per la voce dell'articolo e include la quantità acquistata.

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: il valore rappresentato da questo evento prima degli sconti, esclusa la spedizione. Per le quantità con numeri interi, si tratta del totale della riga dell’ordine diviso per la sua quantità. Per le quantità decimali, è il totale completo della riga.
• Nome: il nome assegnato a questo elemento specifico.
• SKU: lo SKU assegnato all'articolo (ad es. REDMEDIUMTSHIRT).
• Categories: le categorie di questo prodotto (ad esempio magliette, articoli da uomo, pantaloni e saldi).
• Prezzo: il prezzo unitario del prodotto nella valuta dell’ordine (ad es., camicie 25.50 o scarpe 50.25).
• Costo (facoltativo): il costo del prodotto registrato in Magento, se disponibile (ad es. magliette 13,85 o scarpe 20,00).
• Codice valuta: il codice valuta per l’ordine (ad es. USD o EUR).
• Scontato: se a questo articolo specifico è stato applicato uno sconto (ovvero true o false).
• ProductID: ID del prodotto specifico nel tuo negozio.
• Quantità: la quantità rappresentata da questo evento: 1 per quantità espresse in numeri interi oppure la quantità acquistata per un prodotto venduto in quantità decimali.
• Attributi (facoltativi): Attributi personalizzati del prodotto.

Ordine effettuato

Questo evento viene tracciato quando un cliente completa la procedura di checkout e crea un ordine nel tuo negozio Magento. Klaviyo traccia i dati correlati, incluse le informazioni sui prodotti degli articoli acquistati, come nomi dei prodotti, immagini e informazioni sulla variante, che puoi usare nelle e-mail di follow-up dell’acquisto. Questi eventi Placed Order includono i seguenti dati dell’ordine. Puoi usare le proprietà di primo livello per filtrare e indirizzare gli eventi; i dettagli degli attributi in extra sono disponibili per il contenuto dei messaggi.

• Valore: Il totale complessivo dell’ordine da Magento, incluse imposte e spedizione, dopo gli sconti.
• Articoli: i nomi dei prodotti di ciascun articolo della riga dell'ordine (ad es. maglietta o pantaloni). Un nome può comparire più di una volta se compare in articoli separati della riga.
• Categorie degli articoli: le categorie dei prodotti nell'ordine (ad es. magliette, articoli da uomo, pantaloni e saldi).
• Numero di articoli: il numero di righe dell’ordine (ad esempio 2). Non è la somma delle quantità ordinate.
• Codice valuta: il codice valuta per l’ordine (ad es. USD o EUR).
• Scontato: se all'ordine è stato applicato uno sconto (vero o falso).
• Coupon: il codice coupon applicato.
• Articoli unici: i nomi dei prodotti nell'ordine con i duplicati rimossi (ad es. magliette o pantaloncini).
• Categorie di articoli uniche: le categorie dei prodotti nell’ordine, con i duplicati rimossi (ad es. uomo o saldi).
• Attributi (facoltativi): attributi del prodotto nei dettagli dell’articolo in extra. Usa gli eventi Ordered Product per filtrare in base ai singoli attributi del prodotto. Scopri come rivedere gli attributi personalizzati del prodotto.

Ordine rimborsato

Con gli stati dell’ordine standard di Magento, questo evento viene tracciato quando un ordine raggiunge lo stato chiuso. Il suo valore è il totale complessivo dell’ordine originale, non l’importo di un singolo rimborso.

• Valore: il totale complessivo originale dell’ordine da Magento, incluse imposte e spedizione dopo gli sconti.
• Coupon: il codice coupon applicato.
• Codice valuta: il codice valuta per l’ordine (ad es. USD o EUR).
• Scontato: se all'ordine è stato applicato uno sconto (vero o falso).
• Categorie degli articoli: le categorie dei prodotti nell'ordine (ad es. magliette, articoli da uomo, pantaloni e saldi).
• Numero di articoli: il numero di righe dell’ordine (ad esempio 2). Non è la somma delle quantità ordinate.
• Articoli: i nomi dei prodotti di ciascun articolo della riga dell'ordine (ad es. maglietta o pantaloni). Un nome può comparire più di una volta se compare in articoli separati della riga.
• Categorie di articoli uniche: le categorie dei prodotti nell’ordine, con i duplicati rimossi (ad es. uomo o saldi).
• Articoli unici: i nomi dei prodotti nell'ordine con i duplicati rimossi (ad es. magliette o pantaloncini).

Il ricavo di Placed Order utilizza il totale complessivo dell’ordine di Magento, incluse imposte e spedizione dopo gli sconti. Per filtrare un segmento in base a $value, usa Revenue.

Pagamento è disponibile come proprietà di secondo livello nel campo extra. Non puoi filtrare le proprietà di secondo livello per la segmentazione, ma puoi utilizzare questi dati come variabile evento nei modelli e-mail del flusso attivato dalla metrica.

Dati del cliente sincronizzati

Klaviyo crea o aggiorna i profili a partire da ordini sincronizzati, record dei clienti e checkout avviati. Le informazioni disponibili su un profilo dipendono dai dati forniti da Magento. Può includere:

• 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
• ID sito web Magento (quando il record cliente include un ID negozio)

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

Rivedi gli attributi personalizzati del prodotto

Gli attributi prodotto personalizzati dipendono dalla configurazione delle integrazioni esistenti. Gli attributi configurati vengono visualizzati sugli eventi Ordered Product come proprietà denominate Attributo: seguite dal codice dell’attributo. I dettagli degli attributi vengono archiviati anche con i singoli articoli in extra sugli eventi order. Il supporto Klaviyo non gestisce più le richieste per abilitare o modificare la sincronizzazione degli attributi di Magento 1. Rivedi i dati evento esistenti per vedere quali attributi sono presenti. Puoi trovare informazioni generali sul supporto in Come contattare il supporto.

Per identificare un attributo personalizzato nella configurazione esistente, vai su Catalogo > Attributi > Gestisci attributi nel pannello di amministrazione Magento e fai clic sull’attributo.

Trova l'ID attributo nell'URL, come mostrato di seguito.

Verifica i dati sugli ordini sincronizzati

Per verificare gli ordini sincronizzati, confronta il numero di eventi Placed Order per una giornata completata con gli ordini in Magento per la stessa giornata e gli stessi store. Lascia terminare la sincronizzazione storica e la sincronizzazione più recente di 30 minuti prima di confrontare i conteggi.

1. Vai a Analytics > Metriche e seleziona la metrica Magento Ordine effettuato.
2. Imposta Intervallo di date in modo da includere il giorno che vuoi confrontare. Imposta Visualizza per su Giornaliero e Misurazione su Totale. Rimuovi qualsiasi Filtro che escluderebbe gli ordini dal confronto.
3. Passa il cursore sul punto dati del giorno oppure leggi il valore nella tabella sotto il grafico. Confronta il conteggio con gli ordini di Magento per lo stesso giorno e gli stessi store.

Se i conteggi differiscono, verifica che entrambi i report utilizzino lo stesso fuso orario e lo stesso ambito del negozio e che la sincronizzazione sia completata. Verifica anche se gli ordini Magento senza corrispondenza sono in attesa di pagamento o non hanno un indirizzo e-mail cliente valido. Per controllare il fuso orario di Klaviyo:

1. Clicca sul nome del tuo account in basso a sinistra.
2. Fai clic su Impostazioni.
3. Seleziona Generale > Account e controlla l’impostazione Fuso orario.
4. Se modifichi il Fuso orario, fai clic su Salva. Per modificare questo valore, ti serve l’autorizzazione per modificare le impostazioni dell’account.

I ricavi degli ordini effettuati in Klaviyo non sottraggono gli ordini annullati o rimborsati. Di conseguenza, possono essere diversi da un report di Magento che sottrae questi ordini.

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.

Usa questi esempi per capire i nomi delle proprietà e la struttura annidata degli eventi sincronizzati. Mostrano il formato legacy del payload degli eventi e non sono istruzioni per inviare richieste alle API attuali di Klaviyo. I valori di esempio sono illustrativi; extra contiene tutti i dettagli dell’ordine per gli eventi a livello di ordine.

Ordine effettuato

{
  "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"
    ],
    "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

{
  "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",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "time": 1387302423
}

Ordine evaso

{
  "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"
    ],
    "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