Så hanterar du översättningar i bulk med CSV

Hantera översättningar utanför Klaviyo genom att exportera och redigera en CSV-fil och sedan importera den igen för att uppdatera översättningar i bulk eller samarbeta med andra.

Exportera en CSV-fil med dina översättningar

Följ dessa steg för att exportera de aktuella översättningarna för ett enskilt meddelande:

1. Öppna meddelandet du vill uppdatera (kampanjmejl, flödesmejl, sms, WhatsApp-meddelande osv.).
2. Klicka på meddelandets Översätt -ikon eller -knapp, eller på knappen som visar antalet översättningar, för att öppna översättningsredigeraren. Om meddelandet inte har översatts ännu slutför du språkinställningarna först.
3. I översättningsredigeraren öppnar du åtgärdsmenyn med tre punkter och klickar på Exportera.

4. Under Välj exportformat väljer du CSV. Låt Smartling compatible vara markerat om du ska skicka filen till Smartling, eller avmarkera det för att redigera en standard- CSV i ett kalkylblad.

5. Under Språk att exportera väljer du Välj alla om du vill inkludera alla befintliga översättningsspråk, eller Anpassat urval om du vill välja specifika språk. Om du bara vill exportera källtexten för en översättare väljer du alternativet endast källspråk. Källspråket ingår i varje export.
6. Klicka på Exportera för att ladda ner CSV-filen.

Smartling-CSV

En Smartling-kompatibel CSV innehåller:

Smartling-direktiv högst upp i filen, inklusive:

# smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE

• block_id – den unika identifieraren för varje översättningsbar sträng i det här meddelandet.
• Kod för källspråk (t.ex. en) – den ursprungliga källtexten för den strängen.
• Språkkolumner för de översättningsspråk du valde, om det finns några.

Du kan använda den här filen som den är för att importera dina strängar till Smartling. Smartling tolkar automatiskt CSV-filen, extraherar strängarna och låter dig starta översättningsjobb.

När jobbet är klart laddar du ned den översatta CSV-filen. Innan du importerar den till Klaviyo tar du bort eventuella inledande # smartling. -direktivrader så att den första raden innehåller kolumnrubrikerna. Behåll kolumnen block_id, källspråkskolumnen och minst 1 kolumn för ett översättningsspråk som stöds. Följ sedan Importera CSV-filen nedan.

Standard CSV

En standard-CSV innehåller:

• block_id – den unika identifieraren för varje översättningsbar sträng i det här meddelandet.
• källa – den ursprungliga källtexten för den strängen.
• Språkkolumner: 1 kolumn per översättningsspråk som du valde, namngiven med dess språkkod (till exempel en, fr, es-MX). En export med endast källspråk har inga kolumner för översättningsspråk.

Du kan nu öppna den här filen i Excel, Google Sheets eller ett annat kalkylbladsprogram.

Uppdatera CSV-filen

När du redigerar CSV-filen behöver du bara arbeta i språkkolumnerna.

Redigera, lägg inte till eller radera inte några värden i kolumnen block_id. Om en rad har ett ogiltigt eller saknat block_id ignoreras den raden under importen och dess översättningar uppdateras inte.

Vad du tryggt kan ändra

I CSV-filen:

• Uppdatera befintliga översättningar genom att redigera rätt språkkolumn.
• Lägg till saknade översättningar genom att fylla i tomma celler i en språkkolumn.
• Lämna en språks värden oförändrade om du inte vill uppdatera det språket.
• Lägg till en eller flera nya språkkolumner:
  • Använd en giltig BCP‐47-språkkod (till exempel fr-CA, de, ca).
  • Vid import läggs språk som stöds och har nya översättningsvärden till i översättningsredigeraren för det här meddelandet.

Det du inte ska ändra

Undvik följande:

• Redigera eller ta inte bort block_id-värden.
• Lägg inte till rader. Varje rad måste fortsätta att mappa till en befintlig översättningsbar sträng i meddelandet.
• Ändra inte källvärdena i CSV-filen:
  • Om du vill ändra källinnehållet redigerar du meddelandet direkt i Klaviyo-redigeraren och exporterar sedan en ny CSV.
• Behåll kolumnrubrikerna block_id och source oförändrade. I en Smartling CSV ska du behålla kolumnrubriken för källspråket i stället för source. Se till att varje översättningsspråkskolumn är märkt med sin språk-/landskod som stöds.
• Ändra inte filformatet:
  • Behåll filen som en .csv fil.
  • Spara i UTF‐8 -kodning.

Behåll malltagg, till exempel {{ first_name }} och {% if ... %}, oförändrade i varje översättning. Om dessa platshållare skiljer sig från källmeddelandet blockerar valideringen importen.

Hantera tomma celler

Om du rensar en översättningscell i CSV-filen och lämnar den tom:

• Importen behandlar den tomma strängen som ett värde.
• Den befintliga översättningen för den cellen skrivs över med ett tomt värde. Det här kan effektivt ta bort en översättning.

Om du rensar en cell och det också tar bort platshållare som finns i källan blockerar valideringen importen. Återställ platshållarna eller ta bort språkkolumnen innan du importerar.

Om du vill undvika att ändra en översättning lämnar du dess befintliga värde i CSV-filen eller tar bort språk-kolumnen helt innan du importerar.

När du är klar med redigeringen sparar du filen som en UTF‐8-kodad .csv.

Importera CSV-filen

När du har uppdaterat och sparat din CSV-fil:

1. Gå tillbaka till översättningsredigeraren för samma meddelande.
2. Öppna åtgärdsmenyn med tre punkter och klicka på Importera CSV.
3. I importmodulen kan du antingen:

• Klicka på Välj fil och välj din CSV, eller
• Dra och släpp din CSV i uppladdningsområdet.

4. Klicka på Nästa för att validera filen och förhandsgranska ändringarna.

Klaviyo genomför en validerande ”testkörning” och visar:

• En sammanfattning av hur många rader som kommer att uppdateras, lämnas oförändrade eller ignoreras
• Eventuella varningar eller fel som den upptäckte

1. Granska sammanfattningen och varningarna noga.
2. Om allt ser korrekt ut klickar du på Importera för att tillämpa ändringarna.

När importen lyckas stängs modalfönstret och dina översättningar uppdateras i översättningsredigeraren. Granska de importerade översättningarna.

Under valideringen kontrollerar Klaviyo också följande:

• Filtyp och kodning: använd en UTF-8-kodad CSV-fil.
• CSV-kolumner: behåll block_id, källkolumnen (eller kolumnen för källspråket för Smartling) och minst 1 kolumn för ett översättningsspråk som stöds.
• Språkkoder som inte känns igen eller inte stöds av kanalen.
• Tomma översättningsvärden och andra möjliga problem.
• Malltagg som skiljer sig från källmeddelandet.

Om valideringen misslyckas visas ett felmeddelande. Klicka på Välj ny fil när du har korrigerat CSV-filen för att försöka igen. Valideringen ändrar inte dina översättningar.

Förstå importresultat

Efter validering visar importsammanfattningen vad som händer om du fortsätter.

Antal i sammanfattningen

Sammanfattningen kan innehålla antal som:

• Uppdaterade: antalet rader där minst 1 översättningsvärde kommer att ändras.
• Hoppades över (oförändrade): rader i CSV-filen där alla inkluderade översättningsvärden matchar det som redan är lagrat.
• Ignorerade: rader som inte importeras, till exempel dubblettrader efter den första förekomsten eller rader vars block_id inte finns i det här meddelandet.

Bästa praxis

För att hålla dina översättningsdata korrekta och enkla att hantera:

1. Börja från den senaste exporten. Undvik att återanvända äldre CSV-filer, särskilt efter att du ändrar innehåll eller språk i meddelandet.
2. Spara en säkerhetskopia av varje export. Spara en kopia av CSV-filen innan du gör ändringar så att du kan återställa vid behov.
3. Samordna med översättare. Förklara vilka kolumner de kan redigera (endast språkkolumner) och vilka kolumner de inte får ändra (block_id, source).
4. Arbeta i mindre batchar vid behov. Om din fil är väldigt stor kan du överväga att dela upp arbetet på flera meddelanden eller köra flera mindre importer.
5. Använd språkstödskoder som stöds. När du lägger till nya språkkolumner ska du använda BCP-47-koder som stöds från artikeln Smarta översättningar för att undvika ”unprocessable”-språk.

Lös valideringsvarningar och importfel

Om du ser varningar eller fel under importvalideringen kan du läsa avsnitten nedan för att förstå vad de betyder och hur du åtgärdar dem.

Ytterligare resurser