Gérer le contenu localisé avec les catalogues Braze

Stockez les chaînes de caractères et les URL localisées dans des catalogues pour que chaque utilisateur reçoive le contenu dans sa langue à partir d’une seule Campaign ou d’un seul Canvas, sans créer de variantes séparées par langue.

À propos de cet exemple

PantsLabyrinth, un détaillant de vêtements fictif, vend ses produits en Amérique du Nord et en Europe. Les noms de produits, les prix et les images principales varient selon la langue, mais l’équipe marketing souhaite un seul modèle d’e-mail ou de notification push qui se personnalise au moment de l’envoi.

Cet exemple couvre trois modèles de catalogue qui lisent l’attribut standard ${language} de l’utilisateur (collecté par le SDK à partir de la langue de l’appareil) :

• Champs d’objet JSON : toutes les langues dans une seule ligne par élément
• Colonnes plates par langue : header_en, header_fr, etc.
• Catalogue séparé par langue : nom de catalogue dynamique tel que pantslabyrinth-promo-en

Utilisez les catalogues lorsque le contenu localisé est constitué de données structurées (produits, promotions, URL d’images). Pour le contenu libre dans les e-mails ou les notifications push, préférez les messages multilingues lorsque vos canaux les prennent en charge. Pour comparer les modèles de localisation de manière plus générale, consultez Gestion des traductions.

Points à considérer

• Les exemples sont illustratifs. Vérifiez la casse et le format de ${language} dans votre base d’utilisateurs avant de nommer les clés ou suffixes de catalogue.
• Pour les méthodes 1 et 2, si ${language} est vide ou ne correspond à aucune clé ou champ du catalogue, le contenu localisé peut être vide — vérifiez chaque champ indépendamment et utilisez une valeur par défaut (par exemple l’anglais).
• Pour la méthode 3, autorisez uniquement les codes de langue pris en charge avant de construire le nom du catalogue ; un catalogue manquant annule le message.
• Les objets JSON dans les catalogues peuvent être créés ou mis à jour via l’API ou l’ingestion de données cloud (CDI) pour les catalogues, et non via un import CSV.
• La méthode 2 prend en charge la maintenance par CSV mais multiplie les colonnes à mesure que les langues s’ajoutent. Les fichiers CSV prennent en charge jusqu’à 1 000 colonnes.
• La méthode 3 nécessite un catalogue pour chaque code de langue qui atteint la balise catalog_items. Si le catalogue n’existe pas, Braze annule le message. Un ID d’élément manquant dans un catalogue existant renvoie un tableau d’éléments vide.
• Les balises Liquid de catalogue ne peuvent pas être utilisées de manière récursive.
• Les sélections de catalogue prennent en charge jusqu’à 10 filtres et renvoient jusqu’à 50 éléments — validez les filtres par rapport au schéma de votre catalogue.
• Consultez les niveaux de stockage des catalogues si vous gérez de grands flux de produits multilingues.

Configuration

Étape 1 : Choisir une structure de catalogue

Choisissez une structure de catalogue en vous appuyant sur les indications de ce tableau.

Étape 2 : Créer le catalogue et les éléments

1. Accédez à Data Settings > Catalogs et créez un catalogue (ou plusieurs catalogues pour la méthode 3).
2. Ajoutez des champs et des éléments en fonction de la structure choisie. Consultez Créer un catalogue.
3. (Facultatif) Créez une sélection de catalogue pour filtrer les éléments — par exemple par category correspondant à un attribut personnalisé de l’utilisateur.

• méthode 1 : champs json
• méthode 2 : champs plats
• méthode 3 : catalogue par langue

Étape 3 : Ajouter le Liquid à votre message

Sélectionnez le modèle Liquid correspondant à la structure de catalogue que vous avez choisie à l’étape 1.

• méthode 1 : champs json
• méthode 2 : champs plats
• méthode 3 : catalogue par langue

Stockez toutes les langues dans des champs d’objet JSON sur une seule ligne de catalogue, puis utilisez le filtre property_accessor pour lire les clés name et price correspondant à ${language} (normalisé en majuscules). Vérifiez chaque champ indépendamment et utilisez EN par défaut lorsque ce champ est vide, de sorte qu’une langue avec un nom mais sans prix affiche quand même un prix en anglais.

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

Consultez Filtre property accessor.

Construisez des noms de champs dynamiques à partir de ${language} (normalisé en minuscules), puis lisez ces champs dans l’élément avec une recherche par crochets. Par exemple, items[0][header_field] lit l’en-tête pour la langue résolue. Vérifiez chaque champ indépendamment et utilisez la colonne anglaise par défaut lorsque ce champ est vide, de sorte qu’une langue avec un en-tête mais sans corps reçoit quand même le texte du corps en anglais.

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>

Avertissement

Si le nom de catalogue que vous transmettez à catalog_items n’existe pas, Braze annule le message. Autorisez uniquement les codes de langue pris en charge avant de construire le nom du catalogue. Un ID d’élément manquant dans un catalogue existant renvoie un tableau d’éléments vide — vous pouvez utiliser le catalogue anglais comme solution de repli dans ce cas uniquement.

Autorisez les codes de langue qui possèdent des catalogues correspondants (ici en, fr et de), attribuez les valeurs non prises en charge ou vides à en par défaut, puis recherchez l’élément. Si l’ID de l’élément est manquant dans ce catalogue, utilisez le catalogue anglais comme solution de repli.

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>

Consultez Utiliser des modèles dans les noms de catalogue et Annuler des messages.

Sélection de catalogue facultative par catégorie

Filtrez les éléments avant la personnalisation — par exemple les promotions de chaussures pour les utilisateurs ayant preferred_category = footwear :

1
2
3
4
{% catalog_selection_items PantsLabyrinth_Product_Copy footwear_promos %}
{% for item in items %}
  {{ item.name }}
{% endfor %}

Définissez la sélection dans le tableau de bord avec des filtres sur votre colonne category et des attributs utilisateur selon vos besoins.

Étape 4 : Prévisualiser et tester

1. Utilisez Preview as User avec des profils utilisateur ayant différentes valeurs de ${language}.
2. Vérifiez le contenu de repli lorsque la langue est manquante ou non prise en charge, y compris les localisations partielles (par exemple un nom sans prix).
3. Pour la méthode 3, confirmez que chaque langue autorisée dispose d’un catalogue correspondant, et que les codes de langue non pris en charge sont redirigés vers votre catalogue par défaut sans annuler l’envoi.

Articles connexes

• Catalogues
• Utiliser les catalogues
• Sélections
• Créer un catalogue
• Filtres Liquid avancés
• Localisation
• Messages multilingues
• Synchroniser et supprimer les données de catalogue
• Annuler des messages Liquid