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

• 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 verfügbaren Sprach- (und optional Regions-)Varianten für das Messaging.

Schritt 2: Inhalte zur Ü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 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 Personalisierung hinzufügen, um Übersetzungs-Tags hinzuzufügen.

URLs lokalisieren

Bei der Übersetzung 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 %}

Schritt 3: Lokale zu Ihrer Nachricht hinzufügen

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

Content Blocks mit Ü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.

Im Modal Sprachen verwalten erscheinen Content Blocks mit gespeicherten Übersetzungen in der Liste zusammen mit den unterstützten Lokalen. 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 einem Content Block Übersetzungen für eines der hinzugefügten Lokale fehlen, wird er für Nutzer:innen in diesem Lokal in der Originalsprache angezeigt.

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 Anzeigeprobleme mit nicht-englischen Zeichen zu vermeiden, verwenden Sie für Ihre Übersetzungs-CSV nicht Excel.

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 lassen Sie die HTML-Tags <p style="margin:0;margin-bottom:0"> und </p> unverändert.

Laden Sie dann die ausgefüllte Datei hoch, und die Übersetzungen werden auf Ihre Nachricht angewendet.

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

Um eine Vorschau Ihrer Nachricht 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, 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 die Übersetzungen mit übernommen. Das gilt auch beim Kopieren zwischen Workspaces, 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 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 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, das angibt, 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 den WCAG-Kontext, das Kanal- und Editor-Verhalten (einschließlich Landing-Pages) sowie die Barrierefreiheits-Einstellungen auf Nachrichtenebene.

Wenn Sie mehrsprachige Nachrichten verwenden, stimmen Sie die Barrierefreiheitssprache mit jedem Locale ab, damit lokalisierte Sendungen die entsprechende 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 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 diesen Locale-Werten zugeordnet wird.

Ob dieses Token standardmäßig für neue Nachrichten angezeigt wird, hängt vom Kanal und Editor ab. Beispielsweise verhalten sich In-App-Nachrichten 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.

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 Verarbeitung von E-Mail-Bodys durch Braze in Konflikt stehen.

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

So lösen Sie das Problem:

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

Kann ich eine Änderung an der übersetzten Kopie in einer meiner Locales vornehmen?

Ja. Nehmen Sie zuerst die Bearbeitung in der CSV-Datei vor und laden Sie die Datei dann erneut hoch, um eine Änderung an der übersetzten Kopie vorzunehmen.

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 einen Ü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 zusammenhängende Textabschnitte zu umschließen, um genaue Übersetzungen zu erstellen und Performance- oder Größenbeschränkungen zu vermeiden.

Kann ich eine Änderung an der übersetzten Kopie in einer meiner Locales vornehmen?

Ja. Wenn Sie eine CSV-Datei verwenden, nehmen Sie zuerst die Bearbeitung in der Datei vor und laden Sie sie dann erneut hoch, um eine Änderung an der übersetzten Kopie 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?