Per utilizzare questa funzionalità devi avere un account Klaviyo a pagamento e Smart Translations abilitati.
La disponibilità di questa funzionalità è attualmente limitata. Controlla questo spazio.
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 file CSV delle tue traduzioni
Segui questi passaggi per esportare le traduzioni attuali di un singolo messaggio:
- Apri il messaggio che desideri 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 clicca su Esporta CSV.
-
Il tuo browser scarica un file CSV che include:
- block_id – l'identificatore univoco per ogni stringa traducibile in questo messaggio.
- source â€"Il testo sorgente originale per quella stringa.
- Colonne lingua: una colonna per lingua, denominata con il relativo codice lingua (ad esempio, en, fr, es-MX).
Ora puoi aprire questo file in Excel, Google Sheets o in un altro editor di fogli di calcolo.
Aggiorna il file CSV
Quando modifichi il file CSV, devi lavorare solo nelle colonne della lingua.
Non modificare, aggiungere o eliminare alcun valore nella colonna block_id. Se una riga presenta un block_id non valido o mancante, tale riga viene ignorata durante l'importazione e le relative traduzioni non vengono aggiornate.
Cosa puoi cambiare in sicurezza
Nel file CSV:
- Aggiorna le traduzioni esistenti modificando la colonna della lingua appropriata.
- Aggiungi le traduzioni mancanti compilando le celle vuote per una colonna della lingua.
- Se non vuoi aggiornare la lingua, lascia invariati i valori di una lingua.
- Aggiungi una o più nuove colonne di lingua:
- Utilizza un codice lingua BCP-47 valido (ad esempio, fr-CA, de, ca).
- Al momento dell'importazione, queste lingue vengono aggiunte all'editor di traduzione del 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 su una stringa traducibile esistente nel messaggio.
-
Non modificare i valori sorgente nel file CSV:
- Per modificare il contenuto sorgente, modifica il messaggio direttamente nell'editor di Klaviyo, quindi esporta un nuovo CSV.
- Non rinominare le colonne obbligatorie (block_id, source e le colonne della lingua).
-
Non modificare il formato del file:
- Conserva il file come file CSV .
- Salva la codifica UTF-8.
Gestione delle celle vuote
Se cancelli una cella di traduzione nel file CSV e la lasci vuota:
- L'importazione tratta la stringa vuota come un valore.
- La traduzione esistente per quella cella viene sovrascritta con un valore vuoto. In questo modo è possibile rimuovere efficacemente una traduzione.
Se vuoi evitare di modificare una traduzione, lascia il valore esistente nel file CSV o rimuovi completamente la colonna della lingua prima dell'importazione.
Al termine delle modifiche, salva il file come file .csv con codifica UTF-8.
Importa il file CSV
Dopo aver aggiornato e salvato il tuo file CSV:
- Torna all'editor di traduzione per lo stesso messaggio.
- Fai clic su Importa CSV.
-
Nella finestra modale di importazione:
- Clicca su Seleziona file e scegli il tuo file CSV, oppure
- Trascina e rilascia il tuo file CSV nell'area di caricamento.
-
Klaviyo esegue una convalida "a secco" e mostra:
- Un riepilogo del numero di righe che verranno aggiornate, invariate o ignorate
- Eventuali avvisi o errori rilevati
- Controlla attentamente il riepilogo e gli avvisi.
- Se tutto sembra corretto, clicca su Importa per applicare le modifiche.
Durante la convalida, Klaviyo verifica anche:
- Dimensione del file e limiti di riga (ad esempio, i file di dimensioni superiori a 10 MB saranno rifiutati).
- Colonne obbligatorie (ad esempio block_id, source e almeno una colonna di 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, vedi un messaggio di errore e puoi selezionare un nuovo file senza apportare modifiche alle traduzioni.
Come funzionano i risultati delle importazioni
Dopo la convalida, il riepilogo dell'importazione mostra cosa succederà se procederai.
Conteggi riepilogativi
Il riepilogo può includere conteggi come:
- Aggiornato: il numero di righe in cui cambierà almeno un valore di traduzione.
- Righe â€"invariate presenti nel file CSV, ma in cui tutti i valori corrispondono a ciò che è 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 sono calcolati per riga, non per lingua. Ad esempio, se un file CSV ha due righe e due colonne di lingua:
- Se una riga si aggiorna in una lingua, il conteggio Aggiornato è 1.
- Se una riga si aggiorna in entrambe le lingue, il conteggio Aggiornato è ancora 1.
- Se entrambe le righe si aggiornano in una o tutte le lingue, il conteggio Aggiornato è 2.
Procedure consigliate
Per mantenere i tuoi dati di traduzione accurati e facili da gestire:
- Inizia dall'ultima esportazione. Evita di riutilizzare i file CSV meno recenti, soprattutto dopo aver modificato il contenuto o le lingue del messaggio.
- Mantieni un backup di ogni esportazione. Salva una copia del file CSV prima di apportare modifiche, in modo da poter ripristinare la versione precedente, se necessario.
- Coordina con i traduttori. Spiega quali colonne possono modificare (solo colonne di lingua) e quali colonne non devono modificare (block_id, source).
- Lavora in lotti più piccoli, se necessario. Se il tuo file è molto grande, valuta la possibilità di suddividere il lavoro tra più messaggi o di eseguire diverse importazioni più piccole.
- Utilizza i codici lingua supportati. Quando aggiungi nuove colonne linguistiche, utilizza i codici BCP-47 supportati dall'articolo su Smart Translations per evitare lingue "non elaborabili".
Risolvi gli avvisi di convalida e gli errori di importazione
Se durante la convalida dell'importazione vedi degli avvisi o degli errori, rivedi le sezioni qui sotto per capire cosa significano e come correggerli.
Significato: una o più colonne obbligatorie (block_id o source) sono mancanti o rinominate.
Cosa fare: assicurati che il file CSV includa block_id e colonne di origine. Se hai copiato i dati in un nuovo foglio, verifica che la riga di intestazione corrisponda all'esportazione originale.
Cosa significa: il tuo file CSV ha valori di traduzione vuoti e le stringhe vuote saranno trattate come valori.
Cosa fare: se procedi, le celle vuote sovrascriveranno le traduzioni esistenti per quella chiave e quella lingua. Se vuoi lasciare invariate le traduzioni, ripristina i valori precedenti o rimuovi la colonna della lingua e reimporta il file.
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 di queste chiavi non funzionano ™t. Per risolvere il problema, rimuovi le righe dal file CSV o esportane un nuovo file, se necessario.
Cosa significa: due o più righe del tuo file CSV hanno gli stessi valori di 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 file CSV o esportane uno nuovo, se necessario.
Cosa significa: due o più colonne del tuo file CSV hanno lo stesso codice lingua o si risolvono nella stessa lingua (ad esempio, se una colonna lingua è stata duplicata per errore).
Cosa fare: vengono utilizzati i valori dell'ultima colonna duplicata e le colonne duplicate rimanenti vengono ignorate. Per risolvere il problema, rimuovi le colonne duplicate dal file CSV o esportane uno nuovo, se necessario.
Cosa significa: un'intestazione di colonna nel tuo file CSV utilizza un codice lingua non supportato o riconosciuto.
Cosa fare: per aggiungere una nuova lingua, utilizza uno dei codici BCP-47 supportati dalla documentazione di Smart Translations. Le colonne con codici non supportati vengono ignorate.
Cosa significa: il tuo file CSV include colonne di lingua che al momento non fanno parte di questo modello.
Cosa fare:
- Se desideri aggiungere queste lingue, controlla l'elenco e fai clic su Importa per aggiungerle all'editor di traduzione.
- Se non vuoi aggiungerli, rimuovi le colonne e reimporta il file ™t.
Cosa significa: il file CSV include block_id e colonne di origine, ma non è stata rilevata alcuna altra intestazione di colonna.
Cosa fare: aggiungi almeno una colonna di lingua supportata e riprova.
Cosa significa: il file CSV include block_id e colonne di origine ma non colonne di lingua valide.
Cosa fare: aggiungi almeno una colonna di lingua supportata e riprova.
Se vedi solo degli avvisi e ne comprendi l'impatto, puoi procedere con l'importazione. Se vedi un errore, devi correggere il file CSV e ricaricarlo prima di continuare. Se continui a vedere errori, esporta un nuovo file CSV dall'editor di traduzione, apporta modifiche minime e prova un'altra importazione per isolare il problema.
Se continui a riscontrare errori dopo aver controllato questi elementi, esporta un nuovo file CSV dall'editor di traduzione, apporta modifiche minime e prova un'altra importazione per isolare la modifica che sta causando il problema.