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 Banners, einer In-App-Nachricht oder eines Content-Blocks ansprechen.

Voraussetzungen

Sehen Sie sich das folgende Video an, um einen optionalen Überblick über die Einrichtung und Verwendung mehrsprachiger Nachrichten zu erhalten.

• mehrsprachige locales
• nachrichtentypen
• templates

Locales verwenden

1. Schritt: Locales einrichten

Bevor Sie Übersetzungen zu einer Nachricht hinzufügen können, müssen Sie zunächst die Locales erstellen, die Sie unterstützen möchten. Locales definieren die Sprach- (und optional Regions-)Varianten, die für das Messaging verfügbar sind.

2. Schritt: Inhalte für die Übersetzung markieren

Umschließen Sie Text, den Sie übersetzen möchten, 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 semantische ID-Namen, die den Text klar beschreiben, wie z. B. {% translation header %}.

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

Tipp

Markieren Sie den Text, den Sie übersetzen möchten, und verwenden Sie die Tastenkombination Cmd + Alt + L (macOS) oder Strg + Alt + L (Windows), um ihn in Übersetzungs-Tags einzuschließen.

Diese Tastenkombination 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 Add personalization in der linken Seitenleiste, um Übersetzungs-Tags hinzuzufügen.

URLs lokalisieren

Beim Übersetzen von Inhalten erfordern URLs eine besondere Behandlung, um fehlerhafte Links zu vermeiden.

Standard-URLs (statisch)

Statische URLs werden manuell im Editor eingegeben (z. B. https://example.com). Wir empfehlen außerdem 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>

Liquid-generierte URLs

Wenn Ihre URL mit Liquid generiert wird (z. B. {% landing_page_url %}), empfehlen wir Folgendes:

Eine 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 in Übersetzungs-Tags eingeschlossen sind.

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 einzuschließen. HTML-Attribute steuern Layout, Styling und Funktionalität. Wenn Sie sie in Übersetzungs-Tags einschließen, kann dies die Formatierung oder Styles in lokalisierten Versionen Ihrer Nachricht beschädigen.

Dieser Text ist korrekt eingeschlossen:

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 %}

3. Schritt: Locales zu Ihrer Nachricht hinzufügen

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

Content Blocks mit Übersetzungen

Wenn Ihre Nachricht Content Blocks enthält, in denen 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.

Im Modal Manage languages erscheinen Content Blocks mit gespeicherten Übersetzungen in der Liste zusammen mit den Locales, die sie unterstützen. So können Sie sehen, welche Teile Ihrer Nachricht bereits lokalisiert sind, bevor Sie neue Übersetzungen hinzufügen.

Wichtig

Stellen Sie sicher, dass jeder Content-Block Übersetzungen für jedes Locale enthält, das zu Ihrer Nachricht hinzugefügt wurde. Wenn einem Content-Block Übersetzungen für eines der hinzugefügten Locales fehlen, wird er für Nutzer:innen in diesem Locale in seiner Originalsprache angezeigt.

4. Schritt: Übersetzungen hinzufügen

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

• csv-template hochladen
• übersetzungs-api verwenden

Wählen Sie Download template, um eine CSV-Datei herunterzuladen, die eine Matrix Ihrer ausgewählten Übersetzungs-IDs und Locales enthält. Geben Sie die Übersetzungen für jedes Locale ein. Laden Sie die fertige Datei hoch, und die Übersetzungen werden auf Ihre Nachricht angewendet.

Wichtig

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

Verwenden Sie eine Partner-Übersetzungs-API, um Übersetzungen in Ihren Campaigns und Canvases zu verwalten und zu aktualisieren. Dies ist nützlich, wenn Sie ein externes System für die Lokalisierung verwenden oder eine direkte Verbindung mit einem Übersetzungspartner herstellen 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.

5. Schritt: Übersetzungen in der Vorschau anzeigen

Um eine Vorschau Ihrer Nachricht anzuzeigen, wählen Sie die Option Multi-Language User aus dem Dropdown Preview as User. So können Sie zwischen verschiedenen Locale-Definitionen wechseln, um alle Übersetzungen Ihrer Nachricht in der Vorschau anzuzeigen.

Übersetzungen verwalten

Canvas-Schritte oder Campaigns duplizieren und Übersetzungen

Wenn Sie einen Canvas-Schritt, eine Campaign oder eine Variante duplizieren, werden Übersetzungen mit übernommen. Dies gilt auch beim Kopieren über Workspaces hinweg, sofern die Locales im Ziel-Workspace definiert sind. Überprüfen und aktualisieren Sie die Übersetzungen entsprechend, wenn Sie Änderungen an Ihrem Canvas oder Ihrer Campaign vornehmen.

Ü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 markieren, Locales 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.

Rechts-nach-links-Nachrichten

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 verfolgt Braze Links, indem Tracking-Informationen (Query-Parameter) zu jeder URL 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 hinzugefügt werden sollen. Um sicherzustellen, dass dies korrekt funktioniert, müssen Sie ein Sonderzeichen am Ende der URL einfügen, um anzugeben, wo das Tracking hinzugefügt werden soll.

URLs verwenden zwei Sonderzeichen, um dies zu steuern:

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

Spracheinstellungen und Barrierefreiheit

Beginnen Sie mit Barrierefreiheitssprache unter Barrierefreiheit für den WCAG-Kontext, das Verhalten von Kanälen und Editoren (einschließlich Landing-Pages) sowie die Accessibility-Einstellungen auf Nachrichtenebene.

Wenn Sie mehrsprachige Nachrichten verwenden, stimmen Sie die Barrierefreiheitssprache mit jedem Locale ab, damit lokalisierte Sendungen die entsprechende Sprache deklarieren.

Barrierefreiheitssprache konfigurieren

Sie können die Barrierefreiheitssprache auf zwei Ebenen festlegen:

Nachrichtenebene

Auf Nachrichtenebene legen Sie die Barrierefreiheitssprache im Abschnitt Accessibility Ihrer Nachrichteneinstellungen fest. Informationen zur Sprachauswahl, zur Verwendung von Liquid und zu Einschränkungen nach Kanal finden Sie unter Barrierefreiheitssprache.

Locale-Ebene

Für mehrsprachige Nachrichten legen Sie die Barrierefreiheitssprache für jedes Locale in den Einstellungen für die Lokalisierung fest. Sie können {{accessibility_language}} im Abschnitt Accessibility verwenden, damit die Dokument- oder Card-Sprache diesen Locale-Werten zugeordnet wird.

Ob dieses Token bei neuen Nachrichten standardmäßig angezeigt wird, hängt vom Kanal und Editor ab. Beispielsweise verhalten sich In-App Messages und Banner anders als Landing-Pages und Drag-and-Drop-E-Mails. Weitere Informationen finden Sie unter Barrierefreiheitssprache.

Häufig gestellte Fragen

Welche Limits gelten für Übersetzungs-Tags?

Bei der Verwendung von Übersetzungs-Tags gelten die folgenden Limits:

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

Kann ich eine Änderung am übersetzten Text in einem meiner Locales vornehmen?

Ja. Nehmen Sie zuerst die Änderung 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, entweder durch Hochladen einer CSV-Datei oder über die Übersetzungs-API.

Kann ich Übersetzungs-Tags verschachteln?

Nein.

Kann ich ganze HTML-Nachrichten in ein Übersetzungs-Tag einschließen?

Nein. Als Best Practice sollten Sie nur für Menschen lesbaren Text oder Inhalte einschließen, die lokalisiert werden müssen. Dies hilft, fehlerhafte Formatierungen, Links oder andere Nicht-Text-Elemente zu vermeiden.

Erwägen Sie außerdem, kleinere, semantisch zusammenhängende Textabschnitte einzuschließen, um genaue Übersetzungen zu erstellen und Performance- oder Größenbeschränkungen zu vermeiden.

Kann ich eine Änderung am übersetzten Text in einem meiner Locales vornehmen?

Ja. Wenn Sie eine CSV-Datei verwenden, nehmen Sie zuerst die Änderung 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?