Transifex

Transifex permet une localisation robuste à travers votre base d’utilisateurs, quelle que soit la langue.

L’intégration de Braze et Transifex s’appuie sur le contenu connecté pour vous permettre d’extraire une collection de chaînes de caractères de ressources et d’inclure les traductions pertinentes dans vos messages au lieu de lignes de formatage conditionnel basées sur la langue. Cette intégration automatise la traduction et libère vos équipes pour qu’elles se concentrent sur la fourniture d’expériences client brillantes.

Conditions préalables

Intégration

L’intégration de Transifex utilise l’API de traduction des ressources de Transifex. L’outil cURL suivant vous permettra de voir si votre compte a des valeurs de contenu associées à des traductions.

Tout d’abord, saisissez les adresses <ORGANIZATION_NAME>, <PROJECT_NAME> et <RESOURCE_NAME> qui se trouvent dans votre compte Transifex. Ensuite, remplacez <LANGUAGE> par le code de la langue par laquelle vous souhaitez filtrer les traductions, et <TRANSIFEX_BEARER_TOKEN> par votre jeton de porteurTransifex.

1
2
3
4
curl --request GET \
     --url 'https://rest.api.transifex.com/resource_translations?filter\[resource\]=o:<ORGANIZATION_NAME>:p:<PROJECT_NAME>:r:<RESOURCE_NAME>&filter\[language\]=l:<LANGUAGE>' \
     --header 'Accept: application/vnd.api+json' \
     --header 'Authorization: Bearer 1/<TRANSFIX_BEARER_TOKEN>'

Par exemple, si votre projet Transifex se trouve à l’emplacement https://www.transifex.com/appboy-3/french2/french_translationspo/, le project_name sera “french2” et le resource_name sera “french_translationspo”.

Exemple de message sur le contenu connecté

Cet extrait de code utilise l’API de traduction des ressources Transifex et l’attribut language de l’utilisateur. En fonction de vos besoins, vous pouvez ensuite parcourir les objets de la chaîne de caractères et en extraire le contenu pertinent à l’aide du Liquid suivant : ``.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% assign organization = "<ORGANIZATION_NAME>" %}
{% assign project = "<PROJECT_NAME>" %}
{% assign resource = "<RESOURCE_NAME>" %}

{% if {{${language}}} == "en" or {{${language}}} == "it" or {{${language}}} == "de" or {{${language}}} == "another_language_you_support"  %}
{% connected_content
     https://rest.api.transifex.com/resource_translations?filter[resource]=o:{{organization}}:p:{{project}}:r:{{resource}}&filter[language]=l:{{${language}}}
     :method GET
     :headers {
       "Authorization": "Bearer <TRANSIFEX_BEARER_TOKEN>"
  }
     :accept application/vnd.api+json
     :save strings
%}
{% endif %}

{% if {{strings}} != null and {{strings.data[0].attributes.strings.other}} != "" and {{${language}}} != null %}
  {{strings.data[0].attributes.strings.other}}
{% else %}
  {% abort_message('null or blank') %}
{% endif %}