So verwaltest du Übersetzungen in Bulk mit CSV
Du brauchst ein kostenpflichtiges Klaviyo-Konto und aktivierte Smart Translations, um diese Funktion zu nutzen.
Verwalte Übersetzungen außerhalb von Klaviyo, indem du eine CSV-Datei exportierst und bearbeitest und sie dann wieder importierst, um Übersetzungen gesammelt zu aktualisieren oder mit anderen zusammenzuarbeiten.
CSV deiner Übersetzungen exportieren
Befolge diese Schritte, um die aktuellen Übersetzungen für eine einzelne Nachricht zu exportieren:
- Öffne die Nachricht, die du aktualisieren möchtest (Kampagnen-E-Mail, Flow-E-Mail, SMS, WhatsApp-Nachricht usw.).
- Klick auf Übersetzen, um den Übersetzungseditor zu öffnen.
- Öffne im Übersetzungseditor das Aktionsmenü und klicke auf CSV exportieren.
- Im Export-Modal hast du die Option, zwischen einer Smarting CSV oder einer CSVauszuwählen
Smartling-CSV exportieren
- Dein Browser lädt eine CSV-Datei herunter, die Folgendes enthält:
- Die folgenden standardmäßigen Smartling-Direktiven:
- # smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE - block_id – die eindeutige Kennung für jede übersetzbare Zeichenfolge in dieser Nachricht.
- Code der Ausgangssprache (z. B. en) – der ursprüngliche Ausgangstext für diesen String.
Du kannst diese Datei unverändert verwenden, um deine Strings in Smartling zu importieren. Smartling analysiert die CSV automatisch, extrahiert die Strings und ermöglicht dir, Übersetzungsjobs zu starten.
Nachdem der Job abgeschlossen ist, lade die resultierende CSV herunter und importiere sie über die Schaltfläche Importieren wieder.
Exportieren eines einfachen CS
- Dein Browser lädt eine CSV-Datei herunter, die Folgendes enthält:
- block_id – die eindeutige Kennung für jede übersetzbare Zeichenfolge in dieser Nachricht.
- source – der ursprüngliche Quelltext für diese Zeichenfolge.
- Sprachspalten – eine Spalte pro Sprache, benannt mit ihrem Sprachcode (z. B. en, fr, es-MX).
Du kannst diese Datei jetzt in Excel, Google Sheets oder einem anderen Tabellenkalkulationsprogramm öffnen.
Die CSV aktualisieren
Wenn du die CSV bearbeitest, musst du nur in den Sprachspalten arbeiten.
Bearbeite, füge keine Werte hinzu und lösche keine Werte in der Spalte block_id. Wenn eine Zeile eine ungültige oder fehlende block_id hat, wird diese Zeile beim Import ignoriert und ihre Übersetzungen werden nicht aktualisiert.
Was du sicher ändern kannst
In der CSV:
- Bestehende Übersetzungen aktualisieren, indem die entsprechende Sprachspalte bearbeitet wird.
- Fehlende Übersetzungen hinzufügen, indem leere Zellen für eine Sprachspalte ausgefüllt werden.
- Lass die Werte einer Sprache unverändert, wenn du diese Sprache nicht aktualisieren möchtest.
- Eine oder mehrere neue Sprachspalten hinzufügen:
- Einen gültigen BCP-47-Sprachcode verwenden (z. B. fr-CA, de, ca).
- Beim Import werden diese Sprachen dem Übersetzungseditor für diese Nachricht hinzugefügt, sofern sie unterstützt werden.
Was du nicht ändern solltest
Vermeide Folgendes:
- Bearbeite oder lösche keine block_id-Werte.
- Füge keine Zeilen hinzu. Jede Zeile muss weiterhin einer vorhandenen übersetzbaren Zeichenfolge in der Nachricht zugeordnet werden.
- Ändere die Quellwerte in der CSV nicht:
- Um den Quellinhalt zu ändern, bearbeite die Nachricht direkt im Klaviyo-Editor und exportiere dann eine neue CSV.
- Benenn die erforderlichen Spalten nicht um (block_id, source und die Sprachspalten).
- Ändere das Dateiformat nicht:
- Die Datei als .csv beibehalten Datei zu exportieren
- Speichere in UTF‐8 -Codierung.
Umgang mit leeren Zellen
Wenn du eine Übersetzungszelle in der CSV löschst und sie leer lässt:
- Der Import behandelt diese leere Zeichenfolge als Wert.
- Die vorhandene Übersetzung für diese Zelle wird durch einen leeren Wert überschrieben. Dadurch kann eine Übersetzung effektiv entfernt werden.
Wenn du vermeiden möchtest, eine Übersetzung zu ändern, lass ihren bestehenden Wert in der CSV-Datei stehen oder entferne diese Sprachspalte vor dem Import vollständig.
Wenn du mit dem Bearbeiten fertig bist, speichere die Datei als UTF‐8-codierte .csv.
CSV-Datei importieren
Nachdem du deine CSV aktualisiert und gespeichert hast:
- Kehre zum Übersetzungseditor für dieselbe Nachricht zurück.
- Klicke auf CSV importieren.
- Im Importmodal entweder:
- Klicke auf Datei auswählen und wähle deine CSV aus oder
- Ziehe deine CSV-Datei per Drag-and-Drop in den Upload-Bereich.
- Klaviyo führt einen Validierungs-„Probelauf“ durch und zeigt:
- Eine Zusammenfassung darüber, wie viele Zeilen aktualisiert, unverändert oder ignoriert werden
- Alle erkannten Warnungen oder Fehler
- Überprüfe die Zusammenfassung und Warnungen sorgfältig.
- Wenn alles korrekt aussieht, auf Importieren klicken, um die Änderungen anzuwenden.
Während der Validierung prüft Klaviyo außerdem Folgendes:
- Dateigröße und Zeilenbeschränkungen (z. B. werden Dateien mit einer Größe von mehr als 10 MB abgelehnt).
- Erforderliche Spalten (z. B. block_id, source und mindestens eine Sprachspalte).
- Sprachcodes, die vom Kanal nicht erkannt oder nicht unterstützt werden.
- Leere Übersetzungswerte und andere potenzielle Probleme.
Wenn die Validierung fehlschlägt, wird eine Fehlermeldung angezeigt, und du kannst eine neue Datei auswählen, ohne Änderungen an deinen Übersetzungen vorzunehmen.
Importergebnisse verstehen
Nach der Validierung zeigt die Importzusammenfassung, was passiert, wenn du fortfährst.
Zusammenfassungszahlen
Die Zusammenfassung kann Zählungen enthalten, wie zum Beispiel:
- Aktualisiert – die Anzahl der Zeilen, in denen sich mindestens ein Übersetzungswert ändert.
- Unverändert – Zeilen, die in der CSV vorhanden sind, bei denen aber alle Werte mit den bereits gespeicherten übereinstimmen.
- Ignoriert/übersprungen – Zeilen, die nicht importiert werden (zum Beispiel, weil die block_id in dieser Nachricht nicht existiert oder erforderliche Daten fehlen).
Die Zählwerte werden pro Zeile berechnet, nicht pro Sprache. Wenn eine CSV-Datei beispielsweise zwei Zeilen und zwei Sprachspalten hat:
- Wenn eine Zeile in einer Sprache aktualisiert wird, beträgt die Anzahl Aktualisiert 1.
- Wenn eine Zeile in beiden Sprachen aktualisiert wird, ist die Anzahl Aktualisiert trotzdem 1.
- Wenn beide Zeilen in einer oder allen Sprachen aktualisiert werden, beträgt die Anzahl Aktualisiert 2.
Best Practices
Damit deine Übersetzungsdaten korrekt und einfach zu verwalten sind:
- Starte mit dem neuesten Export. Vermeide es, ältere CSV-Dateien wiederzuverwenden, insbesondere nachdem du Inhalte oder Sprachen in der Nachricht geändert hast.
- Eine Sicherungskopie jedes Exports aufbewahren. Eine Kopie der CSV speichern, bevor Änderungen vorgenommen werden, damit bei Bedarf ein Rollback möglich ist.
- Stimme dich mit Übersetzer*innen ab. Erkläre, welche Spalten sie bearbeiten können (nur Sprachspalten) und welche Spalten sie nicht ändern dürfen (block_id, source).
- Arbeite bei Bedarf in kleineren Batches. Wenn deine Datei sehr groß ist, kannst du die Arbeit auf mehrere Nachrichten aufteilen oder mehrere kleinere Importe ausführen.
- Verwende unterstützte Sprachcodes. Wenn du neue Sprachspalten hinzufügst, verwende unterstützte BCP-47-Codes aus dem Smart Translations -Artikel, um „nicht verarbeitbare“ Sprachen zu vermeiden.
Validierungswarnungen und Importfehler beheben
Wenn du während der Importvalidierung Warnungen oder Fehler siehst, sieh dir die folgenden Abschnitte an, um zu verstehen, was sie bedeuten und wie du sie beheben kannst.
„Erforderliche Spalten fehlen.“
Was das bedeutet: Eine oder mehrere erforderliche Spalten (block_id oder source) fehlen oder wurden umbenannt.
Was zu tun ist: Sicherstellen, dass die CSV die Spalten block_id und source enthält. Wenn Daten in ein neues Tabellenblatt kopiert wurden, bestätigen, dass die Kopfzeile mit dem ursprünglichen Export übereinstimmt.
„Du hast leere Übersetzungswerte. Leere Zeichenfolgen werden als Werte behandelt.“
Was das bedeutet: Deine CSV hat leere Übersetzungswerte, und leere Zeichenfolgen werden als Werte behandelt.
Was du tun solltest: Wenn du fortfährst, überschreiben diese leeren Zellen alle vorhandenen Übersetzungen für diesen Schlüssel und diese Sprache. Wenn du diese Übersetzungen unverändert lassen möchtest, stelle die vorherigen Werte wieder her oder entferne diese Sprachspalte und importiere die Datei erneut.
„<count> Schlüssel(e) ist/sind in deinem Projekt nicht vorhanden und wird/werden nicht in den Import einbezogen.“
Was das bedeutet: Einige block_id -Werte in deiner CSV sind für diese Vorlage nicht vorhanden (z. B., wenn block_id -Werte manuell bearbeitet wurden).
Was zu tun ist: Diese Zeilen werden ignoriert, und Übersetzungen für diese Schlüssel ändern sich nicht. Um das zu beheben, entferne diese Zeilen aus der CSV oder exportiere bei Bedarf eine neue Datei.
„Deine Datei enthält doppelte Schlüssel mit widersprüchlichen Werten. Der erste Wert wird verwendet.“
Was das bedeutet: Zwei oder mehr Zeilen in deiner CSV haben dieselben block_id -Werte (zum Beispiel, wenn Zeilen versehentlich dupliziert wurden).
Vorgehensweise: Die Werte der ersten Zeile werden verwendet und die übrigen doppelten Zeilen werden ignoriert. Um das zu beheben, entferne die doppelten Zeilen aus der CSV oder exportiere bei Bedarf eine neue Datei.
„Mehrere Spalten sind derselben Sprache zugeordnet. Nur die letzte Spalte wird verwendet und die anderen werden ignoriert.“
Was das bedeutet: Zwei oder mehr Spalten in deiner CSV haben denselben Sprachcode oder werden auf dieselbe Sprache aufgelöst (zum Beispiel, wenn eine Sprachspalte versehentlich dupliziert wurde).
Vorgehensweise: Die Werte der letzten doppelten Spalte werden verwendet und die übrigen doppelten Spalten werden ignoriert. Entferne zur Behebung die doppelten Spalten aus der CSV oder exportiere bei Bedarf eine neue Datei.
„Deine Datei enthält Spalten mit Sprachcodes, die von diesem Kanal nicht unterstützt werden: <invalid language code>. Diese werden ignoriert, aber gültige Gebietsschemata werden importiert.“
Das bedeutet: Eine Spaltenüberschrift in deiner CSV verwendet einen Sprachcode, der nicht unterstützt oder erkannt wird.
Was zu tun ist: Um eine neue Sprache hinzuzufügen, verwende einen der unterstützten BCP-47-Codes aus der Smart Translations -Dokumentation. Spalten mit nicht unterstützten Codes werden ignoriert.
„Deine Datei enthält Sprachen, die nicht in deinem Projekt enthalten sind. Die folgenden Sprachen werden zu deinem Übersetzungs-Editor hinzugefügt: <language detected>.“
Was es bedeutet: Deine CSV enthält Sprachspalten, die derzeit nicht Teil dieser Vorlage sind.
Vorgehensweise:
- Wenn du diese Sprachen hinzufügen möchtest, sieh dir die Liste an und klicke auf Importieren, um sie dem Übersetzungseditor hinzuzufügen.
- Wenn du sie nicht hinzufügen möchtest, entferne diese Spalten und importiere die Datei erneut.
„Keine Sprachspalten gefunden.“
Das bedeutet: Die CSV enthält block_id - und source -Spalten, aber es wurde keine andere Spaltenüberschrift erkannt.
Was zu tun ist: Mindestens eine unterstützte Sprachspalte hinzufügen und es noch einmal versuchen.
„Keine gültigen Sprachspalten gefunden.“
Was das bedeutet: Die CSV enthält die Spalten block_id und source, aber keine gültigen Sprachspalten.
Was zu tun ist: Mindestens eine unterstützte Sprachspalte hinzufügen und es noch einmal versuchen.
Wenn nur Warnungen angezeigt werden und ihre Auswirkungen verstanden werden, kann mit dem Import fortgefahren werden. Wenn ein Fehler angezeigt wird, muss die CSV korrigiert und vor dem Fortfahren erneut hochgeladen werden. Wenn weiterhin Fehler auftreten, exportiere eine neue CSV aus dem Übersetzungseditor, nimm minimale Änderungen vor und versuche einen weiteren Import, um das Problem einzugrenzen.
Wenn nach der Überprüfung dieser Punkte weiterhin Fehler angezeigt werden, exportiere eine neue CSV aus dem Übersetzungseditor, nimm minimale Änderungen vor und versuche einen weiteren Import, um einzugrenzen, welche Änderung das Problem verursacht.