Die Locize-API mit Emailify nutzen

Wenn du Locize nutzt, kann Emailify die Ausgangstexte deiner E-Mail-Designs in einen Locize-Namespace hochladen und übersetzte Varianten zurück nach Figma importieren.

Bevor du loslegst

Du brauchst:

• Ein Locize-Projekt mit einer Referenzsprache und mindestens einer Zielsprache.
• Eine bestehende Version und einen bestehenden Namespace für deine E-Mail-Übersetzungen.
• Einen projektbezogenen Locize-API-Schlüssel.

Schritt 1: Dein Locize-Projekt verbinden

1. Klick in Emailify auf den Button Localize.
2. Wähle in den Lokalisierungsoptionen Locize API.
3. Gib deine Project ID und deinen API Key ein.
4. Gib die Locize-Version ein, die du verwenden willst, zum Beispiel latest oder production.
5. Gib den Namespace ein, der deine E-Mail-Übersetzungen enthält, zum Beispiel emails.
6. Wähle die Option Standard CDN oder Pro CDN, die zu deinem Locize-Projekt passt.
7. Lege unter String Key Source fest, wie Emailify die String-Keys in Locize anlegen soll.

Sobald Emailify verbunden ist, zeigt es die Referenzsprache und die Zielsprachen an, die in deinem Locize-Projekt eingerichtet sind.

Achte darauf, dass der CDN-Typ zu deinem Locize-Projekt passt. Das Standard CDN ist öffentlich und nutzt einen festen Cache von einer Stunde, während das Pro CDN privates Veröffentlichen und konfigurierbares Caching unterstützt. Mehr dazu findest du im CDN-Vergleich von Locize.

Festlegen, wie String-Keys in Locize angelegt werden

Figma Node ID (Default) behält das bisherige Verhalten von Emailify bei und verwendet erzeugte Figma-Node-IDs als Locize-Keys. Bestehende Locize-Workflows nutzen weiterhin diese Option, solange du sie nicht änderst.

Wähle Figma Text Layer Name, wenn die Namen deiner Figma-Textebenen bereits den String-Keys in deinem Locize-Namespace entsprechen. Emailify übernimmt den vollständigen Ebenennamen samt Punkten, sodass eine Ebene namens templates.assistant_invited.h01 genau diesen Locize-Key verwendet.

Jede einbezogene Textebene muss einen Namen haben, der in allen ausgewählten E-Mails eindeutig ist. Emailify stoppt den Upload oder Import und nennt doppelte Keys, bevor Ausgangsstrings an Locize gesendet werden. Keys für Links und Bild-Alt-Texte verwenden den Namen der Text- oder Bildebene mit dem Emailify-Suffix _LINK oder _ALT_TEXT. Zeilen für Betreff und Preheader verwenden weiterhin ihre von Emailify erzeugten Keys, weil sie E-Mail-Metadaten und keine Figma-Textebenen sind.

Schritt 2: Deine E-Mails und Zielsprachen auswählen

Wähle die Emailify-Frames aus, die du lokalisieren willst, und dann die Locize-Zielsprachen, die du später importieren willst.

Lass Import Markdown Formatting aktiviert, wenn deine E-Mail-Texte fetten, kursiven oder verlinkten Text oder Zeilenumbrüche enthalten, die beim Hin und Zurück der Übersetzung erhalten bleiben sollen.

Schritt 3: Die Referenztexte zu Locize hochladen

Klick auf Upload, um die ausgewählten Emailify-Texte in der in Locize eingerichteten Referenzsprache an deinen Namespace zu senden. Wenn du die Ausgangstexte später in Figma änderst, lade sie erneut hoch, um die zugehörigen Locize-Keys zu aktualisieren.

Schritt 4: In Locize übersetzen

Öffne dein Locize-Projekt und übersetze oder prüfe die hochgeladenen Keys für jede Zielsprache.

Schritt 5: Übersetzte E-Mails in Figma importieren

Geh zurück zu Emailify, wähle die gewünschten Zielsprachen aus und klick auf Import Translations. Emailify ordnet die übersetzten Locize-Keys den ausgewählten Ausgangs-E-Mails zu und erstellt für jede importierte Sprache geklonte E-Mail-Frames.

Emailify speichert deinen Locize-API-Schlüssel für deinen aktuellen Nutzer im lokalen Client-Speicher von Figma, nicht in der geteilten Figma-Datei. Verwende einen projektbezogenen API-Schlüssel statt eines umfassenderen persönlichen Zugriffstokens.