Woordenlijsttermen in bulk importeren met csv
Je moet een betaald Klaviyo-account hebben en Slimme vertalingen hebben ingeschakeld om deze functies te gebruiken.
Een bestaande woordenlijst importeren
De functie Slimme vertalingen van Klaviyo gebruikt een woordenlijst om te bepalen hoe specifieke termen worden vertaald – merknamen, productnamen, slogans of technische termen die in elke campagne een consistente vertaling nodig hebben.
Als je al een woordenlijst bijhoudt in een ander vertaalsysteem (DeepL, Lokalise, Phrase, een intern spreadsheet), kun je die rechtstreeks in Klaviyo importeren als CSV in plaats van elke vermelding handmatig opnieuw aan te maken.
Wanneer je CSV-import gebruikt
CSV-import is handig wanneer je:
- Breng een bestaande woordenlijst vanuit een TMS (Translation Management System), zoals DeepL, Lokalise, Phrase of memoQ, in Klaviyo.
- Voeg in één keer een grote batch termen toe (tientallen of honderden), in plaats van ze allemaal afzonderlijk in de UI te typen.
- Migreer een woordenlijst die wordt bijgehouden in een gedeeld spreadsheet naar één single source of truth in Klaviyo.
Voor maar een handjevol termen is het meestal sneller om ze handmatig één voor één toe te voegen in het woordenlijstpaneel.
Importeren is eenrichtingsverkeer. Je uploadt termen naar Klaviyo, maar op dit moment is er geen CSV-export. Bewaar een kopie van je bronbestand als je een back-up nodig hebt.
Je csv-bestand voorbereiden
Bestandsindeling
- Codering: UTF-8
- Bestandstype: .csv
- Scheidingsteken: komma (,)
- Koprij: vereist (zie hieronder)
Voorbeeldbestand
Bronterm | Doelterm | bronlandinstelling | doeltaalinstelling |
|---|---|---|---|
hallo | bonjour | EN | FR |
hallo | hallo | EN | de |
tschüß | tot ziens | de | EN |
Vereiste kolommen
Elke rij moet vier kolommen bevatten:
source term— de term in de brontaaltarget term– hoe de term moet worden vertaaldsource locale— de BCP-47-locale tag van de brontaaltarget locale— de BCP-47-locale tag van de doeltaal
Alle vier de headers moeten in de eerste rij van het bestand staan. De volgorde van de kolommen maakt niet uit.
Landinstellingscodes (BCP-47)
Locale-codes volgen de BCP-47 -standaard. De meest voorkomende vorm is een taalcode van twee letters, eventueel gevolgd door een regio:
en— Engelsen-US– Engels (Verenigde Staten)en-GB— Engels (Verenigd Koninkrijk)fr– Fransfr-CA– Frans (Canada)de– Duitsja– Japanspt-BR– Portugees (Brazilië)
Gebruik de meest specifieke tag die overeenkomt met de landinstelling die je in Klaviyo hebt geconfigureerd.
Meerdere taalparen in één bestand
Eén CSV kan items bevatten voor veel taalparen. Elke rij wordt onafhankelijk behandeld, dus je kunt taalparen vrij combineren:
Bronterm | Doelterm | bronlandinstelling | doeltaalinstelling |
|---|---|---|---|
hallo | bonjour | EN | FR |
hallo | hola | EN | es |
hallo | hallo | EN | de |
bonjour | goedemorgen | FR | es |
Dit is handig als je één masterglossary bijhoudt die vertalingen in meerdere talen aanstuurt.
Woordenlijsttermen zijn symmetrisch
Elk woordenboekitem definieert een bidirectionele equivalentie tussen termen. Als je importeert:
Bronterm | Doelterm | bronlandinstelling | doeltaalinstelling |
|---|---|---|---|
hallo | bonjour | EN | FR |
Klaviyo zal:
- Vertaal
helloalsbonjourbij het vertalen van Engels → Frans. - Vertaal
bonjouralshellobij het vertalen van Frans → Engels.
Dit betekent dat je geen asymmetrische koppelingen kunt definiëren, zoals:
Bronterm | Doelterm | bronlandinstelling | doeltaalinstelling |
|---|---|---|---|
hallo | bonjour | EN | FR |
bonjour | hallo | FR | EN |
Beide rijen wijzen bonjour toe aan een andere Engelse term, wat een conflict is. Er is maar één mapping per combinatie van taalinstelling-taalpaar-term toegestaan. De importeur slaat de conflicterende rij over en meldt een fout (zie Problemen met importfouten oplossen).
Als je voor bonjour afhankelijk van de context verschillende Engelse vertalingen nodig hebt, zijn woordenlijsttermen niet de juiste tool – die zijn bedoeld voor termen die elke keer op dezelfde manier worden vertaald.
Importmodi
Wanneer je importeert, kies je een van de twee modi:
- Toevoegen – Bestaande woordenlijstvermeldingen blijven behouden. Nieuwe vermeldingen uit de CSV worden toegevoegd. Rijen die conflicteren met bestaande vermeldingen worden overgeslagen.
- Alles vervangen — Je huidige woordenlijst wordt volledig verwijderd en vervangen door de inhoud van de CSV.
Alles vervangen verwijdert de volledige huidige woordenlijst.
Gebruik Alles vervangen alleen als je er zeker van bent dat de CSV de nieuwe bron van waarheid is. Er is geen optie om dit ongedaan te maken.
Importeer het bestand
1. Ga naar Account → Instellingen → Vertalingen → Woordenlijst.
2. Klik op Csv importeren.
3. Kies in het dialoogvenster Toevoegen of Alles vervangen.
4. Klik op het bestandsgebied en selecteer je .csv -bestand (of sleep het bestand naar het gebied).
5. Klik op Volgende. Klaviyo valideert het bestand, maar slaat nog niets op. Je ziet een voorbeeldscherm.
6. Bekijk de preview:
- Totaal aantal rijen – hoeveel rijen er in het bestand stonden.
- Geldige items – hoeveel er worden geïmporteerd.
- Overgeslagen rijen — hoeveel zijn er verwijderd vanwege validatieproblemen.
7. Als er waarschuwingen verschijnen, kun je alsnog doorgaan, of teruggaan en eerst het bestand corrigeren.
8. Klik op Importeren om de wijzigingen op te slaan.
Als er iets mis is met het bestand, zie je een scherm met Import mislukt in plaats van de preview.
Importfouten oplossen
Wanneer het importeren mislukt, toont Klaviyo een of meer foutmeldingen waarin wordt uitgelegd wat er misging. Sommige fouten zijn van toepassing op het hele bestand; andere verwijzen naar een specifieke rij.
Fouten op bestandsniveau
Hierdoor wordt de import volledig gestopt. Los ze op en probeer het opnieuw.
"Het geüploade bestand is leeg."
Wat het betekent: Het bestand bevat geen inhoud.
Wat je moet doen: zorg dat het bestand niet 0 bytes is en minstens één rij plus de kopregel bevat.
"Ontbrekende vereiste koppen."
Wat het betekent: De koprij bevat niet alle vier vereiste kolommen.
Wat je moet doen: Controleer of de eerste rij source term, target term, source locale en target locale bevat. De kopvolgorde maakt niet uit; de spelling wel.
"Geen geldige woordenlijstitems."
Wat het betekent: Na validatie kon er geen rij worden geïmporteerd.
Wat je moet doen: Open het bestand en controleer of de gegevensrijen overeenkomen met de verwachte indeling.
"Coderingsfout."
Wat het betekent: Het bestand is niet gecodeerd in UTF-8
Wat je moet doen: sla het bestand opnieuw op vanuit je spreadsheettool met UTF-8-codering. Gebruik in Excel Opslaan als → CSV UTF-8.
"Een term overschrijdt de maximale lengte."
Wat het betekent: een of meer termen zijn te lang.
Wat je moet doen: Woordenlijsttermen moeten korte zinsdelen zijn. Kort heel lange items in of maak er een splitsing van.
Fouten op rijniveau
Deze markeren een specifieke rij. De rest van het bestand kan nog steeds worden geïmporteerd — de onjuiste rij wordt overgeslagen.
"Rij N: onverwacht aantal kolommen"
Wat het betekent: De rij heeft te weinig of te veel door komma's gescheiden waarden.
Wat je moet doen: Controleer de rij in je CSV – extra komma's binnen een term moeten tussen aanhalingstekens staan ("hello, world").
"Rij N: lege termwaarde"
Wat dit betekent: de bron- of doeltaaltermcel is leeg.
Wat je moet doen: Vul de ontbrekende term in of verwijder de rij.
"Rij N: lege landcode"
Wat het betekent: De cel voor de bron- of doellocatie is leeg.
Wat te doen: de ontbrekende locale invullen (bijv. en, fr-CA).
"Rij N: niet-herkende locale code"
Wat het betekent: de locale-tekenreeks is geen geldige BCP-47-tag.
Wat je moet doen: gebruik een standaard landinstellingscode zoals en, fr, de, pt-BR. Zie Landinstellingscodes.
"Rij N: dubbele kolom met landinstellingen gedetecteerd"
Wat het betekent: dezelfde taalinstelling komt meer dan één keer voor in één invoercontext.
Wat je moet doen: elke rij heeft unieke bron- en doeltaalinstellingen nodig — je kunt en → en niet vertalen.
"Rij N: conflicterende vertaling voor dezelfde term en locale"
Wat het betekent: de rij probeert dezelfde brontekstterm te koppelen aan een ander doel dan een andere rij in het bestand.
Wat je moet doen: Bepaal welke vertaling correct is en verwijder het duplicaat.
"Rij N: de term komt al voor in een bestaande vermelding"
Wat het betekent: De rij probeert een vertaling te definiëren die in strijd is met een term die al in je woordenlijst staat (alleen in de modus Toevoegen).
Wat je moet doen: Werk het bestaande item bij in de UI, of gebruik de modus Alles vervangen als het nieuwe bestand correct is.
"Rij N: een voorgaand formuleteken is om veiligheidsredenen verwijderd"
Wat het betekent: Een term begon met =, +, - of @, wat spreadsheet-apps zouden interpreteren als een formule.
Wat te doen: Dit is een waarschuwing, geen mislukking. De term wordt geïmporteerd met het hoofdteken verwijderd. Als je het karakter nodig hebt, wikkel de term in citaten.
Algemene validatiefout
Als je “Er is een validatiefout opgetreden. Controleer je bestand en probeer het opnieuw.” ziet, is er bij het importeren een probleem opgetreden dat niet kon worden gecategoriseerd. Controleer nogmaals of het bestand overeenkomt met de verwachte indeling en neem contact op met support als de fout zich blijft voordoen.