Risoluzione dei problemi relativi alle importazioni di elenchi
Imparerà
Scopra come risolvere gli errori che si verificano quando carica un CSV di contatti in una lista nuova o esistente in Klaviyo. Caricare le recensioni? Vada al nostro articolo su come importare le recensioni.
Prima di iniziare
Vuole assicurarsi che il suo file venga importato? Verifichi l'elenco dei requisiti qui sotto prima di importare la sua lista.
- File CSV (non altri formati)
- La dimensione del file è di 50 MB o meno
- La prima riga è costituita da intestazioni
- A ogni riga è associato un indirizzo e-mail o un numero di telefono.
- Non ci sono indirizzi e-mail o numeri di telefono duplicati.
Il nostro team di assistenza non è in grado di importare CSV in Klaviyo per suo conto. Se ha bisogno di aiuto con un'importazione, consulti la sezione di risoluzione dei problemi qui sotto per avere suggerimenti su come risolvere con successo i problemi di importazione degli elenchi.
Ha problemi a caricare un elenco di profili con consenso SMS? Consulti la Guida di Klaviyo per caricare un elenco di contatti SMS.
Indice dei contenuti
- Ritardo nell'importazione
- Risoluzione dei problemi di importazione
- Tutte le colonne vengono importate come un unico campo
- Messaggi di errore di formato non valido
- Formattazione non corretta della data o del timestamp
- Messaggi di errore sull'identificatore univoco duplicato o mancante
- Valore mancante in un campo obbligatorio
- Problemi di formattazione dei numeri di telefono
Ritardo nell'importazione
Se importa un file di grandi dimensioni con una quantità significativa di dati, il processo di importazione potrebbe richiedere diverse ore per essere completato. Purtroppo non c'è modo di accelerare questo processo una volta iniziato. Tuttavia, un modo per accelerare preventivamente il processo di importazione è quello di rimuovere tutte le e-mail duplicate dal CSV prima dell'importazione. Consigliamo vivamente di pianificare l'importazione di una nuova lista con almeno un giorno di anticipo rispetto alla data in cui intende inviare le e-mail ai contatti della lista.
Dopo l'avvio di un'importazione, inizialmente verrà visualizzata una barra di stato. Se si allontana, potrà comunque seguire i progressi dell'importazione osservando l'aumento del numero di liste nel tempo. Le invieremo un'e-mail non appena l'importazione di un elenco sarà completata.
Risoluzione dei problemi di importazione
Se la sua lista non riesce a caricarsi, cerchi i seguenti errori comuni nel suo file CSV che potrebbero causare questo blocco:
Tutte le colonne vengono importate come un unico campo
Se utilizza una versione di Excel che non utilizza l'inglese come lingua predefinita, il suo software potrebbe utilizzare il punto e virgola e non la virgola come separatore nel suo file. In questo caso, il suo file potrebbe apparire come questo al momento dell'importazione:
Per rimediare a questo problema, si rechi all'impostazione Formato numero o Separatore elenco (o numero) del suo computer. Questa impostazione è probabilmente all'interno delle impostazioni di Lingua & Regione, e può trovarsi nella sezione Impostazioni avanzate. Sostituisca il punto e virgola con una virgola e salvi. Ora, quando esporta i file come CSV, utilizzerà il formato con la virgola. Si noti che la posizione esatta di questa impostazione può essere diversa nei vari sistemi operativi.
Inoltre, verifichi che il suo CSV sia conforme ai requisiti di formattazione di Klaviyo. Se non l'ha ancora fatto, consulti la nostra documentazione sulla formattazione dei dati. Ad esempio, uno dei campi richiesti è quello degli indirizzi e-mail.
Risoluzione dei messaggi di errore di formato non valido
Quando importa un elenco in Klaviyo, la pagina di mappatura dei campi le consente di abbinare qualsiasi proprietà al tipo di dati corrispondente in Klaviyo. Per esempio, Email ha sempre un tipo di dati Text; mentre se carica una proprietà personalizzata per Birthday, dovrà impostare il tipo di dati su Date.
Esamini i tipi di dati, i formati accettabili e gli esempi che seguono.
- Testo
Qualsiasi testo o combinazione di testo e numeri. Se non sei sicuro del formato dei tuoi dati, scegli questa opzione. - Esempi:
email@example.com
Salve, mondo
$5.00
- Esempi:
- Numeri
Tutti i numeri. Non includere simboli di valuta nei campi numerici. - Esempi:
2
5.0031
130.0
- Esempi:
- Booleano
Valori veri o falsi.- Esempi:
vero
falso
- Esempi:
- Data
Faccia riferimento alla nostra guida sui formati di data e timestamp accettabili per le proprietà di profili ed eventi per conoscere i formati di data accettati.- Esempio:
2014-09-01 13:34:08
- Esempio:
- elenco
dati deve essere formattato come un array JSON. - Esempi:
["mele","banane","arance"]
["mele"]
- Esempi:
- Consenso
Il consenso è formattato come canale (e-mail, SMS, ecc.) e il tipo di consenso (se ci sono più tipi disponibili in Klaviyo). L'unica opzione per l'e-mail è il marketing tramite consenso e-mail; per SMS, il marketing può essere effettuato tramite consenso SMS o consenso transazionaleSMS ; ecc. Il valore di questo campo deve essere "iscriviti," " Mai iscriviti," o "annulla l'iscrizione."
Per maggiori informazioni su cosa comportano i diversi tipi di dati e quali selezionare quando importa la sua lista, consulti la nostra guida sulla comprensione dei tipi di dati.
Per saperne di più sui messaggi di errore "Formato [tipo di dati] non valido" (ad esempio, "Formato elenco non valido"), consulti la nostra guida alla risoluzione dei problemi per i messaggi di errore di formato non valido.
Formattazione non corretta della data o del timestamp
Potrebbe utilizzare un formato sbagliato per le date o i timestamp. Se ha incluso uno dei due e non è sicuro dei formati accettati da Klaviyo, consulti la nostra guida sui formati di data e timestamp accettabili per le proprietà di profili ed eventi.
Risoluzione dei messaggi di errore relativi all'identificatore univoco duplicato o mancante
Identificatori duplicati
I record saltati a causa di "Duplicate Unique ID" significano che un indirizzo e-mail o un numero di telefono è stato ripetuto nel suo file. In questi casi, Klaviyo elaborerà i dati dalla prima riga contenente l'identificatore ripetuto e fornirà tutti i record non elaborati in un file scaricabile.
Clicchi su Scarica i record saltati per vedere i contatti saltati a causa di identificatori duplicati e ricaricare questi record saltati, se necessario.
Mancano gli identificatori unici
I record saltati a causa di "ID univoco mancante" significano che le righe saltate non contenevano un indirizzo e-mail, un numero di telefono o un altro identificatore univoco accettato.
Clicchi su Scarica i record saltati per vedere i contatti saltati a causa di identificatori mancanti, aggiunga un indirizzo e-mail o un numero di telefono per ciascuno di essi e ricarichi il nuovo file.
Valore mancante in un campo obbligatorio
Verifichi che tutti i campi obbligatori abbiano dei valori associati. Ad esempio, se ad uno dei suoi contatti elencati manca un indirizzo e-mail nella colonna e-mail, verrà visualizzato un errore al momento del caricamento. Verifichi che ogni contatto che desidera caricare abbia un valore per tutti i campi obbligatori. Se sono vuoti, li riempia prima del suo prossimo tentativo di caricamento.
Indirizzo e-mail non valido o caratteri non riconosciuti
Se riceve questo messaggio di errore, controlli che gli indirizzi e-mail del suo file non contengano caratteri non validi. I caratteri non validi includono ( ) , : ; [ / ], così come gli spazi.
Per mantenere la sicurezza dei suoi dati, il team di assistenza di Klaviyo non è in grado di aprire i suoi file CSV. Per ulteriore assistenza nella risoluzione dei problemi di importazione di un elenco, contatti il team di assistenza con una descrizione dettagliata del problema e con gli screenshot dell'errore riscontrato.
Trasferimento del profilo tra i conti
Quando trasferisce il profilo da un account all'altro, ci sono alcune proprietà che non possono essere caricate su un altro account.
Ad esempio, il profilo creato il non può essere trasferito perché è impostato sulla data di creazione di un profilo nell'account. Un'altra serie di esempi è rappresentata da Primo attivo e Ultimo attivo, che vengono impostati automaticamente in base all'attività del profilo sull'account.
Problemi di formattazione dei numeri di telefono
I numeri di telefono devono includere un codice paese o una colonna separata che indichi il paese, e devono seguire un formato di numero di telefono accettato. Impari a formattare e caricare correttamente i numeri di telefono.
Risorse aggiuntive
- Come importare iscritto ad un elenco
Scopri come aggiungere un iscritto a un elenco in Klaviyo. Il caricamento del contatto è fondamentale quando Primi passi con Klaviyo, in particolare se stai migrando da un altro servizio provider o se stai raccogliendo informazioni da una terza parte.
- Formati di data e timestamp accettabili per il riferimento alle proprietà del profilo e dell'evento
Scopra quali formati di data e ora riconosce Klaviyo nei dati di eventi e profili inviati attraverso le nostre API o in un caricamento CSV. Si noti che questo non si applica al timestamp di un evento inviato tramite l'API Track, che deve essere l'ora unix in secondi.