Lokalisierte Inhalte mit Braze-Katalogen verwalten

Speichern Sie lokalisierte Strings und URLs in Katalogen, damit jede:r Nutzer:in Texte in der eigenen Sprache aus einer einzelnen Campaign oder einem Canvas erhält – ohne separate Varianten pro Sprache.

Über dieses Beispiel

PantsLabyrinth, ein fiktiver Bekleidungshändler, verkauft seine Produkte in Nordamerika und Europa. Produktnamen, Preise und Hero-Bilder unterscheiden sich je nach Sprache, doch das Marketing-Team möchte ein einziges E-Mail- oder Push-Template, das zum Sendezeitpunkt personalisiert wird.

Dieses Beispiel behandelt drei Katalog-Patterns, die das ${language} Standardattribut der Nutzer:innen auslesen (vom SDK über das Geräte-Locale erfasst):

• JSON-Objektfelder: alle Sprachen in einer Zeile pro Artikel
• Flache sprachspezifische Spalten: header_en, header_fr usw.
• Separater Katalog pro Sprache: dynamischer Katalogname wie pantslabyrinth-promo-en

Verwenden Sie Kataloge, wenn lokalisierte Inhalte strukturierte Daten sind (Produkte, Aktionen, Bild-URLs). Für freien Nachrichtentext in E-Mail oder Push verwenden Sie bevorzugt mehrsprachige Nachrichten, wenn Ihre Kanäle diese unterstützen. Einen breiteren Vergleich der Lokalisierungs-Patterns finden Sie unter Übersetzungsmanagement.

Hinweise

• Die Beispiele dienen der Veranschaulichung. Überprüfen Sie die Groß-/Kleinschreibung und das Format von ${language} in Ihrer Nutzerbasis, bevor Sie Katalogschlüssel oder -suffixe benennen.
• Bei Methode 1 und 2 kann die lokalisierte Ausgabe leer sein, wenn ${language} leer ist oder keinem Katalogschlüssel oder -feld entspricht – prüfen Sie jedes Feld einzeln und verwenden Sie einen Fallback zu einem Standard (z. B. Englisch).
• Bei Methode 3 müssen Sie unterstützte Sprachcodes auf eine Allowlist setzen, bevor Sie den Katalognamen erstellen; ein fehlender Katalog bricht die Nachricht ab.
• JSON-Objekte in Katalogen können über die API oder Cloud Data Ingestion (CDI) für Kataloge erstellt oder aktualisiert werden, nicht per CSV-Upload.
• Methode 2 unterstützt CSV-Pflege, vervielfacht aber die Spalten mit jeder neuen Sprache. CSV-Dateien unterstützen bis zu 1.000 Spalten.
• Methode 3 erfordert einen Katalog für jeden Sprachcode, der das catalog_items-Tag erreicht. Existiert der Katalog nicht, bricht Braze die Nachricht ab. Eine fehlende Artikel-ID in einem vorhandenen Katalog gibt ein leeres Items-Array zurück.
• Katalog-Liquid-Tags können nicht rekursiv verwendet werden.
• Katalogselektionen unterstützen bis zu 10 Filter und geben bis zu 50 Artikel zurück – validieren Sie Filter gegen Ihr Katalogschema.
• Prüfen Sie die Katalog-Speicherstufen, wenn Sie große mehrsprachige Produkt-Feeds pflegen.

Einrichtung

Schritt 1: Katalogstruktur wählen

Wählen Sie eine Katalogstruktur anhand der Hinweise in dieser Tabelle.

Schritt 2: Katalog und Artikel erstellen

1. Gehen Sie zu Dateneinstellungen > Kataloge und erstellen Sie einen Katalog (oder mehrere Kataloge für Methode 3).
2. Fügen Sie Felder und Artikel basierend auf Ihrer gewählten Struktur hinzu. Siehe Katalog erstellen.
3. (Optional) Erstellen Sie eine Katalogselektion, um Artikel zu filtern – z. B. nach category, die einem angepassten Attribut der Nutzer:innen entspricht.

• methode 1: json-felder
• methode 2: flache felder
• methode 3: katalog pro sprache

Schritt 3: Liquid zu Ihrer Nachricht hinzufügen

Wählen Sie das Liquid-Pattern, das zur Katalogstruktur passt, die Sie in Schritt 1 gewählt haben.

• methode 1: json-felder
• methode 2: flache felder
• methode 3: katalog pro sprache

Speichern Sie alle Sprachen in JSON-Objektfeldern in einer einzelnen Katalogzeile und verwenden Sie den property_accessor-Filter, um die name- und price-Schlüssel auszulesen, die zu ${language} passen (auf Großbuchstaben normalisiert). Prüfen Sie jedes Feld einzeln und verwenden Sie EN als Fallback, wenn das Feld leer ist, sodass eine Sprache mit einem Namen, aber ohne Preis dennoch einen englischen Preis erhält.

1
2
3
4
5
6
7
8
9
10
11
12

{% catalog_items PantsLabyrinth_Product_Copy trail-runner-001 %}
{% assign lang = ${language} | upcase %}
{% assign localized_name = items[0].name | property_accessor: lang %}
{% assign localized_price = items[0].price | property_accessor: lang %}
{% if localized_name == blank %}
  {% assign localized_name = items[0].name | property_accessor: 'EN' %}
{% endif %}
{% if localized_price == blank %}
  {% assign localized_price = items[0].price | property_accessor: 'EN' %}
{% endif %}
Product: {{ localized_name }}
Price: {{ localized_price }}

Siehe Property-Accessor-Filter.

Erstellen Sie dynamische Feldnamen aus ${language} (auf Kleinbuchstaben normalisiert) und lesen Sie diese Felder mit Bracket-Lookup aus dem Artikel aus. Zum Beispiel liest items[0][header_field] die Überschrift für die aufgelöste Sprache. Prüfen Sie jedes Feld einzeln und verwenden Sie die englische Spalte als Fallback, wenn das Feld leer ist, sodass eine Sprache mit einer Überschrift, aber ohne Text dennoch englischen Text erhält.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{% catalog_items PantsLabyrinth_Promo_Copy spring-sale %}
{% assign lang = ${language} | downcase %}
{% assign header_field = 'header_' | append: lang %}
{% assign body_field = 'body_' | append: lang %}
{% assign cta_field = 'cta_text_' | append: lang %}
{% assign img_field = 'img_src_' | append: lang %}
{% assign header_val = items[0][header_field] %}
{% assign body_val = items[0][body_field] %}
{% assign cta_val = items[0][cta_field] %}
{% assign img_val = items[0][img_field] %}
{% if header_val == blank %}
  {% assign header_val = items[0].header_en %}
{% endif %}
{% if body_val == blank %}
  {% assign body_val = items[0].body_en %}
{% endif %}
{% if cta_val == blank %}
  {% assign cta_val = items[0].cta_text_en %}
{% endif %}
{% if img_val == blank %}
  {% assign img_val = items[0].img_src_en %}
{% endif %}
<img src="{{ img_val }}" alt="" />
<h2>{{ header_val }}</h2>
<p>{{ body_val }}</p>
<a href="#">{{ cta_val }}</a>

Warnung

Wenn der Katalogname, den Sie an catalog_items übergeben, nicht existiert, bricht Braze die Nachricht ab. Setzen Sie unterstützte Sprachcodes auf eine Allowlist, bevor Sie den Katalognamen erstellen. Eine fehlende Artikel-ID in einem vorhandenen Katalog gibt ein leeres Items-Array zurück – Sie können in diesem Fall auf den englischen Katalog zurückfallen.

Setzen Sie die Sprachcodes, die passende Kataloge haben, auf eine Allowlist (hier en, fr und de), verwenden Sie für nicht unterstützte oder leere Werte en als Standard und suchen Sie dann den Artikel. Fehlt die Artikel-ID in diesem Katalog, fällt das System auf den englischen Katalog zurück.

1
2
3
4
5
6
7
8
9
10
11
12

{% assign lang = ${language} | downcase %}
{% assign supported = 'en,fr,de' | split: ',' %}
{% if supported contains lang %}{% else %}{% assign lang = 'en' %}{% endif %}
{% assign theCatalog = 'pantslabyrinth-promo-' | append: lang %}
{% catalog_items {{ theCatalog }} spring-sale %}
{% if items[0] == blank %}
  {% catalog_items pantslabyrinth-promo-en spring-sale %}
{% endif %}
<img src="{{ items[0].img_src }}" alt="" />
<h2>{{ items[0].header }}</h2>
<p>{{ items[0].body }}</p>
<a href="#">{{ items[0].cta_text }}</a>

Siehe Templates in Katalognamen verwenden und Nachrichten abbrechen.

Optionale Katalogselektion nach Kategorie

Filtern Sie Artikel vor der Personalisierung – z. B. Schuh-Aktionen für Nutzer:innen mit preferred_category = footwear:

1
2
3
4

{% catalog_selection_items PantsLabyrinth_Product_Copy footwear_promos %}
{% for item in items %}
  {{ item.name }}
{% endfor %}

Definieren Sie die Selektion im Dashboard mit Filtern auf Ihrer category-Spalte und Nutzerattributen nach Bedarf.

Schritt 4: Vorschau und Test

1. Verwenden Sie Als Nutzer:in Vorschau anzeigen mit Nutzerprofilen, die verschiedene ${language}-Werte haben.
2. Bestätigen Sie den Fallback-Text, wenn die Sprache fehlt oder nicht unterstützt wird, einschließlich teilweiser Lokalisierungen (z. B. ein Name ohne Preis).
3. Bestätigen Sie bei Methode 3, dass jede auf der Allowlist stehende Sprache einen passenden Katalog hat und dass nicht unterstützte Sprachcodes auf Ihren Standardkatalog abgebildet werden, ohne den Versand abzubrechen.

Verwandte Artikel

• Kataloge
• Kataloge verwenden
• Selektionen
• Katalog erstellen
• Erweiterte Liquid-Filter
• Lokalisierung
• Mehrsprachige Nachrichten
• Katalogdaten synchronisieren und löschen
• Liquid-Nachrichten abbrechen