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.

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 è sicuro del formato dei suoi dati, scelga questa opzione. 
  • Esempi: 
    email@example.com
    Salve, mondo
    $5.00
• Numerico
  Tutti i numeri. Non includa i simboli di valuta nei campi numerici. 
  • Esempi:
    2
    5.0031
    130.0
• Booleano
  Valori veri o falsi.
  • Esempi:
    vero
    falso
• 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
• Elenco
  I dati devono essere formattati come array JSON. 
  • Esempi:
    ["mele","banane","arance"]
    ["mele"]
• Consenso
  Il consenso si riferisce al fatto che un profilo abbia optato per il marketing via e-mail. Per il tipo di dati del consenso in un upload, il valore deve essere "e-mail".

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. 

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

• Aggiungere abbonati a una lista esistente
• Creare e aggiungere contatti a una nuova lista
• Formati di data e timestamp accettabili