Braze (TMS)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Verfügbar für

Team-, Professional-, Business- und Enterprise-Pläne

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Verfügbar für

Ultimate- und Enterprise-Pläne (Legacy)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Der Braze-Connector ermöglicht es Marketingfachleuten, Braze-Kampagnen, Canvases und Templates ohne manuelle Arbeit zu lokalisieren. Durch die Verbindung von Phrase TMS mit der Multilanguage-API von Braze werden mehrsprachige Inhalte automatisch zwischen beiden Plattformen zur Übersetzung ausgetauscht.

Diese Integration ist für Marketingfachleute konzipiert, nicht für Entwickler. Sie macht Code-Änderungen, Datei-Exporte oder die Duplizierung von Templates überflüssig.

Der Connector enthält eine Funktion zur einheitlichen Sprachzuordnung, die Phrase-TMS-Sprachcodes automatisch mit Braze-Sprachcodes abgleicht. Häufige Abweichungen wie Groß-/Kleinschreibung (de-DE vs de-de) und Trennzeichenformate (en-US vs en_us) werden automatisch aufgelöst, was den manuellen Einrichtungsaufwand reduziert. Administratoren können in den Connector-Einstellungen benutzerdefinierte Zuordnungen für nicht standardmäßige oder individuelle Gebietsschemacodes definieren, die Vorrang vor der automatischen Zuordnung haben.

Automatische Benachrichtigungen können konfiguriert werden, sodass Übersetzer benachrichtigt werden, wenn ein neuer Auftrag eingeht, und Marketingfachleute eine Benachrichtigung erhalten, wenn dieser Auftrag abgeschlossen ist.

Braze erfordert, dass jede Übersetzung eine eindeutige Tag-ID hat.

Braze-Lokalisierungsleitfaden

Hinweis

Aufgrund kontinuierlicher Verbesserungen kann die Benutzeroberfläche nicht genau so aussehen wie im Video dargestellt.

Braze-Inhaltsstruktur

Templates:

Wiederverwendbare Nachrichtenlayouts – E-Mails, In-App-Nachrichten oder Push-Benachrichtigungen –, die als Grundlage für Kampagnen und Canvases dienen.
Kampagnen:

Werden verwendet, um gezielte Nachrichten über einen oder mehrere Kanäle (E-Mail, Push oder In-App) an Zielgruppen zu senden. Kampagnen können einmalig, wiederkehrend oder durch Ereignisse ausgelöst sein und unterstützen eine personalisierte, kanalübergreifende Kommunikation.
Canvases:

Mehrstufige Customer Journeys, die Nachrichten über mehrere Kanäle hinweg unter Verwendung von Triggern, Zielgruppensegmenten und Zeitlogik versenden. Canvases sind ideal für die Orchestrierung von verhaltensbasierten, automatisierten Engagement-Abläufen.
Inhaltsblöcke:

Wiederverwendbare Inhalts-Snippets, die in Templates, Kampagnen und Canvases eingebettet werden können.

Anwendungsfälle für die Lokalisierung

Lokalisierung auf Template-Ebene

Templates vor der Verknüpfung mit Kampagnen oder Canvases lokalisieren.

Einschränkungen:
- Unterstützt nur HTML-Templates für E-Mail, Push und In-App (keine Drag-and-Drop-Templates).
- Drag-and-Drop-Templates werden über Kampagnen und Canvases unterstützt.
Lokalisierung auf Kampagnen- und Canvas-Ebene

Bei Kampagnen und Canvases können weitere Nachrichtentypen lokalisiert werden, darunter Drag-and-Drop-Templates.

Kampagnen und Canvases dienen als Bereitstellungsebene. Drag-and-Drop-Templates können nicht direkt aus der Template-Bibliothek lokalisiert werden, wohl aber innerhalb von Kampagnen oder Canvases. Dies bedeutet, dass alle Nachrichtentypen auf der entsprechenden Ebene übersetzt werden können.

Einschränkungen

Einschränkung	Beschreibung	Workaround
Drag-and-Drop-Templates	Nicht als Template sichtbar	Über Kampagnen oder Canvases lokalisieren; danach sind die Templates in Phrase TMS sichtbar.
Gebietsschema-Konflikte	Können zu Fehlern bei der Auftragserstellung führen	Gebietsschema-Codes einheitlich mit Unterstrichen schreiben.
Fehlende Berechtigungen	Können die Synchronisierung blockieren	Neue API-Schlüssel mit Zugriffsrechten für Templates, Canvases und Kampagnen erstellen.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen.
Das Einreicher-Portal so einrichten, dass Einreicher Dateien direkt aus dem Online-Repository zu Anfragen hinzufügen können.
Mit der automatisierten Projekterstellung (APC) werden automatisch neue Projekte erstellt, wenn Änderungen am Inhalt überwachter Dokumente oder eines überwachten Ordners erkannt werden.
- Nur neue oder aktualisierte übersetzbare Inhalte lösen APC aus; weder der Export von Übersetzungen noch Änderungen an nicht übersetzbaren Inhalten führen zur Erstellung neuer Projekte.
Mit der Connector-API lassen sich Schritte automatisieren, die sonst manuell über die Benutzeroberfläche ausgeführt werden. Mit Webhooks können Systeme von Drittanbietern über bestimmte Ereignisse benachrichtigt werden (beispielsweise wenn sich der Status eines Jobs ändert).

Braze-Einstellungen für mehrere Sprachen

Beim Braze-Konto anmelden.
In der Entwicklerkonsole unter Settings zu APIs and Identifiers navigieren.
Opt in to Braze IP allowlisting if you plan to make Braze-to-Braze webhooks auswählen.

Falls eine Einschränkung erforderlich ist:
1. In der Entwicklerkonsole zu Templates navigieren.
2. Die Optionen für Templates öffnen und templates.translations.get sowie templates.translations.update auswählen.
Einen neuen REST-API-Schlüssel erstellen.

Dieser Schlüssel ist für die Konnektorkonfiguration erforderlich.

Der REST-API-Schlüssel ist an das Braze-Benutzerkonto gebunden, das ihn generiert hat.

Sicherstellen, dass diese Berechtigungen ausgewählt sind:
- Templates
- Canvases
- Kampagnen
Falls ein Schlüssel für den Legacy-Connector generiert wurde, funktioniert dieser nicht mehr.
Die Braze REST Endpoint URL kopieren.
Sicherstellen, dass die Sprach-Gebietsschema-Codes unter Workspace Settings – Multi-Language Locale Setttings im Standardformat mit Unterstrich vorliegen. Bindestriche oder andere Formate führen zu Fehlern.
Für alle Templates, Kampagnen und Canvas-Schritte, die übersetzt werden sollen, die Mehrsprachigkeit mit allen erforderlichen Gebietsschemata einschließlich des Quellgebietsschemas konfigurieren.

Phrase TMS-Einstellungen

Auf der Seite „Einstellungen“ nach unten zum Abschnitt Integrations scrollen.
Klicke auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Auf New connector klicken.

Die Seite Create connector wird geöffnet.
Type auf Braze setzen und einen Namen für den Connector eingeben.
Die Braze REST Endpoint URL aus der Dropdown-Liste auswählen.
Den REST-API-Schlüssel unter Braze Settings → APIs and Identifiers → API Keys finden und eingeben.
Klicke auf Verbindung testen.
- Bei Erfolg erscheint ein kleines Häkchen neben der Schaltfläche Test connection.
Auf Show optional settings klicken, um weitere Optionen zu konfigurieren:
- Tags für die Übersetzung
  
  Tag-IDs für die zu importierenden Inhalte eingeben. Die Tags müssen mit den Tags in Braze übereinstimmen.
- Sprachzuordnung
  
  Auf Add language mapping klicken, um Braze-Sprachen TMS-Sprachen zuzuordnen.
  
  Jede Phrase-Sprache kann jeweils nur einem Braze-Gebietsschema-Code zugeordnet werden. Wenn zwei Braze-Codes (zum Beispiel da und visitor_da) beide derselben Phrase-Sprache zugeordnet sind, wählt der Connector automatisch einen der Codes aus, und es gibt keine Möglichkeit zu steuern, welcher Code gewählt wird. Der Auftrag für den Code, der nicht ausgewählt wurde, kann nicht erstellt werden, und der Connector protokolliert einen Fehler für diese Sprache.
  
  Die Erstellung eines Auftrags erfordert, dass das Quell-Gebietsschema und jedes im Connector oder in der APC-Sprachzuordnung konfigurierte Ziel-Gebietsschema bereits im jeweiligen Braze-Canvas oder Kampagnenelement vorhanden sind. Die Konfiguration eines Gebietsschemas auf Connector- oder APC-Ebene ist nicht ausreichend. Wenn ein Gebietsschema auf einem Canvas fehlt, schlägt der Import mit einer Fehlermeldung fehl, die darauf hinweist, dass das Quell- oder Ziel-Gebietsschema nicht im Braze-Element konfiguriert ist. Fehlende Gebietsschemata vor einem erneuten Importversuch direkt zum Canvas in Braze hinzufügen.
- Importaktualität-Filter
  
  maximum days since last update so festlegen, dass nur Inhalte importiert werden, die innerhalb der angegebenen Anzahl von Tagen aktualisiert wurden. Den Wert auf 0 setzen, um alle Inhalte unabhängig von ihrem Alter zu importieren.
Klicke auf Importieren.

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.

Lokalisierung von HTML-E-Mail-Vorlagen

Bei Verwendung des HTML-Editors von Braze können Inhalte direkt auf Vorlagenebene lokalisiert werden. Dies ist ideal für wiederverwendbare E-Mails.

Zur Lokalisierung einer HTML-E-Mail-Vorlage die folgenden Schritte ausführen:

Unter Template – Email Templates – HTML Editor die Vorlage öffnen.
Übersetzungstags hinzufügen:
- Den übersetzbaren Bereich mit Phrase-Tags umschließen:
```
{% translation phrase_body %}
...E-Mail-Inhalt hier...
{% endtranslation %}
```
  Tipp
  
  Das öffnende Tag in der ersten Zeile und das schließende Tag in der letzten Zeile des HTML-Editors platzieren. Sätze müssen nicht einzeln umschlossen werden; der Phrase-Konverter analysiert automatisch alles zwischen den beiden Tags und bereitet es für die Übersetzung im Phrase TMS-Arbeitsbereich vor. Die HTML-Formatierung, Links und das Styling bleiben in der lokalisierten Version vollständig erhalten.
- Betreff und Preheader zur Übersetzung einzeln mit Tags umschließen:
```
{% translation phrase_subject %}Betrefftext{% endtranslation %}
{% translation phrase_preheader %}Preheader-Text{% endtranslation %}
```
Die Vorlage speichern.
Die Vorlage erneut öffnen, Multi-language auswählen und die Quell- und Ziel-Gebietsschemas festlegen. Sicherstellen, dass die Gebietsschemas mit der Phrase-Konfiguration übereinstimmen.
Die Vorlage speichern.
In Phrase TMS Import from Integration – Braze – Templates auswählen.

Die HTML-Vorlage erscheint als Übersetzungsauftrag.
Den Text übersetzen und überprüfen.
Nach der Freigabe die Übersetzungen zurück nach Braze exportieren.

Lokalisierte Versionen erscheinen automatisch unter ihren zugewiesenen Gebietsschemas. Mit Preview & Test – Multi-language user die Anzeige und das Layout überprüfen.

Arbeiten mit Kampagnen und Canvases

Hinweis

Eine In-Context-Vorschau ist im CAT-Editor für Aufträge, die aus Kampagnen oder Canvases importiert wurden, nicht verfügbar. Phrase TMS empfängt mehrere E-Mails als Teil dieser Inhaltstypen und kann diese nicht zu einem einzigen HTML-Dokument für die Darstellung zusammenführen; daher wird kein Vorschau-Tab angezeigt.

Für die In-Context-Vorschau stattdessen die E-Mail-Vorlage direkt lokalisieren.

Bei der Lokalisierung innerhalb von Kampagnen oder Canvases unterscheidet sich der Arbeitsablauf leicht. Anstatt eine eigenständige HTML-Vorlage zu lokalisieren, wird an aktiven Kampagnen-Assets oder Kampagnen-Assets im Entwurf gearbeitet, die möglicherweise Drag-and-Drop-Inhalte enthalten.

Lokalisierungen stammen nicht aus der Vorlagenbibliothek, sondern erfolgen direkt innerhalb von Kampagnen oder Canvases.
Drag-and-Drop-Vorlagen werden lokalisierbar, sobald sie in diesen Kontexten verwendet werden.
Alle Nachrichtentypen (E-Mail, Push, In-App) können lokalisiert werden, wenn sie mit Phrase-Tags versehen sind.

Für die Arbeit mit einer Kampagne oder einem Canvas die folgenden Schritte ausführen:

Unter Campaigns or Canvases das gewünschte Asset öffnen.
Übersetzungstags hinzufügen:
- Bei Verwendung des HTML-Editors
  Den übersetzbaren Bereich mit Phrase-Tags umschließen:
  
  {% translation phrase_body %} ...E-Mail-Inhalt hier... {% endtranslation %}
  
  Tipp
  
  Das öffnende Tag in der ersten Zeile und das schließende Tag in der letzten Zeile des HTML-Editors platzieren. Sätze müssen nicht einzeln umschlossen werden; der Phrase-Konverter analysiert automatisch alles zwischen den beiden Tags und bereitet es für die Übersetzung im Phrase-TMS-Arbeitsbereich vor. Die HTML-Formatierung, Links und das Styling bleiben in der lokalisierten Version vollständig erhalten.
  
  Betreff und Preheader zur Übersetzung einzeln mit Tags umschließen:
  
  {% translation phrase_subject %}Betrefftext{% endtranslation %} {% translation phrase_preheader %}Preheader-Text{% endtranslation %}
  - Bei Drag-and-Drop-E-Mails oben und unten in der E-Mail jeweils einen Paragraph-Block hinzufügen. Das öffnende Tag {% translation phrase_body %} im oberen Block und das schließende Tag {% endtranslation %} im unteren Block platzieren. Dies gilt für die gesamte E-Mail; die Sätze müssen nicht einzeln umschlossen werden.
Zur Übersetzung markieren

Wenn die Tag-Verwendung auf Connector-Ebene konfiguriert ist, die Kampagne oder das Canvas mit dem Übersetzungs-Tag markieren.
In Phrase TMS importieren

In Phrase TMS Import from Integration – Braze – Campaigns/Canvases. öffnen. Markierte Kampagnen erscheinen zur Auswahl.

Vor dem Import sicherstellen, dass das Quell-Gebietsschema und alle Ziel-Gebietsschemas zur Kampagne oder zum Canvas in Braze (Mehrsprachige Einstellungen) hinzugefügt wurden und dass das Quell-Gebietsschema den Quellinhalt enthält. Wenn ein Ziel-Gebietsschema im Element fehlt, schlägt der Import mit einem Fehler im APC-Verlauf fehl, selbst wenn das im Connector konfigurierte Gebietsschemaformat korrekt ist. Wenn das Quell-Gebietsschema fehlt oder leer ist, wird die Nachricht ohne Fehlermeldung vom Auftrag ausgeschlossen.
Übersetzen und überprüfen

Linguisten übersetzen innerhalb des Arbeitsbereichs von Phrase. HTML und Formatierung bleiben automatisch erhalten.
Export und Vorschau

Anschließend die lokalisierte Version zurück nach Braze exportieren. Mit Preview & Test – Multi-language user zwischen den Gebietsschemas wechseln und die Vorschau überprüfen.

Braze Legacy (TMS)

Verfügbar für

Team-, Professional-, Business- und Enterprise-Pläne

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Verfügbar für

Ultimate- und Enterprise-Pläne (Legacy)

Kontaktiere Vertrieb für Fragen zur Lizenzierung.

Wichtig

Der Braze (Legacy)-Connector wird am 30. November 2026 als veraltet eingestuft. Neue Instanzen dieses Connectors können bis zum 17. August 2026 erstellt werden. Vor dem Datum, an dem der bisherige Connector als veraltet eingestuft wird, zum neuen Connector migrieren.

Eine vollständige Migrationsanleitung steht unter Legacy Connector Deprecation zur Verfügung.

Mit der Phrase TMS-Integration für Braze lässt sich durch nahtlose Lokalisierung die Kundenbindung steigern und das Wachstum in neuen Märkten vorantreiben. Die Integration ermöglicht es Braze-Benutzern, E-Mail-Vorlagen und Inhaltsblöcke zu übersetzen.

Übersetzbare Inhaltselemente:

E-Mail-Vorlagen, die mit dem HTML-Editor erstellt wurden
Inhaltsblöcke

Hinweis

Aufgrund kontinuierlicher Verbesserungen kann die Benutzeroberfläche nicht genau so aussehen wie im Video dargestellt.

Anwendungsfälle

Der Konnektor kann in verschiedenen Anwendungsfällen verwendet werden:

Projektmanager können direkt aus einem Online-Repository Dateien zu Projekten hinzufügen.
Das Einreicher-Portal einrichten, damit Einreicher direkt aus dem Online-Repository Dateien zu Anfragen hinzufügen können.
Mit der automatisierten Projekterstellung (APC) lassen sich automatisch neue Projekte erstellen, wenn bei überwachten Dokumenten oder einem Ordner eine Änderung des Inhalts festgestellt wird.
- Nur neue oder aktualisierte übersetzbare Inhalte lösen APC aus; der Export von Übersetzungen oder Änderungen an nicht übersetzbaren Inhalten erstellt keine neuen Projekte.
Mit der Konnektor-API können Schritte automatisiert werden, die sonst manuell über die Benutzeroberfläche ausgeführt werden. Mit Webhooks können Systeme von Drittanbietern über bestimmte Ereignisse benachrichtigt werden (beispielsweise wenn sich der Status eines Jobs ändert).

Braze-Einstellungen

Beim Braze-Konto anmelden.
Zur Entwicklerkonsole navigieren und auf API-Einstellungen klicken.
Einen neuen REST-API-Schlüssel erstellen.

Dieser Schlüssel ist für die Konnektorkonfiguration erforderlich.
Die Braze-REST-Endpunkt-URL. kopieren.

Phrase TMS-Einstellungen

Auf der Seite Einstellungen nach unten zum Abschnitt Integrations scrollen.
Klicke auf Konnektoren.

Die Seite Konnektoren wird geöffnet.
Auf New connector klicken.

Die Seite Create connector wird geöffnet.
Type auf Braze ändern und einen Namen für den Konnektor angeben.
Die Braze-REST-Endpunkt-URL aus der Dropdown-Liste auswählen.
Den REST-API-Schlüssel eingeben, der unter Braze Settings → APIs and Identifiers → API Keys zu finden ist.
Klicke auf Verbindung testen.
- Bei Erfolg erscheint ein kleines Häkchen neben der Schaltfläche Test connection.
Auf Show optional settings klicken, um weitere Optionen zu konfigurieren:
- Tags für die Übersetzung
  
  Tag-IDs für die zu importierenden Inhalte angeben. Die Tags müssen mit den Tags in Braze übereinstimmen.
- Sprachzuordnung
  
  Auf Add language mapping klicken, um Braze-Sprachen den TMS-Sprachen zuzuordnen.
  
  Jede Phrase-Sprache kann jeweils nur einem Braze-Gebietsschema-Code zugeordnet werden. Wenn zwei Braze-Codes (zum Beispiel da und visitor_da) beide derselben Phrase-Sprache zugeordnet sind, wählt der Konnektor automatisch einen der Codes aus, und es gibt keine Möglichkeit zu steuern, welcher Code gewählt wird. Der Job für den Code, der nicht ausgewählt wurde, kann nicht erstellt werden, und der Konnektor protokolliert einen Fehler für diese Sprache.
  
  Die Erstellung eines Auftrags erfordert, dass das Quell-Gebietsschema und jedes im Konnektor oder in der APC-Sprachzuordnung konfigurierte Ziel-Gebietsschema bereits im jeweiligen Braze-Canvas oder Kampagnenelement vorhanden sind. Die Konfiguration eines Gebietsschemas auf Konnektor- oder APC-Ebene reicht nicht aus. Wenn ein Gebietsschema in einem Canvas fehlt, schlägt der Import mit einer Fehlermeldung fehl, die darauf hinweist, dass das Quell- oder Ziel-Gebietsschema nicht im Braze-Element konfiguriert ist. Die fehlenden Gebietsschemata vor dem erneuten Import direkt zum Canvas in Braze hinzufügen.
- Importaktualität-Filter
  
  Für maximum days since last update eine Anzahl von Tagen festlegen, damit nur Inhalte importiert werden, die innerhalb dieses Zeitraums aktualisiert wurden. Den Wert auf 0 setzen, um alle Inhalte unabhängig vom Alter zu importieren.
Klicke auf Importieren.

Der Konnektor wird der Liste auf der Seite Konnektoren hinzugefügt.