Mehrsprachige Nachrichten

Nachdem Sie Locales zu Ihrem Workspace hinzugefügt haben, können Sie Nutzer:innen in verschiedenen Sprachen innerhalb einer einzigen Push-Nachricht, E-Mail, eines Webhooks, eines Banners, einer In-App-Nachricht oder eines Content-Blocks ansprechen.

Voraussetzungen

• mehrsprachige gebietsschemata
• nachrichtentypen
• templates

Gebietsschemata verwenden

Schritt 1: Gebietsschemata einrichten

Bevor Sie einer Nachricht Übersetzungen hinzufügen können, müssen Sie zunächst die Gebietsschemata erstellen, die Sie unterstützen möchten. Gebietsschemata legen die Sprachvarianten (und optional die regionalen Varianten) fest, die für das Messaging verfügbar sind.

Schritt 2: Inhalte zur Übersetzung markieren

Umschließen Sie den zu übersetzenden Text mit den Liquid-Übersetzungs-Tags {% translation your_id_here %} und {% endtranslation %} und weisen Sie eine Tag-ID zu. Übersetzungs-Tag-IDs müssen innerhalb einer Nachricht eindeutig sein. Verwenden Sie am besten semantische ID-Namen, die den Text klar beschreiben, etwa {% translation header %}. Wenn die Nachricht Content Blocks enthält, erfahren Sie unter Content Blocks mit Übersetzungen, wie die Eindeutigkeit dort gilt.

Hier ist ein Beispiel für eine zur Übersetzung markierte Nachricht: {% translation greeting %}Hello!{% endtranslation %}

Tipp

Markieren Sie den zu übersetzenden Text und verwenden Sie das Tastenkürzel Cmd + Alt + L (macOS) oder Ctrl + Alt + L (Windows), um ihn mit Übersetzungs-Tags zu umschließen.

Dieses Tastenkürzel funktioniert in allen Kanälen, die mehrsprachiges Messaging unterstützen, mit Ausnahme der Drag-and-Drop-Editoren für E-Mail und Content Blocks. Verwenden Sie dort den Button Personalisierung hinzufügen, um Übersetzungs-Tags einzufügen.

URLs lokalisieren

Beim Übersetzen von Inhalten müssen URLs besonders behandelt werden, damit keine fehlerhaften Links entstehen.

Standard-URLs (statisch)

Statische URLs werden manuell im Editor eingegeben (zum Beispiel https://example.com). Außerdem empfehlen wir Folgendes:

Eine Standard-URL, die beide Empfehlungen befolgt, sieht so aus:

1

<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>

Mit Liquid generierte URLs

Wenn Ihre URL mit Liquid generiert wird (zum Beispiel {% landing_page_url %}), empfehlen wir Folgendes:

Eine mit Liquid generierte URL, die beide Empfehlungen befolgt, sieht so aus:

1

<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

Wichtig

Wenn Sie E-Mail-Link-Tracking (Link Aliasing oder Link-Templates) verwenden, ist eine zusätzliche Konfiguration erforderlich, wenn URLs mit Übersetzungs-Tags umschlossen werden.

HTML-Attribute und -Struktur

Umschließen Sie nur für Menschen lesbaren Text mit Übersetzungs-Tags. Vermeiden Sie es, HTML-Attribute (wie class, style oder id) oder anderen strukturellen Code zu umschließen. HTML-Attribute steuern Layout, Styling und Funktionalität. Wenn Sie sie mit Übersetzungs-Tags umschließen, kann das die Formatierung oder die Styles in lokalisierten Versionen Ihrer Nachricht beschädigen.

Dieser Text ist korrekt umschlossen:

1
2
3

<p class="headline" style="color: red;">
  {% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>

1
2
3
4
5

{% translation id_1 %}
<p class="headline" style="color: red;">
  Welcome to our sale
</p>
{% endtranslation %}

Schritt 3: Gebietsschemata zu Ihrer Nachricht hinzufügen

Nachdem Sie Ihrer Nachricht Übersetzungs-Tags hinzugefügt haben, wählen Sie im Editor Sprachen verwalten aus (in den Drag-and-Drop-Editoren für E-Mail und Content Blocks Sprachen) und wählen Sie mindestens ein Gebietsschema aus, für das Sie Übersetzungen hinzufügen möchten.

Content Blocks mit Übersetzungen

Content Blocks mit Übersetzungs-Tags verhalten sich unterschiedlich, je nachdem, ob der Block eigene gespeicherte Übersetzungen hat:

Content Blocks mit gespeicherten Übersetzungen

Wenn Ihre Nachricht Content Blocks enthält, für die bereits Übersetzungen gespeichert sind, müssen Sie diese Übersetzungen nicht erneut hochladen. Gespeicherte Übersetzungen werden automatisch angewendet, wenn der Content-Block zu Ihrer Nachricht hinzugefügt wird. Diese Blöcke behalten ihre eigenen Tag-IDs, die gegenüber der übergeordneten Nachricht nicht eindeutig sein müssen. Wie Sie Übersetzungen im Block selbst speichern, erfahren Sie unter Übersetzungen in Content Blocks speichern.

Im Modal Sprachen verwalten werden Content Blocks mit gespeicherten Übersetzungen zusammen mit den von ihnen unterstützten Gebietsschemata aufgelistet. So sehen Sie, welche Teile Ihrer Nachricht bereits lokalisiert sind, bevor Sie neue Übersetzungen hinzufügen.

Wichtig

Stellen Sie sicher, dass jeder Content-Block Übersetzungen für alle Gebietsschemata enthält, die Sie Ihrer Nachricht hinzugefügt haben. Fehlen in einem Content-Block Übersetzungen für eines der hinzugefügten Gebietsschemata, wird er Nutzer:innen in diesem Gebietsschema in seiner Originalsprache angezeigt.

Content Blocks nur mit Übersetzungs-Tags

Wenn ein Content-Block Übersetzungs-Tags, aber keine Gebietsschemata oder gespeicherten Übersetzungen hat, werden seine Tags in der übergeordneten Nachricht als unübersetzte Ausgangsinhalte behandelt. Der Export unter Sprachen verwalten der übergeordneten Nachricht enthält diese Tags, und die CSV der übergeordneten Nachricht muss deren Übersetzungen liefern. Diese Tags müssen gegenüber anderen Tags in der übergeordneten Nachricht eindeutig sein.

Wenn Sie einen unübersetzten Content-Block in einer anderen Nachricht wiederverwenden, muss auch diese zweite Nachricht Übersetzungen für die Tags des Blocks bereitstellen. Damit Sie nicht in jeder Nachricht, die einen Content-Block verwendet, Übersetzungen bereitstellen müssen, fügen Sie Gebietsschemata und Übersetzungen direkt dem Content-Block selbst hinzu.

Schritt 4: Übersetzungen hinzufügen

Nachdem Sie Gebietsschemata ausgewählt haben, fügen Sie Ihrer Nachricht mit einer der folgenden Methoden Übersetzungen hinzu:

• csv-template hochladen
• übersetzungs-api verwenden

Wählen Sie Template herunterladen aus, um eine CSV-Datei mit einer Matrix aus Ihren ausgewählten Übersetzungs-IDs und Gebietsschemata herunterzuladen.

Wichtig

Um Darstellungsprobleme mit nicht englischen Zeichen zu vermeiden, verwenden Sie für Ihre Übersetzungs-CSV nicht Excel.

Übersetzen Sie beim Ausfüllen des Templates nur den Textinhalt für jedes Gebietsschema. Wenn das heruntergeladene Template HTML-Tags enthält, lassen Sie diese unverändert und übersetzen Sie nur den Text innerhalb der Tags.

Wenn das Template zum Beispiel Folgendes enthält:

1

<p style="margin:0;margin-bottom:0">A charming bakery dedicated to crafting artisanal breads.</p>

Übersetzen Sie nur den Text A charming bakery dedicated to crafting artisanal breads. und lassen Sie die HTML-Tags <p style="margin:0;margin-bottom:0"> und </p> unverändert.

Laden Sie anschließend die ausgefüllte Datei hoch. Die Übersetzungen werden dann auf Ihre Nachricht angewendet.

Verwenden Sie eine Übersetzungs-API eines Partners, um Übersetzungen in Ihren Campaigns, Canvases, Content Blocks, E-Mail-Templates und Webhook-Templates zu verwalten und zu aktualisieren. Das ist hilfreich, wenn Sie ein externes System für die Lokalisierung nutzen oder sich direkt mit einem Übersetzungspartner verbinden möchten.

Um die Übersetzungs-Endpunkte mit Canvases zu verwenden, geben Sie die folgenden Parameter an:

• workflow_id
• step_id
• message_variation_id

Hinweis

Wenn Sie die Übersetzungs-API mit Canvas-Schritten verwenden, die nach dem Start des Canvas erstellt wurden, ist die message_variation_id, die Sie an die API übergeben, leer.

Schritt 5: Vorschau der Übersetzungen anzeigen

Um eine Vorschau Ihrer Nachricht anzuzeigen, wählen Sie im Dropdown-Menü Vorschau als Nutzer:in die Option Mehrsprachige:r Nutzer:in aus. So können Sie zwischen verschiedenen Gebietsschema-Definitionen wechseln und eine Vorschau aller Übersetzungen Ihrer Nachricht anzeigen.

Übersetzungen verwalten

Canvas-Schritte oder Campaigns duplizieren und Übersetzungen

Wenn Sie einen Canvas-Schritt, eine Campaign oder eine Variante duplizieren, werden die Übersetzungen mit übernommen. Das gilt auch beim Kopieren zwischen Workspaces, sofern die Gebietsschemata im Ziel-Workspace definiert sind. Prüfen und aktualisieren Sie die Übersetzungen entsprechend, wenn Sie Ihr Canvas oder Ihre Campaign ändern.

Übersetzungen in Content Blocks speichern

Content Blocks unterstützen Mehrsprachigkeit auf die gleiche Weise wie Nachrichten. Beim Erstellen oder Bearbeiten von Content Blocks können Sie Inhalte für die Übersetzung taggen, Gebietsschemata hinzufügen und Übersetzungen per CSV oder über die Übersetzungs-API hochladen.

Gespeicherte Übersetzungen bleiben mit dem Content-Block verknüpft. Wenn der Block zu einer Nachricht hinzugefügt wird, werden seine Übersetzungen automatisch einbezogen.

Nachrichten mit Rechts-nach-links-Schrift

Wenn Sie die Übersetzungsdatei für Sprachen ausfüllen, die von rechts nach links geschrieben werden (wie Arabisch), umschließen Sie die Übersetzung mit span, damit sie korrekt formatiert wird:

1

{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}

E-Mail-Link-Tracking

In E-Mail-Campaigns trackt Braze Links, indem jeder URL Tracking-Informationen (Abfrageparameter) hinzugefügt werden. Dieses Verhalten unterstützt sowohl Link Aliasing als auch Link-Templating.

Wenn eine URL in Übersetzungs-Tags eingeschlossen ist, kann Braze möglicherweise nicht bestimmen, wo diese Tracking-Informationen eingefügt werden sollen. Damit das korrekt funktioniert, müssen Sie am Ende der URL ein Sonderzeichen einfügen, das angibt, wo das Tracking hinzugefügt werden soll.

URLs verwenden zwei Sonderzeichen, um dies zu steuern:

• ? fügt einer URL, die noch keines hat, Tracking hinzu.
• & fügt zusätzliches Tracking hinzu, wenn bereits ein ? in der URL vorhanden ist. Eine URL darf nur ein ? enthalten.

Spracheinstellungen und Barrierefreiheit

Beginnen Sie mit Sprache für Barrierefreiheit im Artikel Barrierefreiheit, um mehr über den WCAG-Kontext, das Verhalten von Kanälen und Editoren (einschließlich Landing-Pages) sowie die Barrierefreiheit-Einstellungen auf Nachrichtenebene zu erfahren.

Wenn Sie mehrsprachige Nachrichten verwenden, stimmen Sie die Sprache für Barrierefreiheit auf jedes Gebietsschema ab, damit lokalisierte Sendungen die passende Sprache deklarieren.

Sprache für Barrierefreiheit konfigurieren

Sie können die Sprache für Barrierefreiheit auf zwei Ebenen festlegen:

Nachrichtenebene

Auf Nachrichtenebene legen Sie die Sprache für Barrierefreiheit im Abschnitt Barrierefreiheit Ihrer Nachrichteneinstellungen fest. Informationen zur Auswahl einer Sprache, zur Verwendung von Liquid und zu kanalspezifischen Einschränkungen finden Sie unter Sprache für Barrierefreiheit.

Gebietsschemaebene

Bei mehrsprachigen Nachrichten legen Sie die Sprache für Barrierefreiheit für jedes Gebietsschema in den Lokalisierungseinstellungen fest. Sie können {{accessibility_language}} im Abschnitt Barrierefreiheit verwenden, damit die Sprache des Dokuments oder der Karte diesen Gebietsschema-Werten zugeordnet wird.

Ob dieser Token bei neuen Nachrichten standardmäßig erscheint, hängt vom Kanal und vom Editor ab. So verhalten sich beispielsweise In-App-Nachrichten und Banner anders als Landing-Pages und Drag-and-Drop-E-Mails. Details finden Sie unter Sprache für Barrierefreiheit.

Häufig gestellte Fragen

Welche Limits gelten für Übersetzungs-Tags?

Für Übersetzungs-Tags gelten die folgenden Limits:

• Jede Nachricht kann bis zu 200 Übersetzungs-Tags enthalten.
• Jeder Standardtext (der Inhalt zwischen den Übersetzungs-Tags) kann bis zu 2.000 Zeichen umfassen.
• Die Übersetzungen pro Locale können bis zu 409.600 Bytes (ungefähr 409,6 KB) groß sein.

Warum erhalte ich beim Herunterladen mehrsprachiger E-Mail-Templates einen Fehler?

Wenn beim Herunterladen mehrsprachiger E-Mail-Templates Fehler auftreten, umschließen die Übersetzungs-Tags möglicherweise HTML-Attribute oder CSS-Styling, die mit der Art und Weise in Konflikt stehen, wie Braze E-Mail-Inhalte verarbeitet.

Braze behandelt den HTML-Body und den Klartext-Body als separate Komponenten derselben Nachricht. Wenn Übersetzungs-Tags href-Referenzen und CSS-Styling enthalten, kann dies zu widersprüchlichen Tags führen, die ein korrektes Herunterladen des Templates verhindern.

So beheben Sie das Problem:

• Schließen Sie href-Referenzen und CSS-Styling aus Übersetzungs-Tags aus.
• Umschließen Sie nur menschenlesbaren Textinhalt mit Übersetzungs-Tags, wie unter HTML-Attribute und -Struktur beschrieben.
• Folgen Sie bei URLs den Hinweisen unter URLs lokalisieren.

Kann ich den übersetzten Text in einer meiner Locales ändern?

Ja. Nehmen Sie die Änderung zuerst in der CSV-Datei vor und laden Sie die Datei dann erneut hoch, um den übersetzten Text zu ändern.

Stellt Braze Übersetzungen bereit?

Nein. Sie müssen Ihre eigenen Übersetzungen bereitstellen, indem Sie entweder eine CSV-Datei hochladen oder die Übersetzungs-API verwenden.

Kann ich Übersetzungs-Tags verschachteln?

Nein.

Kann ich ganze HTML-Nachrichten mit einem Übersetzungs-Tag umschließen?

Nein. Als Best Practice sollten Sie nur menschenlesbaren Text oder Inhalte umschließen, die lokalisiert werden müssen. So vermeiden Sie fehlerhafte Formatierungen, Links oder andere Nicht-Text-Elemente.

Erwägen Sie außerdem, kleinere, semantisch zusammengehörige Textabschnitte zu umschließen, um genaue Übersetzungen zu erhalten und Performance- oder Größenbeschränkungen zu vermeiden.

Kann ich den übersetzten Text in einer meiner Locales ändern?

Ja. Wenn Sie eine CSV-Datei verwenden, nehmen Sie die Änderung zuerst in der Datei vor und laden Sie sie dann erneut hoch, um den übersetzten Text zu ändern. Wenn Sie die Übersetzungs-API verwenden, nutzen Sie die Update-Endpunkte, um Änderungen vorzunehmen.

Welche Validierungen oder zusätzlichen Prüfungen führt Braze durch?