Crowdin
Crowdin ist eine KI-gestützte Plattform zur Verwaltung der Lokalisierung, die Teams dabei unterstützt, die Übersetzung ihrer Software, Apps und Marketing-Inhalte zu automatisieren.
Verbinden Sie Crowdin mit Braze, um Übersetzungen für Ihre Campaigns und Canvas-Erlebnisse zu verwalten. Die automatische Synchronisierung arbeitet mit maschineller Übersetzung, Translation Memory und Glossaren, sodass manuelle und automatisierte Workflows konsistent bleiben.
Diese Integration wird von Crowdin gepflegt.
Über die Integration
Crowdin bietet zwei Apps für Braze: Braze Campaigns & Canvas und Braze Email Templates. Wählen Sie die App basierend auf den Braze-Features, die Sie lokalisieren möchten. Die folgende Tabelle vergleicht sie.
Die richtige Crowdin-App auswählen
| Kanal oder Feature | Braze Campaigns & Canvas | Braze Email Templates |
|---|---|---|
| Campaigns | ✅ Unterstützt | ❌ Nicht unterstützt |
| Canvas-Schritte | ✅ Unterstützt | ❌ Nicht unterstützt |
| E-Mail-Templates | ❌ Nicht unterstützt | ✅ Unterstützt |
| Content Blocks | ❌ Nicht unterstützt | ✅ Unterstützt |
Voraussetzungen
| Anforderung | Beschreibung |
|---|---|
| Crowdin-Konto | Ein Crowdin.com-Konto oder ein Crowdin-Enterprise-Konto ist erforderlich. |
| Crowdin-Projekt | Bevor Sie Braze verbinden, erstellen Sie ein Übersetzungsprojekt in Crowdin oder Crowdin Enterprise. |
| Braze REST-API-Schlüssel | Ein Braze REST-API-Schlüssel mit Berechtigungen für Campaigns, Canvas, Content Blocks, angepasste Attribute, E-Mail und Templates. |
| Braze REST-Endpunkt | Die spezifische URL Ihres Braze REST-Endpunkts (zum Beispiel https://rest.iad-03.braze.com). |
| Braze-Mehrsprachigkeitseinstellungen | Locales müssen in Ihrem Braze-Dashboard unter Einstellungen > Einstellungen für die Lokalisierung konfiguriert sein. |
Integration von Braze Campaigns & Canvas
Wenn Sie Inhalte in aktiven Nachrichten lokalisieren, verwenden Sie die Braze Campaigns & Canvas App, um übersetzbare Strings aus Ihren Campaign- und Canvas-Entwürfen mit der Braze-Mehrsprachigkeitsunterstützung zu synchronisieren.
Eine Video-Anleitung finden Sie unter Braze Campaigns & Canvas Integration.
1. Schritt: Mehrsprachigkeitseinstellungen in Braze einrichten
Bevor Sie Crowdin verbinden, fügen Sie Ihre Zielsprachen in Braze hinzu.
- Gehen Sie in Braze zu Einstellungen > Einstellungen für die Lokalisierung.
- Fügen Sie die Sprachen hinzu, die Sie unterstützen möchten.

- Notieren Sie sich jeden Locale-Schlüssel (zum Beispiel
en-US,fr-FR,es-ES). Sie verwenden diese Werte, wenn Sie Sprachen in Crowdin zuordnen.
2. Schritt: Das Braze-Projekt in Crowdin einrichten
- Gehen Sie in Ihrem Crowdin-Enterprise- oder Crowdin.com-Konto zum Store im linken Menü.
- Suchen Sie nach Braze Campaigns & Canvas und wählen Sie Install.

- Wählen Sie das Projekt (oder die Projekte) aus, in dem Sie diese Integration verwenden möchten.
- Um die Integration zu öffnen, gehen Sie zu Ihrem Projekt Integrations > Braze Campaigns & Canvas.
Braze mit Crowdin verbinden
Autorisieren Sie die Verbindung mit Ihren Braze-API-Zugangsdaten:

- Braze REST API key: Erstellen Sie diesen in Braze unter Settings > APIs and Identifiers > API Keys. Erteilen Sie die Berechtigungen, die diese Integration benötigt (Campaigns, Canvas, Content Blocks und angepasste Attribute).
- Braze REST endpoint: Geben Sie die URL für Ihre Braze-Instanz ein (zum Beispiel
https://rest.iad-03.braze.com). Weitere Informationen finden Sie unter REST-API-Endpunkte.

Wählen Sie Log in with Braze Campaigns & Canvas.
3. Schritt: Sprachzuordnung in Crowdin konfigurieren
Nachdem Sie Ihr Konto verbunden haben, ordnen Sie jede Crowdin-Projektsprache dem entsprechenden Braze-Locale zu.
- Wählen Sie im Integrations-Dashboard von Braze Campaigns & Canvas das Zahnradsymbol für Einstellungen in der oberen rechten Ecke.

- Öffnen Sie den Tab General Settings.
- Geben Sie die Locale-Schlüssel ein. Crowdin listet Ihre Projektsprachen auf (zum Beispiel Französisch, Italienisch). Geben Sie in jedem Feld den passenden Braze-Locale-Schlüssel ein.
- Wenn Braze beispielsweise
itfür Italienisch verwendet, geben Sieitneben Italienisch in Crowdin ein. - Jeder Eintrag muss exakt mit dem Locale-Schlüssel für dieses Locale in den Braze-Einstellungen für die Lokalisierung übereinstimmen.
- Wenn Braze beispielsweise

- Wählen Sie Save, um die Zuordnung zu bestätigen.
4. Schritt: Übersetzungs-Tags zu Ihrer Braze-Nachricht hinzufügen
Crowdin liest dieselben Liquid-Übersetzungs-Tags, die Braze für mehrsprachige Nachrichten verwendet. Fügen Sie {% translation your_id_here %} und {% endtranslation %} um jeden Text, jede Bild-URL oder Link-URL hinzu, die übersetzt werden soll. Jeder Block benötigt eine eindeutige id (zum Beispiel greeting oder welcome_header).
Beispiel:
{% translation greeting %}Hello!{% endtranslation %}
Für HTML, Liquid in Links und andere Muster befolgen Sie dieselben Regeln wie unter Locales übersetzen (zum Beispiel Tags um die kleinstmöglichen Segmente setzen und nur sprachspezifische Teile von URLs umschließen, wenn Sie Links lokalisieren).
Speichern Sie Ihre Braze-Nachricht als Draft, bevor Crowdin den Inhalt erkennen und abrufen kann.
5. Schritt: Übersetzungen in Crowdin verwalten
Der Integrationsbildschirm hat zwei Seiten:
- Rechte Seite (Braze): Ihre Campaigns und Canvases.
- Linke Seite (Crowdin): Bereits zur Übersetzung synchronisierte Inhalte.

Inhalte synchronisieren
- Aktivieren Sie auf der Braze-Seite (rechts) das Kontrollkästchen für die Campaign oder das Canvas, das Sie übersetzen möchten.
- Wählen Sie Sync to Crowdin.
- Wenn die Synchronisierung abgeschlossen ist, erscheint die Datei auf der Crowdin-Seite (links). Übersetzer:innen können die Strings im Crowdin-Editor öffnen.
Übersetzungen an Braze zurückgeben
- Wenn die Übersetzungen in Crowdin zu 100 % abgeschlossen sind, kehren Sie zum Tab Integrations zurück.
- Wählen Sie den abgeschlossenen Inhalt auf der Crowdin-Seite (links) aus.
- Wählen Sie Sync to Braze. Dadurch werden die übersetzten Strings in die entsprechenden Sprachvarianten Ihrer Braze-Campaign übertragen.
6. Schritt: Nachricht als mehrsprachige:r Nutzer:in in Braze in der Vorschau anzeigen
So bestätigen Sie die Integration:
- Öffnen Sie Ihre Campaign im Braze-Nachrichten-Editor.
- Gehen Sie zum Tab Test.
- Wählen Sie Preview Message as User.
- Suchen Sie nach einem Nutzerprofil, das ein
language-Attribut hat, das einem Ihrer übersetzten Locales entspricht. - Bestätigen Sie, dass der Inhalt von der Ausgangssprache zur übersetzten Version wechselt.
Integration von Braze Email Templates
Wenn Sie E-Mails auf Template-Ebene lokalisieren, verwenden Sie die Braze Email Templates App, um HTML aus Ihrer Braze-Medienbibliothek zu synchronisieren.
Eine Video-Anleitung finden Sie unter Braze Email Templates Integration.
1. Schritt: App installieren
- Gehen Sie in Ihrem Crowdin-Projekt zum Tab Store.
- Suchen Sie nach Braze Email Templates und wählen Sie Install.

- Wählen Sie das Projekt (oder die Projekte) aus, in dem Sie diese Integration verwenden möchten.
- Um die Integration zu öffnen, gehen Sie zu Ihrem Projekt Integrations > Braze Email Templates.
2. Schritt: Mit Braze verbinden
Autorisieren Sie die Verbindung mit Ihren Braze-API-Zugangsdaten:

- Braze REST API key: Erteilen Sie
templates.emailundcontent_blocks(Lesen und Schreiben). Erstellen Sie den Schlüssel in Braze unter Settings > APIs and Identifiers > API Keys.

- Geben Sie für den Braze REST endpoint Ihre instanzspezifische URL ein (zum Beispiel
https://rest.iad-03.braze.com). - Wählen Sie Log in with Braze Email Templates.
3. Schritt: Inhalte zur Übersetzung synchronisieren
Der Integrationsbildschirm zeigt Ihre Braze-Bibliothek:
- Rechte Seite (Braze): E-Mail-Templates und Content Blocks, die Sie synchronisieren können.
- Linke Seite (Crowdin): Inhalte in der Übersetzung.
- Aktivieren Sie auf der Braze-Seite (rechts) das Kontrollkästchen neben den Templates oder Blöcken, die Sie lokalisieren möchten.
- Wählen Sie Sync to Crowdin.
- Crowdin ruft den HTML-Quellcode ab. Übersetzer:innen arbeiten im Crowdin-Editor mit einer Live-WYSIWYG-Vorschau, sodass das Layout erhalten bleibt.

4. Schritt: Übersetzte Templates bereitstellen
Wenn die Übersetzungen 100 % Fertigstellung erreichen:
- Wählen Sie die abgeschlossenen Dateien auf der Crowdin-Seite (links) aus.
- Wählen Sie Sync to Braze.
- Crowdin erstellt automatisch lokalisierte Versionen dieser Assets in Ihrer Braze-Medienbibliothek (zum Beispiel
Template_Name_fr).
