The Braze Connector supports translation of HTML email templates and content blocks. Translations are requested from within the Smartling platform, and translated content is automatically sent to Braze.
Once the Braze Connector has been connected and set up, you will find Braze content in the Braze tab in your Smartling project. Here, you will be able to manage the translation process. From the Braze tab, you will be able to request and authorize content for translation.
Translating Blocks
Braze Content Blocks can be used to translate Campaigns, Canvases, and emails. Here are some important considerations to follow when translating Blocks.
- All blocks must have the following structure:
{% if ${language} == 'en' %} This is a message in English from Braze! {% else %} This is a message from Braze! This will go to anyone who does not match the other specified languages! {% endif %}Where "en" is locale code configured as "Source Language (Braze)" under the Language Configuration of your Braze Connector Settings.
-
The connector will parse the condition block for the Source Language and ingest it as source content. In other words, in the above example, only "This is a message in English from Braze!" string will be ingested.
- On delivery, the connector creates or updates language blocks. This is how the block will appear after delivery.
{% if ${language} == 'en' %} This is a message in English from Braze! {% elsif ${language} == 'es' %} Este es un mensaje en español de Braze ! {% elsif ${language} == 'zh' %} 这是一条来自Braze的中文消息。 {% else %} This is a message from Braze! This will go to anyone who does not match the other specified languages! {% endif %} - Content must be smaller than 50kb, which includes: liquid script, HTML tags, user content, source and translations.
Translating Emails
It is important that all emails you send for translation include a subject line. Although you can create emails in Braze without a subject line, their API does not support updating emails with empty subject lines. You can edit the subject line at a later stage. If you modify the subject line after it has been translated, only the changes are sent for translation.
Request Translations
There are two ways in which you can Request Translation;
1) Select the asset > Actions > Request Translation. This option also allows you to select multiple assets for translation.
2) Click the information icon of an asset > Request Translation. This option allows you to request translation for only that individual asset.
Both options will open the Request Translation wizard.
The Request Translation two-step wizard will appear for you to enter the Job details. You can choose to create a New Job or add the asset to an Existing Job.
- Insert the Job Name - the title for the translation task in Smartling.
- Ensure the file selection is correct. Click the X to remove any asset listed.
- Insert a description for the linguists, if desired.
- Select the Target Languages.
- Click Save Job and Continue to create the Job in Smartling.
The next step will display the Job Processing. Once the processing is complete, the Authorize Job button will activate by turning blue. Click Authorize Job to set a Job Due Date, choose the workflow and submit the asset(s) for translation.
Translation Delivery to Braze
As translations are completed, they are automatically sent to Braze. Files that have never been translated in Smartling before are delivered back as soon as the file has been translated in Smartling.
Files that have been translated previously but have since been updated, the translations are returned to Braze immediately.
You can always get the translation to Braze manually as well. To perform a manual export of translated content from Smartling to Braze:
- From your Braze project, click the Braze tab
- Select the translated assets to download (Bulk-Select and Export is supported)
- Click Actions and select Export Translation
Content Blocks
Smartling delivers translated content blocks within the original (source) content block - meaning one block in Braze contains all languages, including the source.
Emails With Blocks
If an email contains a block, Smartling does not automatically ingest the block. The block contained in the email must be translated separately.
Editing Translations in Smartling
If you update the translations in Smartling, the updated translations will deliver back to Braze within the scheduled cron.