Passer au contenu

Messages multilingues

Après avoir ajouté des paramètres régionaux à votre espace de travail, vous pouvez cibler des utilisateurs dans différentes langues au sein d’une seule notification push, d’un seul e-mail, webhook, bannière, message in-app ou Content Block.

Prérequis

Fonctionnalité Autorisations utilisateur requises
Locales multilingues Vous devez disposer des autorisations suivantes pour créer et gérer les locales multilingues :

  • Modifier les paramètres de localisation
  • Supprimer les paramètres de localisation

Wait, let me re-check the original. The English source uses .reset-td-br-1 .reset-td-br-2 with hyphens, not underscores. Let me preserve those exactly.

Fonctionnalité Autorisations utilisateur requises
Locales multilingues Vous devez disposer des autorisations suivantes pour créer et gérer les locales multilingues :

  • Modifier les paramètres de localisation
  • Supprimer les paramètres de localisation
Fonctionnalité Autorisations utilisateur requises
Types de messages Vous avez besoin de ces autorisations pour ajouter des paramètres régionaux et des traductions aux campagnes et aux Canvas :

  • Modifier les campagnes
  • Modifier les Canvas
Fonctionnalité Autorisations utilisateur requises
Modèles Vous avez besoin de ces autorisations pour le type de modèle auquel vous souhaitez ajouter des paramètres régionaux et des traductions :

  • Modifier les modèles d’e-mail
  • Modifier les modèles de messages in-app
  • Modifier les modèles de webhook
  • Modifier les modèles de blocs de contenu

Utiliser les paramètres régionaux

Étape 1 : Configurer les paramètres régionaux

Avant de pouvoir ajouter des traductions à un message, vous devez d’abord créer les paramètres régionaux que vous souhaitez prendre en charge. Les paramètres régionaux définissent les variantes de langue (et éventuellement de région) disponibles pour vos messages.

Étape 2 : Marquer le contenu à traduire

Encadrez le texte à traduire avec les étiquettes de traduction Liquid {% translation your_id_here %} et {% endtranslation %}, puis attribuez-lui un ID d’étiquette. Les ID d’étiquettes de traduction doivent être uniques au sein d’un message. Nous vous conseillons d’utiliser des noms d’ID sémantiques qui décrivent clairement le texte, comme {% translation header %}. Si le message contient des Content Blocks, consultez la section Content Blocks contenant des traductions pour savoir comment s’applique cette règle d’unicité.

Voici un exemple de message marqué pour la traduction : {% translation greeting %}Hello!{% endtranslation %}

Localiser les URL

Lors de la traduction de contenu, les URL nécessitent un traitement particulier pour éviter les liens rompus.

URL standard (statiques)

Les URL statiques sont saisies manuellement dans l’éditeur (par exemple, https://example.com). Nous vous recommandons également ce qui suit :

Recommandation Justification
Laissez le protocole (https://) en dehors des étiquettes de traduction. N’encadrez que le domaine et le chemin (par exemple, example.com/en). Les traducteurs risquent de modifier ou de supprimer par erreur des caractères spéciaux, ce qui romprait les liens.
N’incluez pas de paramètres de requête dans les étiquettes de traduction (par exemple, ?utm_source=promo). Les traducteurs risquent de modifier ou de supprimer par erreur des caractères spéciaux, ce qui entraînerait des liens rompus.

Voici une URL standard qui respecte ces deux recommandations :

<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>
URL générées par Liquid

Si votre URL est générée avec Liquid (par exemple, {% landing_page_url %}), nous vous recommandons ce qui suit :

Recommandation Justification
N’encadrez l’URL générée par Liquid d’étiquettes de traduction que si elle doit être localisée. La syntaxe Liquid doit être soigneusement préservée pour s’afficher correctement.
N’incluez pas de paramètres de requête (par exemple, ?utm_source=promo) dans les étiquettes de traduction. Les traducteurs risquent de modifier ou de supprimer par erreur des caractères spéciaux, ce qui entraînerait des liens rompus.

Voici une URL générée par Liquid qui respecte ces deux recommandations :

<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

Attributs et structure HTML

N’encadrez d’étiquettes de traduction que le texte lisible par un humain. Évitez d’encadrer les attributs HTML (comme class, style ou id) ou tout autre code structurel. Les attributs HTML contrôlent la mise en page, le style et les fonctionnalités. Les encadrer d’étiquettes de traduction peut casser la mise en forme ou les styles dans les versions localisées de votre message.

Ce texte est correctement encadré :

<p class="headline" style="color: red;">
  {% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>
Texte incorrectement encadré

Ce texte est incorrectement encadré :

{% translation id_1 %}
<p class="headline" style="color: red;">
  Welcome to our sale
</p>
{% endtranslation %}

Étape 3 : Ajouter des paramètres régionaux à votre message

Après avoir ajouté des étiquettes de traduction à votre message, sélectionnez Gérer les langues dans l’éditeur (Langues dans les éditeurs par glisser-déposer pour l’e-mail et les Content Blocks), puis sélectionnez au moins un paramètre régional pour lequel vous souhaitez ajouter des traductions.

Liste déroulante d’ajout de paramètres régionaux proposant de sélectionner le paramètre régional par défaut ou des attributs personnalisés.

Content Blocks contenant des traductions

Les Content Blocks comportant des étiquettes de traduction se comportent différemment selon que le bloc possède ou non ses propres traductions enregistrées :

État du Content Block Où les traductions sont gérées
Étiquettes de traduction, mais aucun paramètre régional ni traduction enregistrée CSV Gérer les langues du message parent
Étiquettes de traduction avec paramètres régionaux et traductions enregistrées CSV propre au Content Block ou API de traduction
Content Blocks avec traductions enregistrées

Si votre message contient des Content Blocks dont les traductions sont déjà enregistrées, vous n’avez pas besoin de téléverser à nouveau ces traductions. Les traductions enregistrées s’appliquent automatiquement lorsque le Content Block est ajouté à votre message. Ces blocs conservent leurs propres ID d’étiquettes, qui n’ont pas besoin d’être uniques par rapport au message parent. Pour savoir comment enregistrer des traductions directement dans le bloc, consultez la section Enregistrer des traductions dans les Content Blocks.

Dans la fenêtre modale Gérer les langues, les Content Blocks avec traductions enregistrées apparaissent dans la liste, accompagnés des paramètres régionaux qu’ils prennent en charge. Vous voyez ainsi quelles parties de votre message sont déjà localisées avant d’ajouter de nouvelles traductions.

Section Gérer les langues affichant une liste de Content Blocks avec des traductions enregistrées.

Content Blocks avec étiquettes de traduction uniquement

Lorsqu’un Content Block comporte des étiquettes de traduction mais aucun paramètre régional ni traduction enregistrée, ses étiquettes sont traitées comme du contenu source non traduit dans le message parent. L’export Gérer les langues du parent inclut ces étiquettes, et le CSV du parent doit fournir leurs traductions. Ces étiquettes doivent être uniques par rapport aux autres étiquettes du message parent.

Si vous réutilisez un Content Block non traduit dans un autre message, ce second message doit lui aussi fournir des traductions pour les étiquettes du bloc. Pour éviter de fournir des traductions dans chaque message qui utilise un Content Block, ajoutez des paramètres régionaux et des traductions directement dans le Content Block.

Étape 4 : Ajouter des traductions

Après avoir sélectionné les paramètres régionaux, ajoutez des traductions à votre message à l’aide de l’une des méthodes suivantes :

Onglet d’ajout de traductions proposant de téléverser les traductions par CSV ou de se connecter à des partenaires de traduction.

Sélectionnez Télécharger le modèle pour télécharger un CSV contenant une matrice des ID de traduction et des paramètres régionaux sélectionnés.

Lorsque vous remplissez le modèle, ne traduisez que le contenu textuel de chaque paramètre régional. Si des balises HTML figurent dans le modèle téléchargé, laissez-les inchangées et ne traduisez que le texte qu’elles contiennent.

Par exemple, si le modèle contient :

<p style="margin:0;margin-bottom:0">A charming bakery dedicated to crafting artisanal breads.</p>

Traduisez uniquement le texte A charming bakery dedicated to crafting artisanal breads. et conservez les balises HTML <p style="margin:0;margin-bottom:0"> et </p> telles quelles.

Ensuite, téléversez le fichier complété : les traductions seront appliquées à votre message.

CSV avec des étiquettes de traduction pour un titre, un texte d’offre, un montant d’offre et un CTA.

Utilisez l’API de traduction d’un partenaire pour gérer et mettre à jour les traductions de vos Campaigns, Canvas, Content Blocks, modèles d’e-mail et modèles de webhook. C’est utile si vous utilisez un système externe de localisation ou si vous souhaitez vous connecter directement à un partenaire de traduction.

Pour utiliser les endpoints de traduction avec des Canvas, incluez les paramètres suivants :

  • workflow_id
  • step_id
  • message_variation_id

Étape 5 : Prévisualiser les traductions

Pour prévisualiser votre message, sélectionnez l’option Utilisateur multilingue dans la liste déroulante Prévisualiser en tant qu’utilisateur. Vous pouvez ainsi basculer entre différentes définitions de paramètres régionaux pour prévisualiser toutes les traductions de votre message.

Aperçus par paramètre régional

Gérer les traductions

Dupliquer des étapes de Canvas ou des Campaigns avec leurs traductions

Lorsque vous dupliquez une étape de Canvas, une Campaign ou une variante, les traductions sont incluses. C’est également le cas lors d’une copie entre espaces de travail, à condition que les langues soient définies dans l’espace de travail de destination. Pensez à vérifier et à mettre à jour les traductions lorsque vous modifiez votre Canvas ou votre Campaign.

Enregistrer les traductions dans les Content Blocks

Les Content Blocks prennent en charge le multilingue de la même manière que les messages. Lorsque vous créez ou modifiez des Content Blocks, vous pouvez étiqueter du contenu à traduire, ajouter des langues et téléverser des traductions à l’aide d’un fichier CSV ou de l’API de traduction.

Les traductions enregistrées restent associées au Content Block. Lorsque le bloc est ajouté à un message, ses traductions sont automatiquement incluses.

Messages de droite à gauche

Lorsque vous remplissez le fichier de traduction pour des langues qui s’écrivent de droite à gauche (comme l’arabe), entourez la traduction d’une balise span pour qu’elle soit correctement mise en forme :

{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}

Dans les Campaigns par e-mail, Braze suit les liens en ajoutant des informations de suivi (paramètres de requête) à chaque URL. Ce comportement prend en charge à la fois l’aliasage de lien et le modèle de lien.

Lorsqu’une URL est entourée d’étiquettes de traduction, Braze peut ne pas être en mesure de déterminer où ajouter ces informations de suivi. Pour que cela fonctionne correctement, vous devez ajouter un caractère spécial à la fin de l’URL afin d’indiquer où le suivi doit être ajouté.

Les URL utilisent deux caractères spéciaux pour contrôler ce fonctionnement :

  • ? ajoute le suivi à une URL qui n’en contient pas encore.
  • & ajoute un suivi supplémentaire si un ? est déjà présent dans l’URL. Une URL ne peut contenir qu’un seul ?.
URL Contient ? Description Exemple
URL standard Non Ajoutez ? après l’étiquette de traduction fermante si l’URL n’en contient pas déjà un. <a href="https://{% translation id_1 %}example.com{% endtranslation %}?">Shop Now</a>
URL standard Oui Utilisez & à la fin de l’URL (après l’étiquette de traduction fermante) si elle contient déjà ?. <a href="https://{% translation id_1 %}example.com{% endtranslation %}?ref=4&">Shop Now</a>
Générée par Liquid Non Utilisez ? après les étiquettes de traduction fermantes si l’URL générée n’en contient pas déjà un. <a href="{% translation id_1 %}{{ product_url }}{% endtranslation %}?">Shop Now</a>
Générée par Liquid Oui Utilisez & après l’étiquette de traduction fermante si l’URL générée contient déjà un ?. <a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}&">Shop Now</a>

Paramètres de langue et accessibilité

Commencez par la section Langue d’accessibilité de la page Accessibilité pour en savoir plus sur le contexte WCAG, le comportement selon le canal et l’éditeur (y compris pour les pages de destination) et les paramètres d’Accessibilité au niveau du message.

Lorsque vous utilisez des messages multilingues, alignez la langue d’accessibilité sur chaque langue afin que les envois localisés déclarent la langue appropriée.

Configurer la langue d’accessibilité

Vous pouvez définir la langue d’accessibilité à deux niveaux :

Niveau du message

Au niveau du message, définissez la langue d’accessibilité dans la section Accessibilité des paramètres de votre message. Pour savoir comment sélectionner une langue, utiliser Liquid et connaître les limites selon le canal, consultez la section Langue d’accessibilité.

Niveau de la langue

Pour les messages multilingues, définissez la langue d’accessibilité de chaque langue dans les Paramètres de localisation. Vous pouvez utiliser {{accessibility_language}} dans la section Accessibilité afin que la langue du document ou de la carte corresponde à ces valeurs de langue.

L’affichage par défaut de ce jeton pour les nouveaux messages dépend du canal et de l’éditeur. Par exemple, les messages in-app et les bannières ne se comportent pas de la même manière que les pages de destination et les e-mails en glisser-déposer. Pour plus de détails, consultez la section Langue d’accessibilité.

Foire aux questions

Quelles sont les limites des étiquettes de traduction ?

Les limites suivantes s’appliquent aux étiquettes de traduction :

  • Chaque message peut contenir jusqu’à 200 étiquettes de traduction.
  • Chaque texte par défaut (le contenu situé entre les étiquettes de traduction) peut contenir jusqu’à 2 000 caractères.
  • Les traductions par langue peuvent atteindre 409 600 octets (environ 409,6 Ko).

Pourquoi une erreur s’affiche-t-elle lorsque je télécharge des modèles d’e-mail multilingues ?

Si vous rencontrez des erreurs lors du téléchargement de modèles d’e-mail multilingues, il est possible que les étiquettes de traduction englobent des attributs HTML ou des styles CSS qui entrent en conflit avec la façon dont Braze traite le corps des e-mails.

Braze traite le corps HTML et le corps en texte brut comme des composants distincts d’un même message. Lorsque les étiquettes de traduction incluent des références href et des styles CSS, cela peut générer des étiquettes en conflit qui empêchent le téléchargement correct du modèle.

Pour résoudre ce problème :

  • Excluez les références href et les styles CSS des étiquettes de traduction.
  • N’englobez dans les étiquettes de traduction que le contenu textuel lisible par un humain, comme décrit dans Attributs et structure HTML.
  • Pour les URL, suivez les recommandations de la section Localiser les URL.

Puis-je modifier le texte traduit dans l’une de mes langues ?

Oui. Commencez par effectuer la modification dans le fichier CSV, puis téléversez à nouveau le fichier pour mettre à jour le texte traduit.

Braze fournit-il des traductions ?

Non. Vous devez fournir vos propres traductions, soit en téléversant un fichier CSV, soit en utilisant l’API de traduction.

Puis-je imbriquer des étiquettes de traduction ?

Non.

Puis-je englober des messages HTML entiers dans une étiquette de traduction ?

Non. La bonne pratique consiste à n’englober que le texte lisible par un humain ou le contenu à localiser. Vous évitez ainsi de casser la mise en forme, les liens ou d’autres éléments non textuels.

Pensez également à englober des fragments de texte plus courts et sémantiquement liés afin d’obtenir des traductions précises et d’éviter les limites de performance ou de taille.

Puis-je modifier le texte traduit dans l’une de mes langues ?

Oui. Si vous utilisez un fichier CSV, effectuez d’abord la modification dans le fichier, puis téléversez-le à nouveau pour mettre à jour le texte traduit. Si vous utilisez l’API de traduction, utilisez les endpoints de mise à jour pour effectuer vos modifications.

Quelles validations ou vérifications supplémentaires Braze effectue-t-il ?

Scénario Validation dans Braze
Un message contient au moins deux ID de traduction identiques associés à des textes différents. Ce fichier de traduction ne sera pas téléchargé.
Il manque un ou plusieurs ID d’étiquette de traduction dans un fichier de traduction. Ce fichier de traduction ne sera pas téléversé.
Un fichier de traduction contient des langues absentes du message. Ce fichier de traduction ne sera pas téléversé.
Des étiquettes de traduction doivent être ajoutées au message avant le téléchargement du modèle de traduction. Ce fichier de traduction ne sera pas téléchargé.
Des étiquettes de traduction présentes dans votre fichier téléversé sont absentes de votre message. Les traductions supplémentaires ne seront pas enregistrées dans le message.
Un message contient une ou plusieurs étiquettes Liquid incorrectes. Pour ouvrir les étiquettes, utilisez {% translation your_id_here %}, et fermez les étiquettes de traduction avec {% endtranslation %}. Ce fichier de traduction ne sera pas téléchargé.
Un fichier de traduction contient un texte par défaut qui ne correspond pas à celui du message. Les traductions sont ajoutées, mais le texte d’origine du message n’est pas mis à jour.
Une ou plusieurs langues d’un message ont été supprimées dans les paramètres et n’existent plus. Les traductions déjà ajoutées restent présentes dans le message. Si elles sont supprimées du message, les traductions sont perdues.
Des étiquettes de traduction contiennent des URL complètes ou générées par Liquid. Les étiquettes de traduction contenant des URL sont signalées en cas de problèmes de liens cassés ou de suivi des liens.
Des étiquettes de traduction incluent des paramètres de requête. Les étiquettes de traduction contenant des paramètres de requête sont signalées en cas de problèmes de liens cassés ou de suivi des liens.
Des étiquettes de traduction contiennent des attributs ou des structures HTML. Les étiquettes de traduction contenant des attributs ou des structures HTML sont signalées en cas de problèmes de styles et de mise en forme.
New Stuff!