Vertalingen in bulk beheren met CSV

Beheer vertalingen buiten Klaviyo door een CSV-bestand te exporteren en te bewerken, en het vervolgens weer te importeren om vertalingen in bulk bij te werken of met anderen samen te werken.

Een CSV exporteren van je vertalingen

Volg deze stappen om de huidige vertalingen voor één bericht te exporteren:

1. Open het bericht dat je wilt updaten (campagne-e-mail, flow-e-mail, sms, WhatsApp-bericht, enz.).
2. Klik op het Vertalen -pictogram of de knop van het bericht, of op de knop waarop het aantal vertalingen staat, om de vertaaleditor te openen. Als het bericht nog niet is vertaald, rond je eerst de taalinstelling af.
3. Open in de vertaaleditor het menu met acties met de drie puntjes en klik op Exporteren.

4. Onder Indeling voor export selecteren kies je CSV. Laat Smartling compatible geselecteerd als je het bestand naar Smartling gaat sturen, of schakel dit uit om een standaard CSV te bewerken in een spreadsheet.

5. Kies onder Talen om te exporteren Alles selecteren om alle bestaande vertaaltaalopties op te nemen, of Aangepaste selectie om specifieke talen te kiezen. Om alleen de brontekst te exporteren voor een vertaler, kies je de optie om alleen de brontaal te exporteren. De brontaal is opgenomen in elke export.
6. Klik op Exporteren om het CSV-bestand te downloaden.

Smartling-csv

Een CSV die compatibel is met Smartling bevat:

Smartling-richtlijnen bovenaan het bestand, waaronder:

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

• block_id – de unieke identificatiecode voor elke vertaalbare tekenreeks in dit bericht.
• Brontaalcode (bijv. en) – de oorspronkelijke brontekst voor die tekenreeks.
• Taalkolommen voor de vertaal­talen die je hebt geselecteerd, indien van toepassing.

Je kunt dit bestand ongewijzigd gebruiken om je strings te importeren in Smartling. Smartling parseert de CSV automatisch, haalt de strings eruit en laat je vertaalopdrachten starten.

Nadat de taak is voltooid, download je de vertaalde CSV. Voordat je het in Klaviyo importeert, verwijder je eventuele # smartling. -instructierijen aan het begin, zodat de eerste rij de kolomkoppen bevat. Behoud de kolom block_id, de brontaal­kolom en minimaal 1 ondersteunde vertaaltaal­kolom. Volg daarna importeer het CSV-bestand hieronder.

Standard csv

Een standaard CSV bevat:

• block_id – de unieke identificatiecode voor elke vertaalbare tekenreeks in dit bericht.
• source – de oorspronkelijke brontekst voor die tekenreeks.
• Taalkolommen: 1 kolom per vertaaltaal die je hebt geselecteerd, met als naam de taalcode (bijvoorbeeld en, fr, es-MX). Een export met alleen brontekst heeft geen kolommen voor vertaaltalen.

Je kunt dit bestand nu openen in Excel, Google Sheets of een andere spreadsheet-editor.

Werk de CSV bij

Wanneer je de CSV bewerkt, hoef je alleen in de taalkolommen te werken.

Bewerk, voeg geen waarden toe en verwijder geen waarden in de kolom block_id. Als een rij een ongeldige of ontbrekende block_id heeft, wordt die rij tijdens het importeren genegeerd en worden de vertalingen niet bijgewerkt.

Wat je veilig kunt wijzigen

In de CSV:

• Bewerk de juiste taalkolom om bestaande vertalingen bij te werken.
• Voeg ontbrekende vertalingen toe door lege cellen voor een taalkolom in te vullen.
• Laat de waarden van een taal ongewijzigd als je die taal niet wilt bijwerken.
• Voeg een of meer nieuwe taalkolommen toe:
  • Gebruik een geldige BCP‐47-taalcode (bijvoorbeeld fr-CA, de, ca).
  • Bij het importeren worden ondersteunde talen met nieuwe vertaalwaarden toegevoegd aan de vertaaleditor voor dit bericht.

Wat je niet moet wijzigen

Vermijd het volgende:

• Bewerk of verwijder block_id-waarden niet.
• Voeg geen rijen toe. Elke rij moet gekoppeld blijven aan een bestaande vertaalbare tekenreeks in het bericht.
• Wijzig de bronwaarden in de CSV niet:
  • Om de broncontent te wijzigen, bewerk je het bericht rechtstreeks in de Klaviyo-editor en exporteer je daarna een nieuwe CSV.
• Laat de kolomkoppen block_id en source ongewijzigd. Houd in een Smartling CSV de kolomkop in de brontaal aan in plaats van source. Label elke vertaaltalige kolom met de ondersteunde taalcode.
• Wijzig het bestandsformaat niet:
  • Bewaar het bestand als een .csv .csv-bestand.
  • Sla op met UTF‐8 -codering.

Laat templatetags, zoals {{ first_name }} en {% if ... %}, ongewijzigd in elke vertaling. Als deze placeholders afwijken van het bronbericht, blokkeert de validatie het importeren.

Omgaan met lege cellen

Als je een vertaalcel in de CSV leegmaakt en leeg laat:

• De import behandelt die lege tekenreeks als een waarde.
• De bestaande vertaling voor die cel wordt overschreven met een lege waarde. Dit kan een vertaling effectief verwijderen.

Als het wissen van een cel ook placeholders verwijdert die in de bron aanwezig zijn, blokkeert validatie de import. Zet de placeholders terug of verwijder die taalkolom voordat je importeert.

Als je een vertaling niet wilt wijzigen, laat je de bestaande waarde in het CSV-bestand staan of verwijder je die taalkolom volledig voordat je importeert.

Als je klaar bent met bewerken, sla je het bestand op als een UTF-8-gecodeerde .csv.

Importeer de CSV

Nadat je je CSV hebt bijgewerkt en opgeslagen:

1. Ga terug naar de vertaaleditor voor hetzelfde bericht.
2. Open het actiemenu met 3 puntjes en klik op CSV importeren.
3. In de importmodal kun je het volgende doen:

• Klik op Bestand selecteren en kies je CSV, of
• Sleep je csv-bestand naar het uploadgebied.

4. Klik op Volgende om het bestand te valideren en een voorbeeld van de wijzigingen te bekijken.

Klaviyo voert een validatie-"dry run" uit en laat het volgende zien:

• Een samenvatting van hoeveel rijen worden bijgewerkt, ongewijzigd blijven of worden genegeerd
• Alle waarschuwingen of fouten die zijn gedetecteerd

1. Bekijk de samenvatting en waarschuwingen zorgvuldig.
2. Als alles er correct uitziet, klik je op Importeren om de wijzigingen toe te passen.

Wanneer het importeren is gelukt, sluit de modal en worden je vertalingen bijgewerkt in de vertalingseditor. Bekijk de geïmporteerde vertalingen.

Tijdens de validatie controleert Klaviyo ook op:

• Bestandstype en codering: gebruik een met UTF-8 gecodeerde CSV.
• CSV-kolommen: behoud block_id, de bronkolom (of de bron-taalkolom voor Smartling), en minstens 1 ondersteunde vertaaltaalkolom.
• Taalcodes die niet worden herkend of niet worden ondersteund door het kanaal.
• Lege vertaalwaarden en andere mogelijke problemen.
• Personalisatievariabelen en templatetags die verschillen van het bronbericht.

Als de validatie mislukt, zie je een foutmelding. Klik op Nieuw bestand selecteren nadat je de CSV hebt gecorrigeerd om het opnieuw te proberen; validatie wijzigt je vertalingen niet.

Importresultaten begrijpen

Na de validatie laat de importsamenvatting zien wat er gebeurt als je doorgaat.

Totalen in samenvatting

De samenvatting kan aantallen bevatten, zoals:

• Bijgewerkt: het aantal rijen waarbij minstens 1 vertaalwaarde verandert.
• Overgeslagen (ongewijzigd): rijen in de CSV waarbij alle opgenomen vertaalwaarden overeenkomen met wat al is opgeslagen.
• Genegeerd: rijen die niet worden geïmporteerd, zoals dubbele rijen na de eerste keer dat ze voorkomen of rijen waarvan de block_id niet bestaat in dit bericht.

Best practices

Om je vertaalgegevens nauwkeurig en gemakkelijk te beheren:

1. Begin met de nieuwste export. Vermijd het hergebruiken van oudere CSV's, vooral nadat je content of talen in het bericht hebt gewijzigd.
2. Maak een back-up van elke export. Sla een kopie van de CSV op voordat je wijzigingen aanbrengt, zodat je zo nodig kunt teruggaan.
3. Stem af met vertalers. Leg uit welke kolommen ze kunnen bewerken (alleen taalkolommen) en welke kolommen ze niet mogen wijzigen (block_id, source).
4. Werk indien nodig in kleinere batches. Als je bestand erg groot is, overweeg dan om het werk te verdelen over meerdere berichten of om meerdere kleinere imports uit te voeren.
5. Gebruik ondersteunde taalcodes. Wanneer je nieuwe taalkolommen toevoegt, gebruik je ondersteunde BCP-47-codes uit het artikel Slimme vertalingen om “niet-verwerkbare” talen te voorkomen.

Los validatiewaarschuwingen en importfouten op

Als je waarschuwingen of fouten ziet tijdens de importvalidatie, bekijk dan de onderstaande secties om te begrijpen wat ze betekenen en hoe je ze kunt oplossen.

Extra hulpbronnen