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, con una descrizione dei campi sottostanti. Ogni riga del file CSV deve rappresentare un'azione o un'attività svolta da qualcuno, come ad esempio "Ha acquistato un prodotto" o "Si è iscritto a un webinar." Se hai più azioni da tracciare, dovresti caricarle come file CSV separati. Email L'indirizzo deve essere il primo quando carichi il tuo 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 identificativo unico per l'evento. In pratica, dovresti inviare un $event_id se hai un identificatore unico per ogni evento (ad esempio, un ID ordine). Dovresti anche impostare il $event_id se ti aspetti che alcuni eventi si verifichino nello stesso momento. Questo può accadere quando qualcuno compie un'azione che tu split trasformerai in più eventi. Ad esempio, se qualcuno acquista più articoli, potresti voler registrare un evento per ogni articolo acquistato.
  
  Nei due set di dati di esempio qui sotto c'è un evento di ordine effettuato e 3 eventi di prodotto ordinato (1 per ogni prodotto dell'ordine effettuato). Tutti questi eventi hanno lo stesso timestamp, ma saranno tutti importati perché hanno un $event_id unico. Se gli $event_id sono identici, o se sono assenti, solo uno degli eventi verrà importato e gli altri verranno 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 tuoi dati, vai su Klaviyo. 

1. In Klaviyo, seleziona la scheda Integrazioni.
2. Seleziona Gestisci fonti > importa via CSV.
3. Ti verrà chiesto di caricare il tuo file CSV, quindi clicca su Avanti.
4. Avrai la possibilità di dare un nome all'evento. Se stai cercando di mappare i dati importati su un evento metrico già esistente nel tuo account, assicurati di digitare il nome dell'evento esattamente come appare già.
5. Dopo aver dato un nome al tuo evento, puoi visualizzare l'anteprima dei dati qui sotto.
6. Quando sei pronto per importare i tuoi dati, clicca su Avanti. Il tuo file inizierà ad essere elaborato e potrai navigare fuori dalla pagina. 

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

Se stai caricando dei dati di acquisto, dovrai 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 sarà un evento per l'ordine effettuato e poi eventi separati per ogni prodotto ordinato. Ecco come dovrebbero essere 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 del tuo elenco. Raccomandiamo vivamente di iniziare l'importazione di qualsiasi elenco almeno 24 ore prima di averne bisogno per una determinata campagna, per garantire che il processo di importazione non ritardi il tuo 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 il riferimento delle proprietà del profilo e dell'evento
• Formattazione delle date per i file CSV
• Migrare a Klaviyo