Crowdin
Crowdin est une plateforme de gestion de la localisation basée sur l’intelligence artificielle qui aide les équipes à automatiser la traduction de leurs logiciels, applications et contenus marketing.
Connectez Crowdin à Braze pour gérer les traductions de vos Campaigns et expériences Canvas. La synchronisation automatisée fonctionne avec la traduction automatique, la mémoire de traduction et les glossaires, garantissant ainsi la cohérence entre les flux de travail humains et automatisés.
Cette intégration est maintenue par Crowdin.
À propos de l’intégration
Crowdin propose deux applications pour Braze : Braze Campaigns & Canvas et Braze Email Templates. Choisissez en fonction des fonctionnalités de Braze que vous localisez. Le tableau suivant les compare.
Choisir la bonne application Crowdin
| Canal ou fonctionnalité | Braze Campaigns & Canvas | Braze Email Templates |
|---|---|---|
| Campaigns | ✅ Pris en charge | ❌ Non pris en charge |
| Étapes du Canvas | ✅ Pris en charge | ❌ Non pris en charge |
| Modèles d’e-mail | ❌ Non pris en charge | ✅ Pris en charge |
| Content Blocks | ❌ Non pris en charge | ✅ Pris en charge |
Prérequis
| Condition requise | Description |
|---|---|
| Compte Crowdin | Un compte Crowdin.com ou un compte Crowdin Enterprise est requis. |
| Projet Crowdin | Avant de connecter Braze, créez un projet de traduction dans Crowdin ou Crowdin Enterprise. |
| Clé API REST Braze | Une clé API REST Braze disposant des autorisations pour les Campaigns, Canvas, Content Blocks, les attributs personnalisés, les e-mails et les modèles. |
| Endpoint REST Braze | L’URL de votre endpoint REST Braze spécifique (par exemple, https://rest.iad-03.braze.com). |
| Paramètres multilingues Braze | Les locales doivent être configurées dans votre tableau de bord de Braze sous Paramètres > Paramètres de localisation. |
Intégration Braze Campaigns & Canvas
Si vous localisez du contenu dans des messages en direct, utilisez l’application Braze Campaigns & Canvas pour synchroniser les chaînes traduisibles de vos brouillons de Campaign et Canvas avec le support multilingue de Braze.
Pour une présentation vidéo, consultez Intégration Braze Campaigns & Canvas.
Étape 1 : Configurer les paramètres multilingues dans Braze
Avant de connecter Crowdin, ajoutez vos langues cibles dans Braze.
- Dans Braze, accédez à Paramètres > Paramètres de localisation.
- Ajoutez les langues que vous prévoyez de prendre en charge.

- Notez chaque clé de locale (par exemple,
en-US,fr-FR,es-ES). Vous utiliserez ces valeurs pour mapper les langues dans Crowdin.
Étape 2 : Configurer le projet Braze dans Crowdin
- Dans votre compte Crowdin Enterprise ou Crowdin.com, accédez à Store dans le menu de navigation.
- Recherchez Braze Campaigns & Canvas, puis sélectionnez Install.

- Sélectionnez le ou les projets dans lesquels vous souhaitez utiliser cette intégration.
- Pour ouvrir l’intégration, accédez à Integrations > Braze Campaigns & Canvas dans votre projet.
Connecter Braze à Crowdin
Autorisez la connexion avec vos identifiants d’API Braze :

- Clé REST API Braze : Créez-la dans Braze sous Paramètres > API et identifiants > Clés API. Accordez les permissions nécessaires à cette intégration (Campaigns, Canvas, Content Blocks et attributs personnalisés).
- Endpoint REST Braze : Saisissez l’URL de votre instance Braze (par exemple,
https://rest.iad-03.braze.com). Pour en savoir plus, consultez Endpoints REST API.

Sélectionnez Log in with Braze Campaigns & Canvas.
Étape 3 : Configurer le mappage des langues dans Crowdin
Après avoir connecté votre compte, mappez chaque langue de projet Crowdin à la locale Braze correspondante.
- Dans le tableau de bord de l’intégration Braze Campaigns & Canvas, sélectionnez l’icône d’engrenage Settings dans la barre d’actions supérieure.

- Ouvrez l’onglet General Settings.
- Saisissez les clés de locale. Crowdin liste les langues de votre projet (par exemple, français, italien). Dans chaque champ, saisissez la clé de locale Braze correspondante.
- Par exemple, si Braze utilise
itpour l’italien, saisisseziten face de l’italien dans Crowdin. - Chaque entrée doit correspondre exactement à la clé de locale de cette locale dans les Paramètres de localisation de Braze.
- Par exemple, si Braze utilise

- Sélectionnez Save pour confirmer le mappage.
Étape 4 : Ajouter des balises de traduction à votre message Braze
Crowdin lit les mêmes balises de traduction Liquid que Braze utilise pour les messages multilingues. Ajoutez {% translation your_id_here %} et {% endtranslation %} autour de chaque élément de texte, URL d’image ou URL de lien que vous souhaitez traduire. Chaque bloc nécessite un id unique (par exemple, greeting ou welcome_header).
Exemple :
{% translation greeting %}Hello!{% endtranslation %}
Pour le HTML, le Liquid dans les liens et d’autres cas de figure, suivez les mêmes règles que dans Traduire les locales (par exemple, placez les balises autour des segments les plus petits possibles, et n’encadrez que les parties spécifiques à la langue des URL lors de la localisation des liens).
Enregistrez votre message Braze en tant que brouillon avant que Crowdin puisse détecter et récupérer le contenu.
Étape 5 : Gérer les traductions dans Crowdin
L’écran d’intégration comporte deux volets :
- Volet Braze : Vos Campaigns et Canvas.
- Volet Crowdin : Le contenu déjà synchronisé pour la traduction.

Synchroniser le contenu
- Dans le volet Braze, cochez la case de la Campaign ou du Canvas à traduire.
- Sélectionnez Sync to Crowdin.
- Une fois la synchronisation terminée, le fichier apparaît dans le volet Crowdin. Les traducteurs peuvent ouvrir les chaînes dans l’éditeur Crowdin.
Renvoyer les traductions vers Braze
- Lorsque les traductions sont complètes à 100 % dans Crowdin, revenez à l’onglet Integrations.
- Sélectionnez le contenu terminé dans le volet Crowdin.
- Sélectionnez Sync to Braze. Cela pousse les chaînes traduites dans les variantes linguistiques correspondantes de votre Campaign Braze.
Étape 6 : Prévisualiser le message en tant qu’utilisateur multilingue dans Braze
Pour confirmer l’intégration :
- Ouvrez votre Campaign dans le Braze Message Composer.
- Accédez à l’onglet Test.
- Sélectionnez Preview Message as User.
- Recherchez un profil utilisateur dont l’attribut
languagecorrespond à l’une de vos locales traduites. - Confirmez que le contenu passe de la langue source à la version traduite.
Intégration Braze Email Templates
Si vous localisez vos e-mails au niveau des modèles, utilisez l’application Braze Email Templates pour synchroniser le HTML depuis votre bibliothèque multimédia Braze.
Pour un tutoriel vidéo, consultez Intégration Braze Email Templates.
Étape 1 : Installer l’application
- Dans votre projet Crowdin, accédez à l’onglet Store.
- Recherchez Braze Email Templates et sélectionnez Install.

- Sélectionnez le ou les projets dans lesquels vous souhaitez utiliser cette intégration.
- Pour ouvrir l’intégration, accédez à Integrations > Braze Email Templates dans votre projet.
Étape 2 : Se connecter à Braze
Autorisez la connexion avec vos identifiants API Braze :

- Clé REST API Braze : Accordez les permissions
templates.emailetcontent_blocks(lecture et écriture). Créez la clé dans Braze sous Paramètres > API et identifiants > Clés API.

- Pour l’endpoint REST Braze, utilisez l’URL spécifique à votre instance (par exemple,
https://rest.iad-03.braze.com). - Sélectionnez Log in with Braze Email Templates.
Étape 3 : Synchroniser le contenu pour la traduction
L’écran d’intégration affiche votre bibliothèque Braze :
- Panneau Braze : Les Email Templates et les Content Blocks que vous pouvez synchroniser.
- Panneau Crowdin : Le contenu en cours de traduction.
- Dans le panneau Braze, cochez la case à côté des modèles ou blocs que vous souhaitez localiser.
- Sélectionnez Sync to Crowdin.
- Crowdin récupère le code HTML source. Les traducteurs travaillent dans l’éditeur Crowdin avec un aperçu WYSIWYG en direct pour préserver la mise en page.

Étape 4 : Livrer les modèles traduits
Lorsque les traductions atteignent 100 % :
- Sélectionnez les fichiers terminés dans le panneau Crowdin.
- Sélectionnez Sync to Braze.
- Crowdin crée automatiquement des versions localisées de ces ressources dans votre bibliothèque multimédia Braze (par exemple,
Template_Name_fr).
