Risoluzione dei problemi di importazione degli elenchi

Cosa imparerai

Scopri come risolvere gli errori che si verificano quando carichi un file CSV di contatti in un elenco nuovo o esistente in Klaviyo. Vuoi caricare le recensioni? Consulta il nostro articolo su come importare le recensioni.

Prima di iniziare

Vuoi assicurarti che il file venga importato? Prima di importare l’elenco, controlla l’elenco dei requisiti di seguito.

• File CSV (nessun altro formato)
• La dimensione del file è pari o inferiore a 50 MB
• La prima riga contiene le intestazioni
• Ogni riga ha 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 può importare CSV in Klaviyo per tuo conto. Se hai bisogno di aiuto con un'importazione, consulta la sezione di risoluzione dei problemi qui sotto per suggerimenti su come risolvere correttamente i problemi di importazione degli elenchi.

Indice

• Ritardo di importazione
• Risoluzione dei problemi di importazione
• Tutte le colonne importate come un unico campo
• Messaggi di errore di formato non valido
• Formato errato della data o del timestamp
• Messaggi di errore per identificatore univoco duplicato o mancante
• Valore mancante in un campo obbligatorio
• Problemi di formattazione del numero di telefono

Ritardo di importazione

Se importi un file di grandi dimensioni con una quantità significativa di dati, il processo di importazione potrebbe richiedere diverse ore per essere completato. Purtroppo, una volta avviato, non c’è modo di accelerare questo processo. Tuttavia, un modo per velocizzare in anticipo la procedura di importazione è rimuovere tutte le e-mail duplicate dal CSV prima di importarlo. Ti consigliamo vivamente di pianificare l'importazione di un nuovo elenco almeno un giorno prima di quando intendi inviare un'e-mail ai contatti dell'elenco.

Dopo l’avvio di un’importazione, inizialmente vedrai una barra di stato. Se fai clic altrove, potrai comunque monitorare l’avanzamento dell’importazione osservando l’aumento nel tempo del conteggio della lista. Ti invieremo un’e-mail non appena un’importazione di lista viene completata.

Risoluzione dei problemi di importazione

Se la tua lista non viene caricata, cerca nel tuo file CSV i seguenti errori comuni che potrebbero causare questo ostacolo:

Tutte le colonne importate come un unico campo

Se utilizzi una versione di Excel che non usa l’inglese come lingua predefinita, il software potrebbe usare punti e virgola e non virgole come separatore nel file. Se è questo il caso, il tuo file potrebbe apparire così al momento dell’importazione:

Per risolvere il problema, vai all'impostazione Formato numero o Separatore elenco (o numero) del tuo computer. Questa impostazione si trova probabilmente nelle impostazioni Lingua e area geografica e potrebbe essere nella sezione Impostazioni avanzate. Sostituisci il punto e virgola con una virgola e salva. Ora, quando esporti i file come CSV, utilizzeranno il formato con la virgola. Tieni presente che la posizione esatta di questa impostazione può variare in base al sistema operativo.

Inoltre, controlla che il tuo CSV sia allineato ai requisiti di formattazione di Klaviyo. Se non l'hai già fatto, consulta la nostra documentazione su come formattare i tuoi dati. Ad esempio, uno dei campi obbligatori è quello per gli indirizzi e-mail.

Risoluzione dei problemi relativi ai messaggi di errore di formato non valido

Quando importi un elenco in Klaviyo, la pagina di mappatura dei campi ti consente di associare eventuali proprietà al relativo tipo di dati in Klaviyo. Ad esempio, E-mail ha sempre un tipo di dati Testo; mentre, se carichi una proprietà personalizzata per Compleanno, ti consigliamo di impostare il tipo di dati su Data.

Rivedi i tipi di dati, i formati accettati e gli esempi qui sotto.

• 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
    Ciao, mondo
    5,00 $
• Numerico
  Tutti i numeri. Non includere simboli di valuta nei campi numerici.
  • Esempi:
    2
    5,0031
    130,0
• Booleano
  Valori vero o falso.
  • Esempi:
    vero
    falso
• Data
  Consulta la nostra guida ai formati di data e timestamp consentiti per le proprietà di profilo ed evento per scoprire i formati di data accettati.
  • Esempio:
    2014-09-01 13:34:08
• Elenco
  I dati devono essere formattati come una matrice JSON.
  • Esempi:
    ["mele","banane","arance"]
    ["mele"]
• Consenso
  Il consenso è formattato come il canale (e-mail, SMS e così via) e il tipo di consenso (se in Klaviyo sono disponibili più tipi). L'unica opzione per e-mail è Consenso per marketing via e-mail; per SMS sarebbe Consenso per marketing via SMS oppure Consenso transazionale via SMS; e così via. Il valore di questo campo deve essere "iscriviti," "Mai iscritto," o "annullare l'iscrizione." 

Per ulteriori informazioni su cosa comportano i diversi tipi di dati e su quali selezionare durante l'importazione del tuo elenco, consulta la nostra guida su come comprendere i tipi di dati.

Per saperne di più sui messaggi di errore “Formato [tipo di dati] non valido” (ad esempio “Formato elenco non valido”), consulta la nostra guida alla risoluzione dei problemi per i messaggi di errore di formato non valido.

Formato errato della data o del timestamp

Potresti usare il formato sbagliato per date o timestamp. Se ne hai inclusi e non sei sicuro dei formati accettati da Klaviyo, consulta la nostra guida sui formati di data e timestamp accettabili per le proprietà del profilo e dell'evento.

Risoluzione dei problemi relativi ai messaggi di errore per identificatore univoco duplicato o mancante

Identificatori duplicati

I record saltati a causa di "ID univoco duplicato" significano che nel file è stato ripetuto un indirizzo e-mail o un numero di telefono. In questi casi, Klaviyo elaborerà i dati dalla prima riga che contiene l’identificatore ripetuto e fornirà tutti i record non elaborati in un file scaricabile.

Fai clic su Scarica i record ignorati per vedere i contatti ignorati a causa di identificatori duplicati e ricarica questi record ignorati, se necessario.

Identificatori univoci mancanti

I record ignorati a causa di "ID univoco mancante" indicano che le righe ignorate non contenevano un indirizzo e-mail, un numero di telefono o un altro identificatore univoco accettato.

Fai clic su Scarica record ignorati per vedere i contatti ignorati a causa di identificatori mancanti, aggiungere un indirizzo e-mail o un numero di telefono per ciascuno e caricare di nuovo il nuovo file.

Valore mancante in un campo obbligatorio

Verifica che tutti i campi obbligatori abbiano valori associati. Ad esempio, se uno dei contatti elencati non ha un indirizzo e-mail nella colonna e-mail, visualizzerai un errore durante il caricamento. Verifica che ogni contatto che vuoi caricare abbia un valore per tutti i campi obbligatori. Se sono vuoti, compilali prima del prossimo tentativo di caricamento.

Indirizzo e-mail non valido o caratteri non riconosciuti

Se ricevi questo messaggio di errore, controlla gli indirizzi e-mail nel tuo file per verificare la presenza di caratteri non validi. I caratteri non validi includono ( ) , : ; [ / ], oltre agli spazi.

Trasferimento di profili tra account

Quando trasferisci i profili da un account a un altro, ci sono alcune proprietà che non possono essere caricate su un altro account.

Ad esempio, profilo created on non può essere trasferito perché è impostato sulla data in cui viene creato un profilo nell'account. Un altro insieme di esempi sono First Active e Last Active, in quanto vengono impostati automaticamente in base all'attività del profilo nell'account.

Problemi di formattazione del numero di telefono

I numeri di telefono devono includere un prefisso internazionale o una colonna separata che indichi il relativo Paese e devono seguire un formato di numero di telefono accettato. Scopri come formattare e caricare correttamente i numeri di telefono.

Risorse aggiuntive