Come importare manualmente i dati storici degli eventi

Cosa imparerai

Scopra come importare manualmente i dati storici degli eventi in Klaviyo. Sebbene consigliamo di utilizzare le integrazioni create da Klaviyo con piattaforme come Shopify, Magento e BigCommerce, e la nostra API per le integrazioni personalizzate, è anche possibile aggiungere questi dati manualmente. Un esempio comune è l'aggiunta di dati storici sugli acquisti da una precedente piattaforma di e-commerce per la quale Klaviyo non dispone di un'integrazione predefinita.

Tieni presente che c'è un limite di 50 MB per i caricamenti CSV. 

Formatta i suoi dati

Il primo passo è quello di formattare correttamente i dati in un file CSV. Di seguito è riportato un esempio di dati relativi all'Ordine Effettuato, insieme a una descrizione dei campi sottostanti. Ogni riga del suo file CSV deve rappresentare un'azione o un'attività che qualcuno ha svolto. Ad esempio, "Ha acquistato il prodotto" o "Si è iscritto al webinar." Se ha più azioni da tracciare, dovrebbe caricarle come file CSV separati. L'indirizzo e-mail deve essere il primo quando carica il CSV.

Ecco alcuni esempi di CSV di eventi a cui può fare riferimento per la formattazione dei suoi dati.

Campi obbligatori

I due campi obbligatori sono un timestamp per identificare quando si è verificato l'evento e una proprietà del cliente (un'e-mail o un ID univoco) per identificare chi ha eseguito l'azione.

• Timestamp: Un timestamp che indica il giorno e l'ora dell'evento. Il formato è AAAA-MM-GG HH:MM:SS. Ad esempio, le 13.30 del 14 novembre 2012 sarebbero: 2012-11-14 13:30:00.

  Se due o più eventi nel suo file CSV hanno lo stesso timestamp, deve includere un $event_id univoco, altrimenti solo uno degli eventi sarà importato e gli altri saranno saltati. Veda la sezione su $event_id qui sotto.

• Persona/Email o Persona/ID: molto probabilmente, utilizzerà un'e-mail per identificare i suoi clienti. Alcuni clienti utilizzeranno anche un ID univoco. Può utilizzare entrambi, se lo desidera.

Campi opzionali

Ci sono due campi speciali da tenere in considerazione.

• $event_id: Si tratta di un identificatore unico per l'evento. In pratica, dovrebbe inviare un $event_id se dispone di un identificatore unico per ogni evento, ad esempio un ID ordine. Dovrebbe anche impostare il $event_id se si aspetta che alcuni eventi si verifichino nello stesso momento. Questo può accadere quando qualcuno compie un'azione che lei dividerà in più eventi. Per esempio, se qualcuno acquista più articoli e lei vuole registrare un evento per ogni articolo acquistato.
  
  Nei due set di dati di esempio qui sotto c'è un evento di ordine effettuato, insieme a 3 eventi di prodotto ordinato (uno per ogni prodotto dell'ordine effettuato). Tutti questi eventi hanno lo stesso timestamp, ma saranno tutti importati perché ognuno ha un $event_id unico. Se gli $event_id sono identici, o se sono assenti, solo uno degli eventi sarà importato e gli altri saranno saltati.
  
• $valore: Utilizzi questo campo se l'evento che sta importando include un valore. Ad esempio, se sta importando i dati dell'evento Ordine effettuato, ogni ordine avrà un valore. Non è necessario anteporre ai valori un $ o un altro simbolo di valuta.

Se dispone di dati aggiuntivi sulla persona che ha fatto qualcosa, dovrebbe inserirli in una colonna la cui etichetta inizia con Persona// e poi con il tipo di dati che la colonna contiene. Per esempio, se avesse l'azienda o l'organizzazione a cui appartiene ogni persona, vorrebbe etichettare la colonna Persona/Organizzazione. Il prefisso speciale ci permette di sapere di associare i dati di quella colonna a ciascuna persona, piuttosto che all'attività. Le seguenti sono colonne speciali che può utilizzare per aiutarla a identificare le persone:

• Persona//Nome: nome di battesimo
• Persona//Cognome: cognome
• Persona//Telefono: numero di telefono
• Persona/Organizzazione: organizzazione
• Persona/Titolo: titolo del lavoro

Se dispone di dati aggiuntivi su ciascuna azione, può includerli in colonne supplementari con le etichette che desidera. Per esempio, se una persona acquista qualcosa e vuole includere l'articolo che ha comprato, può includere questi dati in una colonna intitolata Articolo acquistato. Di seguito, alcuni esempi.

• Articolo acquistato
• Categoria dell'articolo
• Prodotto
• Posizione

Se non dispone di dati per una determinata colonna, la lasci vuota e noi la ignoreremo. Per esempio, se non conosce l'organizzazione di una persona, può lasciare vuota la colonna Persona/Organizzazione e noi eviteremo di rilevare quella proprietà per quella riga dei suoi dati.

Una volta terminata la formattazione dei dati, li salvi in un file CSV.

Carichi un file CSV di dati

Dopo aver formattato correttamente i suoi dati, vada su Klaviyo e clicchi sul nome del suo account in basso a sinistra, quindi selezioni Integrazioni > Gestire le fonti > Importare via CSV.

Le verrà richiesto di caricare il file CSV, quindi faccia clic su Avanti.

Successivamente, avrà la possibilità di dare un nome all'evento. Se sta cercando di mappare i dati importati a un evento metrico che esiste già nel suo account, si assicuri di digitare il nome dell'evento esattamente come appare già.

Dopo aver dato un nome all'evento, può visualizzare l'anteprima dei dati qui sotto. Quando è pronto per importare i suoi dati, clicchi su Avanti. Il suo file inizierà ad essere elaborato e lei potrà allontanarsi dalla pagina. 

Nota per il negozio e-commerce che carica i dati di acquisto

Se sta caricando i dati di acquisto, dovrà caricare due file: uno per l'ordine complessivo e un secondo che includa i dati articolo per articolo.  Ad esempio, un cliente potrebbe effettuare un ordine per più prodotti. In questo caso, ci sarebbe un evento per l'ordine effettuato e poi eventi separati per ciascuno dei prodotti ordinati. Ecco come dovrebbero apparire le intestazioni di questi file:

Ordine effettuato

Prodotto ordinato

Non utilizziamo il $ come prefisso per i valori degli ordini. Utilizzi solo numeri per indicare il prezzo o il valore di un ordine. Utilizzando l'intestazione $value, i dati verranno inseriti correttamente nel suo account Klaviyo.

Il motivo per includere due metriche è che rende più facile attivare successivamente le e-mail sia in base all'ordine complessivo sia in base a categorie/articoli specifici.

Per gli eventi Prodotto ordinato, $event_id deve essere un identificatore unico per ogni combinazione di ordine e prodotto ordinato. Un modo semplice per creare un identificatore unico è quello di combinare l'ID dell'ordine e l'ID del prodotto, come nell'esempio precedente.

Risoluzione dei problemi dell'import

Di seguito sono riportati alcuni problemi comuni e le soluzioni che può trovare quando importa manualmente i dati storici degli eventi.

La mia importazione sta richiedendo molto tempo

L'importazione può richiedere da 5 minuti a 24 ore, a seconda delle dimensioni della sua lista. Raccomandiamo vivamente di iniziare l'importazione di qualsiasi lista almeno 24 ore prima di averne bisogno per una determinata campagna, per garantire che il processo di importazione non ritardi il suo invio.

Il mio import continua a non funzionare

Se l'importazione non riesce, è probabile che sia dovuta a uno dei seguenti motivi:

• Il suo file è un file .csv? Il suo file deve essere in formato .csv formato. Se tenta di caricare un file Excel o un file .txt l'importazione fallirà.
• Ha formattato correttamente la colonna Timestamp? Deve formattare la data e l'ora come AAAA-MM-GG HH:MM:SS. Ad esempio, le 13.30 del 14 novembre sarebbero: 2012-11-14 13:30:00. Come secondo controllo, apra il suo CSV in un editor di testo per assicurarsi che gli 0 finali nei timestamp non vengano eliminati quando salva o esporta i file CSV. Se sta lavorando con i dati in un foglio elettronico, si assicuri che le celle Timestamp siano impostate sul formato corretto.
  
• Tutte le colonne richieste hanno i dati compilati per ogni riga? Deve avere una colonna con l'etichetta Persona/Email o Persona/ID. Se una di queste colonne ha una riga vuota, l'importazione può fallire.
• La colonna Persona/Email contiene indirizzi e-mail non validi? Se ha dei valori all'interno di Person//Email che non hanno un formato di indirizzo e-mail valido, l'importazione può fallire.
• Tutte le colonne sono etichettate correttamente? Ci sono spazi? Si assicuri che tutte le intestazioni delle colonne corrispondano a quanto indicato in questa guida. Dovrà anche assicurarsi che non ci siano spazi nei nomi delle colonne.

Risorse aggiuntive

• Formati di data e timestamp accettabili per le proprietà del profilo e dell'evento
• Come formattare le date per i file CSV
• Migrare a Klaviyo