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 locales
• nachrichtentypen
• templates

Lokale verwenden

Schritt 1: Lokale einrichten

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

Schritt 2: Inhalte für die Übersetzung markieren

Umschließen Sie den 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 nach Möglichkeit semantische ID-Namen, die den Text klar beschreiben, wie zum Beispiel {% translation header %}. Wenn die Nachricht Content Blocks enthält, lesen Sie den Abschnitt Content Blocks mit Übersetzungen, um zu erfahren, wie die Eindeutigkeit gehandhabt wird.

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 Personalisierung hinzufügen, um Übersetzungs-Tags hinzuzufügen.

URLs lokalisieren

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

Standard-URLs (statisch)

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

Eine Standard-URL, die beide Empfehlungen befolgt, sieht wie folgt 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 wie folgt 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 menschenlesbaren 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 in Übersetzungs-Tags eingeschlossen werden, kann dies die Formatierung oder Stile in lokalisierten Versionen Ihrer Nachricht beeinträchtigen.

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

Schritt 3: Lokale zu Ihrer Nachricht hinzufügen

Nachdem Sie Übersetzungs-Tags zu Ihrer Nachricht hinzugefügt haben, wählen Sie Sprachen verwalten im Editor (in den Drag-and-Drop-Editoren für E-Mail und Content Blocks heißt die Option Sprachen) und wählen Sie mindestens ein Lokal 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, die bereits gespeicherte Übersetzungen haben, 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 nicht gegenüber der übergeordneten Nachricht eindeutig sein müssen. Informationen zum Speichern von Übersetzungen im Block selbst finden Sie unter Übersetzungen in Content Blocks speichern.

Im Modal Sprachen verwalten werden Content Blocks mit gespeicherten Übersetzungen in der Liste zusammen mit den von ihnen unterstützten Lokalen angezeigt. 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 Lokal enthält, das Sie zu Ihrer Nachricht hinzugefügt haben. Wenn ein Content Block Übersetzungen für eines Ihrer hinzugefügten Lokale nicht enthält, wird er Nutzer:innen in diesem Lokal in der Originalsprache angezeigt.

Content Blocks nur mit Übersetzungs-Tags

Wenn ein Content Block Übersetzungs-Tags hat, aber keine Lokale oder gespeicherten Übersetzungen, werden seine Tags als nicht übersetzter Quellinhalt in der übergeordneten Nachricht behandelt. Der Export unter Sprachen verwalten der übergeordneten Nachricht enthält diese Tags, und die übergeordnete CSV-Datei muss die entsprechenden Übersetzungen liefern. Diese Tags müssen gegenüber anderen Tags in der übergeordneten Nachricht eindeutig sein.

Wenn Sie einen nicht übersetzten Content Block in einer anderen Nachricht wiederverwenden, muss diese zweite Nachricht ebenfalls Übersetzungen für die Tags des Blocks bereitstellen. Um zu vermeiden, dass Sie Übersetzungen in jeder Nachricht bereitstellen müssen, die einen Content Block verwendet, fügen Sie Lokale und Übersetzungen direkt zum Content Block selbst hinzu.

Schritt 4: Übersetzungen hinzufügen

Nachdem Sie Lokale 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 Template herunterladen, um eine CSV-Datei herunterzuladen, die eine Matrix Ihrer ausgewählten Übersetzungs-IDs und Lokale enthält.

Wichtig

Um Anzeigeproblemen mit nicht-englischen Zeichen vorzubeugen, vermeiden Sie die Verwendung von Excel für Ihre Übersetzungs-CSV.

Wenn Sie das Template ausfüllen, übersetzen Sie nur den Textinhalt für jedes Lokal. Wenn HTML-Tags im heruntergeladenen Template vorhanden sind, lassen Sie diese unverändert und übersetzen Sie nur den Text innerhalb der Tags.

Wenn das Template beispielsweise 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 belassen Sie die HTML-Tags <p style="margin:0;margin-bottom:0"> und </p> wie sie sind.

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

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

Um die Übersetzungsendpunkte 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: Übersetzungen in der Vorschau anzeigen

Um Ihre Nachricht in der Vorschau anzuzeigen, wählen Sie die Option Mehrsprachige:r Nutzer:in aus dem Dropdown Vorschau als Nutzer:in. So können Sie zwischen verschiedenen Lokal-Definitionen wechseln und alle Übersetzungen Ihrer Nachricht in der Vorschau 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 über Workspaces hinweg, sofern die Locales im Ziel-Workspace definiert sind. Überprüfen und aktualisieren Sie Ü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 zur Ü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 (Abfrageparameter) zu jeder URL hinzugefügt werden. Dieses Verhalten unterstützt sowohl Link Aliasing als auch Link-Templates.

Wenn eine URL in Übersetzungs-Tags eingeschlossen ist, kann Braze möglicherweise nicht ermitteln, 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 dieses Verhalten zu steuern:

• ? fügt Tracking zu einer URL hinzu, die noch keines enthält.
• & 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 WCAG-Kontext, Kanal- und Editor-Verhalten (einschließlich Landing-Pages) sowie Einstellungen zur Barrierefreiheit auf Nachrichtenebene.

Wenn Sie mehrsprachige Nachrichten verwenden, stimmen Sie die Barrierefreiheitssprache auf jedes Locale ab, damit lokalisierte Sendungen die passende Sprache deklarieren.

Die Barrierefreiheitssprache konfigurieren

Sie können die Barrierefreiheitssprache auf zwei Ebenen festlegen:

Nachrichtenebene

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

Locale-Ebene

Für mehrsprachige Nachrichten legen Sie die Barrierefreiheitssprache für jedes Locale in den Lokalisierungseinstellungen fest. Sie können {{accessibility_language}} im Abschnitt Barrierefreiheit verwenden, damit die Dokument- oder Kartensprache auf diese Locale-Werte abgebildet wird.

Ob dieses Token standardmäßig für neue Nachrichten 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 Beschränkungen gelten für Übersetzungs-Tags?

Bei der Verwendung von Übersetzungs-Tags gelten die folgenden Beschränkungen:

• 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 Gebietsschema können bis zu 409.600 Bytes (ungefähr 409,6 KB) groß sein.

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

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 kollidieren, wie Braze E-Mail-Bodys verarbeitet.

Braze behandelt den HTML-Body und den Plaintext-Body als separate Bestandteile derselben Nachricht. Wenn Übersetzungs-Tags href-Referenzen und CSS-Styling enthalten, kann dies zu widersprüchlichen Tags führen, die verhindern, dass das Template korrekt heruntergeladen wird.

So lösen Sie dieses Problem:

• Schließen Sie href-Referenzen und CSS-Styling aus Übersetzungs-Tags aus.
• Umschließen Sie nur menschenlesbaren Textinhalt mit Übersetzungs-Tags, wie in HTML-Attribute und Struktur beschrieben.
• Für URLs folgen Sie der Anleitung unter URLs lokalisieren.

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

Ja. Nehmen Sie zunächst die Bearbeitung in der CSV-Datei vor und laden Sie die Datei dann erneut hoch, um eine Änderung am übersetzten Text vorzunehmen.

Stellt Braze Übersetzungen bereit?

Nein. Sie müssen Ihre eigenen Übersetzungen bereitstellen, entweder durch das 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 menschenlesbaren Text oder Inhalte umschließ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 zusammengehörige Textabschnitte zu umschließen, um genaue Übersetzungen zu erstellen und Performance- oder Größenbeschränkungen zu vermeiden.

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

Ja. Wenn Sie eine CSV-Datei verwenden, nehmen Sie zunächst die Bearbeitung in der Datei vor und laden Sie sie dann erneut hoch, um eine Änderung am übersetzten Text vorzunehmen. 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?