Riferimento sulla formattazione delle date per i file CSV
Cosa imparerai
Scopri come modificare le date in Excel e Google Sheets in modo che corrispondano a un formato data supportato in Klaviyo. Questo ti aiuta a evitare errori di formattazione della data quando carichi un CSV con i dati dei clienti.
Quando gestisci un'attività di e-commerce che vende a clienti in tutto il mondo, molti di questi clienti formatteranno le date in modo diverso. Allo stesso modo, quando importi date da un file Excel o Google Sheets, questi sistemi potrebbero riformattare le date in base alle impostazioni predefinite della data. Ad esempio, Excel potrebbe riformattare “March 1, 2020” in “1-Mar”.
Quando importi date per una proprietà del profilo personalizzata, mappa i valori che includono un orario al tipo di dati Date. Se mappi una data senza orario su Date, Klaviyo applica la mezzanotte UTC. Questo può spostare la data del calendario utilizzata da un flusso attivato da una data quando converte il valore nel fuso orario del destinatario o nel fuso orario dell’account, se il fuso orario del destinatario non è disponibile. Per le date senza orario, come i compleanni, seleziona Testo per mantenere la data di calendario prevista.
Formati di data e ora consentiti
Per i valori solo data, usa YYYY-MM-DD o MM/DD/YYYY. Questi formati usano un anno a 4 cifre per evitare ambiguità. Klaviyo legge le date separate da barre come mese/giorno/anno, indipendentemente dalle impostazioni locali del tuo foglio di calcolo. Per le date senza orario, segui le indicazioni di mappatura Testo riportate sopra.
Per gli orari, usa il formato a 24 ore. Quando è mappato su Date, un timestamp senza un offset del fuso orario viene interpretato come UTC. Per specificare un altro fuso orario, includi il relativo offset UTC, ad esempio 2014-09-30 13:34:08-04:00. L’offset +00:00 significa UTC.
Se non includi i secondi nei tuoi timestamp, per impostazione predefinita saranno 0. Ad esempio, un timestamp pari a 2014-09-30 13:34 verrebbe inviato a Klaviyo come 2014-09-30 13:34:00
Gli esempi seguenti mostrano i formati di timestamp supportati. Illustrano diversi livelli di precisione e scelte relative al fuso orario, quindi non rappresentano tutte lo stesso istante:
2014-09-30 13:34:082014-09-30 13:34:08+00:0009/30/2014 13:34:0809/30/14 13:34:0809/30/2014 13:3409/30/14 13:342014-09-30T13:34:082014-09-30 13:34:08.0000012014-09-30T13:34:08.0000012014-09-30 13:34:08.000001-04:001412098448(Unix)
Microsoft Excel
Modifica per coerenza
Per modificare date e timestamp in un file Excel, seleziona innanzitutto le celle che vuoi riformattare. Premi Command+1 o Control+1 (se utilizzi macOS) o CTRL+1 (se utilizzi Windows). Per le istruzioni per la tua versione di Excel, consulta la guida di Microsoft sulla formattazione delle date.
Verrà visualizzato un popup Formato celle. Seleziona Numero dalla scheda principale (se non è già selezionata) e, in Categoria, seleziona Data.
In Tipo, scegli il formato data desiderato. Assicurati di scegliere un formato di data e timestamp supportato in Klaviyo.
Ad esempio, se selezioni 2012-03-14 (supportato in Klaviyo), conferma il formato con OK per applicarlo alle celle selezionate.
Modifica per località
Le impostazioni internazionali di Excel possono influire sui formati di data predefiniti. Per le istruzioni relative alla tua versione, consulta la guida di Microsoft sui formati di data e sulle impostazioni internazionali.
Una data in stile Regno Unito usa l’ordine giorno/mese, mentre Klaviyo interpreta le date separate da barre come mese/giorno. Ad esempio, Klaviyo interpreta 05/08/2020 come 8 maggio 2020, non 5 agosto. Prima di salvare il CSV, formatta le date come YYYY-MM-DD o MM/DD/YYYY, anche se usi una impostazione locale del Regno Unito.
Una volta che il tuo file Excel riflette la formattazione corretta di data/timestamp, fai clic su File > Salva con nome. Salva il file come CSV.
Poi torna al tuo account Klaviyo e carica il tuo file CSV in un elenco.
Se questi clienti esistono già nel tuo account, quando carichi il CSV nel tuo elenco, non verranno aggiunti nuovi profili. Invece, il relativo profilo verrà aggiornato per riflettere le modifiche che apporti quando mappi i campi. In questo modo eviterai di duplicare le informazioni sui clienti e di creare confusione nel tuo account.
Fogli Google
Modifica per località
Puoi anche modificare le date in Google Sheets in modo che corrispondano al tuo formato data nativo o alle impostazioni locali. Ad esempio, se ti trovi nel Regno Unito, potresti voler cambiare la formattazione della data statunitense (MM/DD) in quella del Regno Unito (DD/MM).
Per cambiare le impostazioni locali o il fuso orario del tuo foglio di lavoro, segui le istruzioni di Google per le impostazioni del foglio di lavoro.
La modifica delle impostazioni internazionali influisce sui formati predefiniti di data, numero e valuta del foglio di lavoro per chiunque lo utilizzi. Non modifica la lingua di visualizzazione di Google Sheets.
Ad esempio, un'impostazione internazionale per il Regno Unito può visualizzare le date nel formato giorno/mese/anno. Prima di esportare il CSV per Klaviyo, applica YYYY-MM-DD o MM/DD/YYYY come descritto di seguito.
Imposta le impostazioni locali prima di scegliere il formato data finale. Se modifichi le impostazioni locali in un secondo momento, ricontrolla le date prima di esportare. Dovrebbero comunque usare YYYY-MM-DD o MM/DD/YYYY.
Modifica per coerenza
Per modificare date e timestamp in modo coerente all'interno di un foglio di calcolo Google, seleziona le celle che vuoi riformattare.
Seleziona Formato > Numero > Data (o Data e ora se vuoi modificare sia la data che l'ora nel file).
Questo aggiornerà le date in modo che riflettano la formattazione predefinita di Google Sheets, come mostrato nell'immagine qui sotto.
In alternativa, puoi trovare le informazioni sulla data selezionando il menu a tendina 123.
Ora che hai un formato coerente in tutto il foglio di calcolo, assicurati che sia allineato alle linee guida di Klaviyo per la formattazione di date e timestamp.
Gli zeri iniziali in mesi e giorni separati da barre sono facoltativi: 8/5/1930 e 08/05/1930 indicano entrambi il 05/08/1930 in Klaviyo. Puoi comunque usare gli zeri iniziali per coerenza. Per cambiare il formato, segui le istruzioni di Google sulla formattazione personalizzata di data e ora.
Scegli YYYY-MM-DD o MM/DD/YYYY per i valori con solo data. Se la colonna include un orario, scegli uno dei formati timestamp supportati sopra. Fai clic su Applica.
Ad esempio, 08/05/1930 è un formato data accettabile in Klaviyo quando indica il 5 agosto 1930. Per indicare l’8 maggio 1930, usa 1930-05-08 o 05/08/1930.
Questo aggiornerà tutte le date affinché vengano visualizzate nel formato desiderato, che potrai poi caricare in Klaviyo.
Da qui, vai su File > Scarica e scarica il tuo Foglio Google come file CSV. Successivamente, potrai caricare il tuo file CSV in una lista Klaviyo.
Se questi clienti esistono già nel tuo account, quando carichi il CSV nel tuo elenco, non verranno aggiunti nuovi profili. Invece, il relativo profilo verrà aggiornato per riflettere le modifiche che apporti quando mappi i campi. In questo modo eviterai di duplicare le informazioni sui clienti e di creare confusione nel tuo account.
Al fine di garantire la sicurezza dei tuoi dati, il team di assistenza di Klaviyo non è in grado di aprire i tuoi file CSV. Se hai bisogno di assistenza per risolvere i problemi di importazione di un elenco, contatta il team di assistenza fornendo una descrizione dettagliata del problema e screenshot dell'errore riscontrato.
Esempio di caricamento CSV
Di seguito è riportato un esempio di come potrebbe apparire questo file CSV mentre lo carichi con i formati data/ora corretti.
Risorse aggiuntive
- Acceptable date and timestamp formats for profile and event properties reference
Learn which date and time formats Klaviyo recognizes in event and profile data sent through our APIs or in a CSV upload. Note that this does not apply to an event timestamp sent via the Track API, which must be unix time in seconds.
- Profile properties reference
Learn about the difference between custom and Klaviyo properties, how to use them to track information about your subscribers, how to remove them, best practices, and more.