Iterable
Ilya avatar
Written byIlya Updated over a week ago

This app is in beta.

Iterable is a cross-channel marketing platform that powers unified customer experiences and empowers you to create, optimize and measure every interaction across the entire customer journey.

Index

支持内容

Lokalise enables you to translate Iterable emails, as well as Push, SMS and In-App notifications.

Known technical limitations

Currently it's not possible to localize message templates that were created with theDrag-and-Drop editoras it will result in a mismatch between the JSON content generated by the editor and the translated HTML content. We recommend using either the WYSIWYG editor or Side-by-Side editor to create the templates you plan to localize with this integration.

If you want to continue using the Drag-and-Drop editor to create your templates, there are a couple of workarounds you can use to convert the HTML for localization:

  • Export the HTML from any templates you’ve created with the Drag-and-Drop editor, and upload the HTML version to a new Iterable template. This will result in an HTML template that uses the WYSIWYG or Side-by-Side editor. Then import this template to Lokalise.

  • Set up your Lokalise integration to create a new template instead of uploading translated content to an existing Drag-and-Drop template. This will result in an HTML template that uses the WYSIWYG or Side-by-Side editor.

Prerequisites

Before using this app, you should add all the necessary locales on Iterable. To achieve that, proceed to Iterable, click on the "cog" icon in the top menu and chooseProject settings:

找到theLocalessection and add your locales by pressing on the corresponding button:

Please note that your locales should be equal to language ISO codes in your Lokalise project.

Generating an API key on Iterable

安装应用程序,您需要生成一个Iterable API key, therefore clickIntegrations > API keys:

Next clickNew API key:

Give your key a name and make sure to chooseServer-side type:

Once you are ready, clickCreate

Finally, copy your key:

Please note that you won't be able to see the key once you close this dialog therefore make sure to copy the key right away.

Installation

To install the app, open your Lokalise project and clickApps在主菜单。找到Iterablein the apps list, and click on it:

Next, clickInstall。你会be presented with the following screen:

Enter yourIterable API keyin the corresponding field and pressAuthorize

Importing items from Iterable to Lokalise

Once you install the app, the list of available templates on Iterable will be presented for you. The refresh of the content should start immediately; otherwise, clickRefresh:

On theAvailable for importview, choose one or more items and clickImport to Lokalise。你会be presented with the following dialog:

Choose the languages to include in the import operation.

Tick theOverwrite existing keysoption if you want to update existing translation keys with any updates that happened on the Iterable content since the last import. Updated keys will return to theUnverifiedstatus.

If you want to useAutomations, you should import only the default language with theOverwrite existing keysoption enabled. An alternative is to import all the desired languages, but keeping theOverwrite existing keysoption disabled.

Importing will happen in the background, and once the operation is completed, you'll see the following notification:

ClickView activityif you want to see how many keys were created.

Now you can return to theEditorand perform translations as usual, or create tasks for your translators.

Reimporting content to Lokalise

In certain occasions, the content on Iterable might go through some updates before the translations were finished, or even after they were exported. In that case, you can use theRefreshbutton to see the last update date, select which items you want to reimport, and click onReimport to Lokalise

Exporting items from Lokalise to Iterable

Once the translations are reviewed, return to the Iterable app on Lokalise, and switch to theTranslation in progressview. Choose one or more items that areReady to exportand clickExport to Iterable

你会be presented with the following dialog:

Choose one or more languages and hitOK。The operation will be performed in the background, and you'll be notified once it is completed.

Once you've exported the item in all languages, you'll find them under theTranslation exportedview.

Note that if the app is reinstalled, translation statuses of all items are kept. If you want to clean the previous statuses of your items, you need to delete the keys from the Editor.

Note on reviewed translations

Please note that as you mark your translations asreviewedon Lokalise, their statuses will change under theTranslation in progressview. For example, if your project has three languages and you've reviewed the translations for one language only, you'll see the1 of 3 languages translatedlabel.

Only once you have reviewed translations for all languages, the global status for the given item will change toReady for export

You can export any items even if their status is notReady for export

Did this answer your question?