Vertalingen in bulk beheren met CSV
Je hebt een betaald Klaviyo-account nodig en Slimme vertalingen ingeschakeld om deze functie te gebruiken.
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:
- Open het bericht dat je wilt updaten (campagne-e-mail, flow-e-mail, sms, WhatsApp-bericht, enz.).
- Klik op Vertalen om de vertaaleditor te openen.
- Open in de vertaaleditor het actiemenu en klik op CSV exporteren.
- In het exportmodaal heb je de optie om te kiezen tussen een Smarting CSV of een CSV
Smartling-csv exporteren
- Je browser downloadt een CSV-bestand dat het volgende bevat:
- De volgende standaard Smartling-directieven:
- # 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.
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 resulterende CSV en importeer je deze opnieuw met de knop importeren.
Een eenvoudige CS exporteren
- Je browser downloadt een CSV-bestand dat het volgende bevat:
- block_id – de unieke identificatiecode voor elke vertaalbare tekenreeks in dit bericht.
- source – de oorspronkelijke brontekst voor die tekenreeks.
- Taalcolumns – één column per taal, benoemd met de taalcode (bijvoorbeeld en, fr, es-MX).
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 deze talen toegevoegd aan de vertaaleditor voor dit bericht als ze worden ondersteund.
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.
- Wijzig de naam van de vereiste kolommen niet (block_id, source en de taalkolommen).
- Wijzig het bestandsformaat niet:
- Bewaar het bestand als een .csv .csv-bestand.
- Sla op met UTF‐8 -codering.
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 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:
- Ga terug naar de vertaaleditor voor hetzelfde bericht.
- Klik op Csv importeren.
- In de importmodal kun je het volgende doen:
- Klik op Bestand selecteren en kies je CSV, of
- Sleep je csv-bestand naar het uploadgebied.
- 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
- Bekijk de samenvatting en waarschuwingen zorgvuldig.
- Als alles er correct uitziet, klik je op Importeren om de wijzigingen toe te passen.
Tijdens de validatie controleert Klaviyo ook op:
- Bestandsgrootte en rijlimieten (bijvoorbeeld: bestanden groter dan 10 MB worden geweigerd).
- Vereiste kolommen (zoals block_id, bron en minimaal één taalkolom).
- Taalcodes die niet worden herkend of niet worden ondersteund door het kanaal.
- Lege vertaalwaarden en andere mogelijke problemen.
Als de validatie mislukt, zie je een foutmelding en kun je een nieuw bestand selecteren zonder wijzigingen aan te brengen in je vertalingen.
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 ten minste één vertaalwaarde verandert.
- Ongewijzigd – rijen die in het CSV-bestand staan, maar waarbij alle waarden overeenkomen met wat al is opgeslagen.
- Genegeerd / overgeslagen – rijen die niet worden geïmporteerd (bijvoorbeeld omdat de block_id niet bestaat in dit bericht of vereiste gegevens ontbreken).
Aantallen worden per rij berekend, niet per taal. Als voorbeeld: als een CSV twee rijen en twee taalkolommen heeft:
- Als één rij in één taal wordt bijgewerkt, is het aantal Bijgewerkt 1.
- Als één rij in beide talen wordt bijgewerkt, is het aantal Bijgewerkt nog steeds 1.
- Als beide rijen in één of alle talen worden bijgewerkt, is het aantal Bijgewerkt 2.
Best practices
Om je vertaalgegevens nauwkeurig en gemakkelijk te beheren:
- Begin met de nieuwste export. Vermijd het hergebruiken van oudere CSV's, vooral nadat je content of talen in het bericht hebt gewijzigd.
- Maak een back-up van elke export. Sla een kopie van de CSV op voordat je wijzigingen aanbrengt, zodat je zo nodig kunt teruggaan.
- Stem af met vertalers. Leg uit welke kolommen ze kunnen bewerken (alleen taalkolommen) en welke kolommen ze niet mogen wijzigen (block_id, source).
- 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.
- Gebruik ondersteunde taalcodes. Gebruik bij het toevoegen van nieuwe taalkolommen 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.
"Vereiste kolommen ontbreken."
Wat het betekent: Een of meer vereiste kolommen (block_id of source) ontbreken of zijn hernoemd.
Wat je moet doen: Zorg ervoor dat de CSV de kolommen block_id en source bevat. Als je gegevens naar een nieuw blad hebt gekopieerd, controleer dan of de koprij overeenkomt met de oorspronkelijke export.
"Je hebt lege vertaalwaarden. Lege tekenreeksen worden behandeld als waarden."
Wat het betekent: je CSV bevat lege vertaalwaarden, en lege tekenreeksen worden behandeld als waarden.
Wat je moet doen: Als je doorgaat, overschrijven die lege cellen alle bestaande vertalingen voor die sleutel en taal. Als je die vertalingen ongewijzigd wilt laten, herstel je de vorige waarden of verwijder je die taalkolom en importeer je het bestand opnieuw.
"<count> sleutel(s) bestaat/bestaan niet in je project en wordt/worden niet meegenomen in het importeren."
Wat het betekent: Sommige block_id -waarden in je CSV bestaan niet voor deze template (bijvoorbeeld als block_id -waarden handmatig zijn bewerkt).
Wat je moet doen: Die rijen worden genegeerd en vertalingen voor die sleutels veranderen niet. Los dit op door die rijen uit de CSV te verwijderen of exporteer indien nodig een nieuw bestand.
"Je bestand bevat dubbele sleutels met conflicterende waarden. De eerste waarde wordt gebruikt."
Wat het betekent: Twee of meer rijen in je CSV hebben dezelfde block_id -waarden (bijvoorbeeld als rijen per ongeluk zijn gedupliceerd).
Wat je moet doen: De waarden van de eerste rij worden gebruikt en de overige dubbele rijen worden genegeerd. Los dit op door de dubbele rijen uit de CSV te verwijderen of exporteer indien nodig een nieuw bestand.
"Meerdere kolommen verwijzen naar dezelfde taal. Alleen de laatste kolom wordt gebruikt en de andere worden genegeerd."
Wat het betekent: twee of meer kolommen in je CSV hebben dezelfde taalcode of komen overeen met dezelfde taal (bijvoorbeeld als een taalkolom per ongeluk is gedupliceerd).
Wat je moet doen: De waarden van de laatste dubbele kolom worden gebruikt en de overige dubbele kolommen worden genegeerd. Los dit op door de dubbele kolommen uit de CSV te verwijderen of exporteer indien nodig een nieuw bestand.
"Je bestand bevat kolommen met taalcodes die niet door dit kanaal worden<invalid language code> ondersteund:. Deze worden genegeerd, maar geldige locales worden geïmporteerd."
Wat dit betekent: Een kolomkop in je CSV gebruikt een taalcode die niet wordt ondersteund of herkend.
Wat je moet doen: om een nieuwe taal toe te voegen, gebruik je een van de ondersteunde BCP-47-codes uit de documentatie voor Slimme vertalingen. Kolommen met niet-ondersteunde codes worden genegeerd.
"Je hebt talen in je bestand die niet in je project staan. De volgende talen worden toegevoegd aan je vertaaleditor: <language detected>."
Wat dit betekent: Je CSV bevat taalkolommen die momenteel geen deel uitmaken van deze template.
Wat je kunt doen:
- Als je die talen wilt toevoegen, bekijk je de lijst en klik je op Importeren om ze toe te voegen aan de vertaaleditor.
- Als je ze niet wilt toevoegen, verwijder je die kolommen en importeer je het bestand opnieuw.
"Geen locale kolommen gevonden."
Wat het betekent: De CSV bevat kolommen block_id en source, maar er is geen andere kolomkop gedetecteerd.
Wat je moet doen: Voeg minstens één ondersteunde taalkolom toe en probeer het opnieuw.
"Geen geldige locale-kolommen gevonden."
Wat het betekent: de CSV bevat de kolommen block_id en source, maar geen geldige taalkolommen.
Wat je moet doen: Voeg minstens één ondersteunde taalkolom toe en probeer het opnieuw.
Als je alleen waarschuwingen ziet en hun impact begrijpt, kun je doorgaan met het importeren. Als je een fout ziet, moet je de CSV corrigeren en opnieuw uploaden voordat je doorgaat. Als je nog steeds fouten ziet, exporteer dan een nieuwe CSV uit de vertaaleditor, maak minimale wijzigingen en probeer nog een import om het probleem te isoleren.
Als je na het controleren van deze items nog steeds fouten ziet, exporteer dan een nieuw CSV-bestand uit de vertaaleditor, breng minimale wijzigingen aan en probeer nog een import om te achterhalen welke wijziging het probleem veroorzaakt.