Come gestire le traduzioni in blocco con CSV
Per utilizzare questa funzionalità, devi avere un account Klaviyo a pagamento e Smart Translations abilitato.
Gestisci le traduzioni al di fuori di Klaviyo esportando e modificando un file CSV, quindi importandolo di nuovo per aggiornare le traduzioni in blocco o collaborare con altri.
Esporta un CSV delle tue traduzioni
Segui questi passaggi per esportare le traduzioni attuali per un singolo messaggio:
- Apri il messaggio che vuoi aggiornare (e-mail della campagna, e-mail del flusso, SMS, messaggio WhatsApp, ecc.).
- Fai clic su Traduci per aprire l'editor di traduzione.
- Nell'editor di traduzione, apri il menu Azioni e fai clic su Esporta CSV.
- Nella finestra modale di esportazione, puoi scegliere tra un Smarting CSV o un CSV
Esportazione di Smartling CSV
- Il browser scarica un file CSV che include:
- Le seguenti direttive Smartling predefinite:
- # smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE - block_id – l'identificatore univoco per ogni stringa traducibile in questo messaggio.
- Codice lingua di origine (ad esempio, en) – il testo di origine originale per quella stringa.
Puoi usare questo file così com'è per importare le tue stringhe in Smartling. Smartling analizza automaticamente il CSV, estrae le stringhe e ti consente di avviare i job di traduzione.
Al termine del processo, scarica il CSV risultante e importalo di nuovo con il pulsante importa.
Esportazione di un CS semplice
- Il browser scarica un file CSV che include:
- block_id – l'identificatore univoco per ogni stringa traducibile in questo messaggio.
- origine – il testo di origine originale per quella stringa.
- Colonne lingua – una colonna per ogni lingua, denominata con il relativo codice lingua (ad esempio en, fr, es-MX).
Ora puoi aprire questo file in Excel, Google Sheets o un altro editor di fogli di calcolo.
Aggiorna il CSV
Quando modifichi il CSV, devi lavorare solo nelle colonne della lingua.
Non modificare, aggiungere o eliminare alcun valore nella colonna block_id. Se una riga ha un block_id non valido o mancante, quella riga viene ignorata durante l’importazione e le relative traduzioni non vengono aggiornate.
Cosa puoi modificare in sicurezza
Nel CSV:
- Aggiorna le traduzioni esistenti modificando la colonna della lingua appropriata.
- Aggiungi le traduzioni mancanti compilando le celle vuote di una colonna della lingua.
- Lascia invariati i valori di una lingua se non vuoi aggiornarla.
- Aggiungi una o più nuove colonne lingua:
- Usa un codice lingua BCP‐47 valido (ad esempio, fr-CA, de, ca).
- Durante l'importazione, queste lingue vengono aggiunte all'editor di traduzione per questo messaggio, se supportate.
Cosa non dovresti cambiare
Evita quanto segue:
- Non modificare o eliminare i valori block_id.
- Non aggiungere righe. Ogni riga deve continuare a essere mappata a una stringa traducibile esistente nel messaggio.
- Non modificare i valori di origine nel CSV:
- Per modificare il contenuto di origine, modifica il messaggio direttamente nell'editor di Klaviyo, quindi esporta un nuovo CSV.
- Non rinominare le colonne richieste (block_id, source e le colonne della lingua).
- Non modificare il formato del file:
- Mantieni il file in formato .csv .
- Salva con codifica UTF‐8.
Gestione delle celle vuote
Se cancelli una cella di traduzione nel CSV e la lasci vuota:
- L’importazione tratta quella stringa vuota come un valore.
- La traduzione esistente per quella cella viene sovrascritta con un valore vuoto. Questo può effettivamente rimuovere una traduzione.
Se vuoi evitare di modificare una traduzione, lascia il valore esistente nel CSV o rimuovi completamente la colonna della lingua prima di importare.
Quando hai finito di modificare, salva il file come .csv con codifica UTF‐8.
Importa il file CSV
Dopo aver aggiornato e salvato il tuo CSV:
- Torna all'editor di traduzione per lo stesso messaggio.
- Fai clic su Importa CSV.
- Nella finestra modale di importazione, puoi:
- Fai clic su Seleziona file e scegli il tuo CSV, oppure
- Trascina e rilascia il file CSV nell'area di caricamento.
- Klaviyo esegue un "dry run" di convalida e mostra:
- Un riepilogo del numero di righe che verranno aggiornate, lasciate invariate o ignorate
- Eventuali avvisi o errori rilevati
- Esamina attentamente il riepilogo e gli avvisi.
- Se tutto è corretto, fai clic su Importa per applicare le modifiche.
Durante la convalida, Klaviyo verifica anche:
- Limiti per dimensione del file e numero di righe (ad esempio, i file più grandi di 10MB verranno rifiutati).
- Colonne obbligatorie (come block_id, source e almeno una colonna lingua).
- Codici lingua non riconosciuti o non supportati dal canale.
- Valori di traduzione vuoti e altri potenziali problemi.
Se la convalida non va a buon fine, viene visualizzato un messaggio di errore e puoi selezionare un nuovo file senza apportare modifiche alle tue traduzioni.
Comprendi i risultati dell'importazione
Dopo la convalida, il riepilogo dell'importazione mostra cosa succederà se procedi.
Conteggi riepilogativi
Il riepilogo può includere conteggi come:
- Aggiornate – il numero di righe in cui cambierà almeno un valore di traduzione.
- Non modificato – righe presenti nel CSV ma in cui tutti i valori corrispondono a quanto già memorizzato.
- Ignorato / saltato – righe che non saranno importate (ad esempio, perché il block_id non esiste in questo messaggio o i dati obbligatori sono mancanti).
I conteggi vengono calcolati per riga, non per lingua. Ad esempio, se un CSV ha due righe e due colonne di lingua:
- Se una riga si aggiorna in una lingua, il conteggio Aggiornate è 1.
- Se una riga si aggiorna in entrambe le lingue, il conteggio Aggiornati resta comunque 1.
- Se entrambe le righe si aggiornano in una o tutte le lingue, il conteggio Aggiornato è 2.
Procedure consigliate
Per mantenere i dati di traduzione accurati e facili da gestire:
- Inizia dall’esportazione più recente. Evita di riutilizzare CSV meno recenti, soprattutto dopo aver modificato i contenuti o le lingue del messaggio.
- Conserva un backup di ogni esportazione. Salva una copia del CSV prima di apportare modifiche, così puoi ripristinarla se necessario.
- Coordinati con i traduttori. Spiega quali colonne possono modificare (solo le colonne delle lingue) e quali colonne non devono cambiare (block_id, source).
- Se necessario, lavora in batch più piccoli. Se il file è molto grande, valuta di suddividere il lavoro in più messaggi o di eseguire diverse importazioni più piccole.
- Usa i codici lingua supportati. Quando aggiungi nuove colonne di lingua, usa codici BCP-47 supportati dall’articolo Smart Translations per evitare lingue “non elaborabili”.
Risolvi gli avvisi di convalida e gli errori di importazione
Se vedi avvisi o errori durante la convalida dell’importazione, consulta le sezioni di seguito per capire cosa significano e come risolverli.
"Mancano colonne obbligatorie."
Cosa significa: una o più colonne obbligatorie (block_id o source) mancano o sono state rinominate.
Cosa fare: assicurati che il CSV includa le colonne block_id e source. Se hai copiato i dati in un nuovo foglio, verifica che la riga di intestazione corrisponda all’esportazione originale.
"Sono presenti valori di traduzione vuoti. Le stringhe vuote verranno considerate come valori."
Cosa significa: il tuo CSV contiene valori di traduzione vuoti e le stringhe vuote verranno considerate come valori.
Cosa fare: se procedi, queste celle vuote sovrascrivono le traduzioni esistenti per quella chiave e lingua. Se vuoi lasciare invariate quelle traduzioni, ripristina i valori precedenti oppure rimuovi la colonna della lingua e importa di nuovo il file.
"<count> chiavi non esistono nel tuo progetto e non verranno incluse nell'importazione."
Cosa significa: Alcuni valori block_id nel tuo CSV non esistono per questo modello (ad esempio, se i valori block_id sono stati modificati manualmente).
Cosa fare: queste righe vengono ignorate e le traduzioni per quelle chiavi non cambiano. Per risolvere il problema, rimuovi quelle righe dal CSV oppure esporta un nuovo file, se necessario.
"Il tuo file contiene chiavi duplicate con valori discordanti. Il primo valore verrà utilizzato."
Cosa significa: due o più righe nel tuo CSV hanno gli stessi valori block_id (ad esempio, se le righe sono state duplicate per errore).
Cosa fare: vengono utilizzati i valori della prima riga e le righe duplicate rimanenti vengono ignorate. Per risolvere il problema, rimuovi le righe duplicate dal CSV o, se necessario, esporta un nuovo file.
"Più colonne fanno riferimento alla stessa lingua. Verrà utilizzata solo l'ultima colonna e le altre verranno ignorate."
Cosa significa: due o più colonne nel tuo CSV hanno lo stesso codice lingua o vengono ricondotte alla stessa lingua (ad esempio, se una colonna della lingua è stata duplicata per errore).
Cosa fare: vengono utilizzati i valori dell'ultima colonna duplicata e le restanti colonne duplicate vengono ignorate. Per risolvere il problema, rimuovi le colonne duplicate dal CSV oppure esporta un nuovo file, se necessario.
"Il file contiene colonne con codici lingua non supportati da questo<invalid language code> canale:. Queste verranno ignorate, ma le impostazioni locali valide verranno importate."
Cosa significa: un’intestazione di colonna nel CSV usa un codice lingua non supportato o non riconosciuto.
Cosa fare: per aggiungere una nuova lingua, usa uno dei codici BCP-47 supportati dalla documentazione Smart Translations. Le colonne con codici non supportati vengono ignorate.
"Nel file sono presenti lingue che non fanno parte del tuo progetto. Le seguenti lingue verranno aggiunte al tuo editor di traduzione: <language detected>."
Cosa significa: Il tuo CSV include colonne della lingua che al momento non fanno parte di questo modello.
Cosa fare:
- Se vuoi aggiungere queste lingue, consulta l'elenco e fai clic su Importa per aggiungerle all'editor di traduzione.
- Se non vuoi aggiungerle, rimuovi queste colonne e reimporta il file.
"Nessuna colonna delle impostazioni locali trovata."
Cosa significa: il CSV include le colonne block_id e source, ma non è stata rilevata nessun’altra intestazione di colonna.
Cosa fare: aggiungi almeno una colonna per una lingua supportata e riprova.
"Nessuna colonna della lingua valida trovata."
Cosa significa: il CSV include le colonne block_id e source, ma non include colonne di lingua valide.
Cosa fare: aggiungi almeno una colonna per una lingua supportata e riprova.
Se visualizzi solo avvisi e ne comprendi l’impatto, puoi procedere con l’importazione. Se visualizzi un errore, devi correggere il CSV e caricarlo di nuovo prima di continuare. Se continui a visualizzare errori, esporta un nuovo CSV dall’editor di traduzione, apporta modifiche minime e prova a eseguire un’altra importazione per isolare il problema.
Se continui a visualizzare errori dopo aver controllato questi elementi, esporta un nuovo CSV dall’editor di traduzione, apporta modifiche minime e prova un’altra importazione per isolare quale modifica sta causando il problema.
Risorse aggiuntive
- Come abilitare Smart Translations
Scopri come abilitare Smart Translations per i messaggi in modo da poter inviare campagne e Flusso in più lingue in base alle preferenze linguistiche del tuo pubblico. Klaviyo può tradurre i contenuti delle e-mail in oltre 60 lingue.
- Come creare una campagna e-mail multilingue con la funzionalità Smart Translations
Scopri come creare e inviare una campagna e-mail in più lingue, a seconda delle preferenze linguistiche del tuo pubblico. Klaviyo è in grado di tradurre i contenuti di una campagna in oltre 60 lingue.
- Come creare una campagna SMS multilingue con Smart Translations
Scopri come creare e inviare una campagna SMS in più lingue, a seconda delle preferenze linguistiche del tuo pubblico. Klaviyo è in grado di tradurre i contenuti di una campagna in oltre 60 lingue.
- Come personalizzare i contenuti in base alla lingua
Scopri come raccogliere la lingua preferita di una persona e poi rivolgerti a lei in quella lingua.