Интеграции
    1. Phrase
    2. Phrase TMS
    3. Интеграции

    Braze (TMS)

    Контент автоматически переведен с английского языка с помощью Phrase Language AI.

    Доступно для

    • планов: Team, Professional, Business- и Enterprise

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Доступно для

    • Тарифные планы Ultimate и Enterprise (устаревшие)

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Коннектор Braze позволяет маркетологам локализовать кампании, канвасы и шаблоны Braze без ручных операций. При подключении Phrase TMS к многоязычному API Braze контент на разных языках автоматически передается между платформами для перевода.

    Эта интеграция предназначена для маркетологов, а не для разработчиков. Она устраняет необходимость в правке кода, экспорте файлов или дублировании шаблонов.

    Коннектор включает функцию унифицированного сопоставления языков, которая автоматически соотносит коды языков Phrase TMS с кодами языков Braze. Распространенные различия, например в регистре (de-DE и de-de) и формате разделителей (en-US и en_us), учитываются автоматически, что сокращает объем ручной настройки. В настройках коннектора администраторы могут задавать пользовательские сопоставления для нестандартных или уникальных кодов локалей. Эти сопоставления имеют приоритет перед автоматическими.

    Автоматические оповещения можно настроить, чтобы переводчики получали уведомления о поступлении нового задания, а маркетологи — о его выполнении.

    Braze требует, чтобы каждый перевод имел уникальный идентификатор тега.

    Руководство по локализации Braze

    Примечание

    Из-за постоянных доработок пользовательский интерфейс может быть не совсем таким, как представлено в видео.

    Структура контента Braze

    • Шаблоны:

      Повторно используемые макеты электронных писем, сообщений в приложении и push-уведомлений, служащие основой для ваших кампаний и канвасов.

    • Кампании:

      Используются для отправки целевых сообщений аудитории по одному или нескольким каналам (электронная почта, push-уведомления или сообщения в приложении). Кампании могут быть разовыми, повторяющимися или запускаемыми по триггеру и позволяют организовать персонализированную многоканальную коммуникацию.

    • Канвасы:

      Многоэтапные сценарии взаимодействия с клиентами, в рамках которых сообщения отправляются по нескольким каналам с учетом триггеров, сегментов аудитории и заданного времени отправки. Канвасы идеально подходят для организации автоматизированных цепочек взаимодействия, основанных на поведении.

    • Блоки контента:

      Повторно используемые фрагменты контента, которые можно встраивать в шаблоны, кампании и канвасы.

    Варианты использования локализации

    • Локализация на уровне шаблона

      Локализуйте шаблоны перед их привязкой к кампаниям или канвасам.

      Ограничения:

      • Поддерживаются только HTML-шаблоны для электронных писем, push-уведомлений и сообщений в приложении (шаблоны с перетаскиванием не поддерживаются).

      • Шаблоны с перетаскиванием поддерживаются в кампаниях и канвасах.

    • Локализация на уровне кампаний и канвасов

      При работе с кампаниями или канвасами можно локализовать дополнительные типы сообщений, в том числе шаблоны с перетаскиванием.

      Кампании и канвасы служат уровнем доставки. Хотя шаблоны с перетаскиванием нельзя локализовать непосредственно из библиотеки шаблонов, их можно локализовать в составе кампаний или канвасов. Это означает, что все типы сообщений можно перевести на соответствующем уровне.

    Ограничения

    Ограничение

    Описание

    Обходной путь

    Шаблоны с перетаскиванием

    Не отображаются как шаблоны

    Локализуйте через кампании или канвасы, и они будут видны в Phrase TMS

    Несоответствия локалей

    Могут вызывать ошибки при создании заданий

    Соблюдайте единообразие кодов локалей с использованием символов подчеркивания

    Отсутствие разрешений

    Может блокировать синхронизацию

    Создайте новые ключи API с доступом к разделам «Template», «Canvas» и «Campaign».

    Варианты использования

    Существует ряд вариантов использования коннектора:

    • Менеджеры проектов могут добавлять файлы непосредственно в проекты из онлайн-хранилища.

    • Настройте портал отправителя, чтобы позволить отправителям добавлять файлы к запросам непосредственно из онлайн-хранилища.

    • Используйте автоматическое создание проектов (APC), чтобы новые проекты создавались автоматически при обнаружении изменений в контенте отслеживаемых документов или папки.

      • APC запускается только при наличии нового или обновленного контента для перевода; экспорт переводов или изменения в контенте, не подлежащем переводу, не приводят к созданию новых проектов.

    • API коннектора можно использовать для автоматизации действий, которые иначе выполнялись бы вручную через пользовательский интерфейс. Вебхуки можно использовать для уведомления сторонних систем об определенных событиях (например, изменении статуса задания).

    Настройки многоязычности Braze

    1. Войдите в свою учетную запись Braze.

    2. В консоли разработчика перейдите в раздел «APIs and Identifiers» меню «Settings».

    3. Выберите «Opt in to Braze IP allowlisting if you plan to make Braze-to-Braze webhooks».

      Если требуется ограничение:

      1. В консоли разработчика перейдите в раздел «Templates».

      2. Откройте параметры раздела «Templates» и выберите «templates.translations.get» и «templates.translations.update».

    4. Создайте новый ключ «Rest API Key».

      Этот ключ необходим для настройки коннектора.

      Ключ REST API привязан к учетной записи пользователя Braze, которая его создала.

      Убедитесь, что выбраны следующие разрешения:

      • Шаблоны

      • Канвасы

      • Кампании

      Если ключ был создан для устаревшего коннектора, он больше не будет работать.

    5. Скопируйте URL-адрес конечной точки REST API Braze.

    6. Убедитесь, что коды языковых локалей в разделе «Workspace Settings» → «Multi-Language Locale Settings» имеют стандартный формат с символом подчёркивания. Дефисы или другие форматы приведут к ошибкам.

    7. Для всех шаблонов, кампаний и этапов канвасов, требующих перевода, убедитесь, что указаны все необходимые локали, включая исходную, и настроена поддержка нескольких языков.

    Настройки Prase TMS

    1. На странице Setup_gear.png «Settings» прокрутите вниз до раздела «Integrations».

    2. Нажмите на «Коннекторы».

      Откроется страница коннекторов.

    3. Нажмите «Новый коннектор».

      Откроется страница «Создать коннектор».

    4. В поле «Type» выберите «Braze» и укажите название коннектора.

    5. Выберите URL-адрес REST-эндпоинта Braze из раскрывающегося списка.

    6. Укажите ключ REST API из раздела «Braze Settings → APIs and Identifiers → API Keys».

    7. Нажмите «Проверить подключение».

      • Если подключение установлено успешно, рядом с кнопкой «Test connection» появится небольшая галочка.

    8. Нажмите «Show optional settings», чтобы настроить дополнительные параметры:

      • Теги для перевода

        Укажите идентификаторы тегов для импортируемого контента. Теги должны совпадать с тегами в Braze.

      • Сопоставление языков

        Нажмите «Add language mapping», чтобы сопоставить языки Braze с языками TMS.

        Каждый язык Phrase можно сопоставить только с одним кодом локали Braze за раз. Если два кода Braze (например, da и visitor_da) сопоставлены с одним и тем же языком Phrase, коннектор автоматически выбирает один из кодов, и нет возможности контролировать, какой именно код будет выбран. Задание для кода, который не был выбран, не создается, и коннектор записывает ошибку для этого языка.

        Для создания задания исходная и все целевые локали, указанные в сопоставлении языков коннектора или APC, должны уже существовать в соответствующем элементе канваса или кампании Braze. Настройки локали на уровне коннектора или APC недостаточно. Если локаль отсутствует в канвасе, импорт завершится ошибкой: исходная или целевая локаль не настроена в элементе Braze. Перед повторной попыткой импорта добавьте недостающие локали непосредственно в канвас Braze.

      • Фильтр недавнего импорта

        Задайте значение параметра «maximum days since last update», чтобы импортировать только контент, обновлённый за указанное число дней. Установите значение 0, чтобы импортировать весь контент независимо от его возраста.

    9. Нажмите Сохранить.

      Коннектор добавлен в список на странице «Коннекторы».

    Локализация HTML-шаблонов писем

    При использовании HTML-редактора Braze контент можно локализовать непосредственно на уровне шаблона. Это особенно удобно для писем, которые используются повторно.

    Чтобы локализовать шаблон HTML-письма, выполните следующие действия:

    1. В разделе «Шаблоны» → «Шаблоны писем» → «HTML-редактор» откройте шаблон.

    2. Добавьте теги перевода:

      • Заключите переводимую область в теги Phrase:

        {% translation phrase_body %}
...your email content here...
{% endtranslation %}

        Рекомендации

        Разместите открывающий тег на первой строке, а закрывающий тег — на последней строке HTML-редактора. Предложения не нужно заключать в теги по отдельности; конвертер Phrase автоматически анализирует все содержимое между двумя тегами, подготавливая его для перевода в рабочем пространстве Phrase TMS. HTML-разметка, ссылки и стили полностью сохраняются в локализованной версии.

      • Чтобы перевести тему и прехедер, заключите их в теги по отдельности:

        {% translation phrase_subject %}Subject text{% endtranslation %}
{% translation phrase_preheader %}Preheader text{% endtranslation %}

    3. Сохраните шаблон.

    4. Снова откройте шаблон, выберите «Многоязычность» и укажите исходную и целевую локали. Убедитесь, что локали совпадают с конфигурацией Phrase.

    5. Сохраните шаблон.

    6. В Phrase TMS выберите «Импорт из интеграции» → Braze → «Шаблоны».

      HTML-шаблон отображается как задание на перевод.

    7. Переведите и проверьте.

    8. После утверждения экспортируйте переводы обратно в Braze.

      Локализованные версии автоматически появляются в соответствующих им локалях. Используйте «Предварительный просмотр и тестирование» → «Многоязычный пользователь», чтобы проверить отображение и расположение элементов.

    Работа с кампаниями и канвасами

    Примечание

    Контекстный предварительный просмотр недоступен в CAT-редакторе для заданий, импортированных из кампаний или канвасов. Phrase TMS получает несколько электронных писем в рамках этих типов контента и не может объединить их в единый HTML-файл для визуализации, поэтому вкладка «Предварительный просмотр» не отображается.

    Чтобы использовать контекстный предварительный просмотр, локализуйте шаблон электронного письма напрямую.

    При локализации в рамках кампаний или канвасов рабочий процесс немного отличается. Вместо отдельного HTML-шаблона локализуются материалы действующих или черновых кампаний, которые могут содержать элементы, созданные с помощью перетаскивания.

    • Локализация выполняется не в библиотеке шаблонов, а непосредственно в кампаниях или канвасах.

    • Шаблоны с функцией перетаскивания становятся доступными для локализации после использования в кампаниях или канвасах.

    • Все типы сообщений (электронные письма, push-уведомления и сообщения в приложении) можно локализовать, если они заключены в теги Phrase.

    Чтобы работать с кампанией или канвасом, выполните следующие действия:

    1. В разделе «Кампании или канвасы» откройте нужный материал.

    2. Добавьте теги перевода:

      • При использовании HTML-редактора

        • Заключите переводимую область в теги Phrase:

          {% translation phrase_body %}
...your email content here...
{% endtranslation %}

          Рекомендации

          Разместите открывающий тег на первой строке, а закрывающий тег — на последней строке HTML-редактора. Предложения не нужно заключать в теги по отдельности; конвертер Phrase автоматически анализирует все содержимое между двумя тегами, подготавливая его для перевода в рабочем пространстве Phrase TMS. HTML-разметка, ссылки и стили полностью сохраняются в локализованной версии.

        • Чтобы перевести тему и прехедер, заключите их в теги по отдельности:

          {% translation phrase_subject %}Subject text{% endtranslation %}
{% translation phrase_preheader %}Preheader text{% endtranslation %}

        • Для писем, созданных в редакторе с функцией перетаскивания, добавьте по одному блоку «Абзац» в начале и в конце письма. Поместите открывающий тег {% translation phrase_body %} в верхний блок, а закрывающий тег {% endtranslation %} — в нижний блок. Так теги охватят всё письмо: заключать в них каждое предложение по отдельности не требуется.

    3. Отметить для перевода

      Если использование тегов настроено на уровне коннектора, отметьте кампанию или канвас тегом перевода.

    4. Импорт в Phrase TMS

      В Phrase TMS перейдите в «Импорт из интеграции» → Braze → «Кампании/Канвасы». Отмеченные тегом кампании появляются в списке доступных для выбора.

      Перед импортом убедитесь, что исходная локаль и все целевые локали добавлены в кампанию или канвас в Braze (настройки многоязычности), а исходная локаль содержит исходный контент. Если целевая локаль отсутствует в элементе, импорт завершится ошибкой в истории APC, даже если формат локали, настроенный в коннекторе, правильный. Если исходная локаль отсутствует или пуста, сообщение не включается в задание, при этом сообщение об ошибке не появляется.

    5. Перевод и проверка

      Лингвисты выполняют перевод в рабочем пространстве Phrase. HTML и форматирование сохраняются автоматически.

    6. Экспорт и предварительный просмотр

      После завершения экспортируйте локализованную версию обратно в Braze. Используйте «Предварительный просмотр и тестирование» → «Многоязычный пользователь», чтобы переключаться между локалями и проверять результат.

    Braze Legacy (TMS)

    Доступно для

    • планов: Team, Professional, Business- и Enterprise

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Доступно для

    • Планы Ultimate и Enterprise (устаревшая версия)

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Важно

    Коннектор Braze (Legacy) будет объявлен устаревшим 30 ноября 2026 г.. Новые экземпляры этого коннектора можно создавать до 17 августа 2026 г. Перейдите на новый коннектор до того, как прежний будет объявлен устаревшим.

    Полное руководство по переходу см. в разделе «Объявление устаревшего коннектора устаревшим».

    Благодаря интеграции Phrase TMS с Braze можно повысить вовлеченность клиентов и стимулировать рост на новых рынках за счет бесшовной локализации. Интеграция позволяет пользователям Braze переводить шаблоны электронных писем и контент-блоки.

    Элементы контента, доступные для перевода:

    Примечание

    Из-за постоянных доработок пользовательский интерфейс может быть не совсем таким, как представлено в видео.

    Варианты использования

    Существует ряд вариантов использования коннектора:

    • Менеджеры проектов могут добавлять файлы непосредственно в проекты из онлайн-хранилища.

    • Настройте портал отправителя, чтобы позволить отправителям добавлять файлы к запросам непосредственно из онлайн-хранилища.

    • Используйте автоматическое создание проектов (APC), чтобы новые проекты автоматически создавались при обнаружении изменений в контенте отслеживаемых документов или папки.

      • APC запускается только при наличии нового или обновленного контента для перевода; экспорт переводов или изменения в контенте, не подлежащем переводу, не приводят к созданию новых проектов.

    • API коннектора можно использовать для автоматизации действий, которые в противном случае выполнялись бы вручную через пользовательский интерфейс. Вебхуки можно использовать для уведомления сторонних систем об определенных событиях (например, изменении статуса задания).

    Настройки Braze

    1. Войдите в свою учетную запись Braze.

    2. Перейдите в консоль разработчика и нажмите «Настройки API».

    3. Создайте новый ключ REST API.

      Этот ключ необходим для настройки коннектора.

    4. Скопируйте URL-адрес REST-эндпоинта Braze.

    Настройки Prase TMS

    1. На странице «Настройки» Setup_gear.png прокрутите вниз до раздела «Интеграции».

    2. Нажмите на «Коннекторы».

      Откроется страница коннекторов.

    3. Нажмите «Новый коннектор».

      Откроется страница «Создать коннектор».

    4. В поле «Тип» выберите Braze и укажите название коннектора.

    5. Выберите URL-адрес REST-эндпоинта Braze из раскрывающегося списка.

    6. Укажите ключ REST API из раздела «Настройки Braze» → «API и идентификаторы» → «Ключи API».

    7. Нажмите «Проверить подключение».

      • Если подключение установлено успешно, рядом с кнопкой «Проверить подключение» появится небольшая галочка.

    8. Нажмите «Показать дополнительные настройки», чтобы настроить дополнительные параметры:

      • Теги для перевода

        Укажите идентификаторы тегов для импортируемого контента. Теги должны совпадать с тегами в Braze.

      • Сопоставление языков

        Нажмите «Добавить сопоставление языков», чтобы сопоставить языки Braze с языками TMS.

        Каждый язык Phrase можно сопоставить только с одним кодом локали Braze за раз. Если два кода Braze (например, da и visitor_da) сопоставлены с одним и тем же языком Phrase, коннектор автоматически выбирает один из кодов, и нет возможности контролировать, какой именно код будет выбран. Задание для кода, который не был выбран, не создается, и коннектор записывает ошибку для этого языка.

        Для создания задания необходимо, чтобы исходная и все целевые локали, указанные в настройках сопоставления языков коннектора или APC, уже существовали в соответствующем сценарии Canvas или элементе кампании Braze. Настроить локаль на уровне коннектора или APC недостаточно. Если локаль отсутствует в сценарии Canvas, импорт завершится ошибкой с указанием на то, что исходная или целевая локаль не настроена в элементе Braze. Прежде чем повторить импорт, добавьте недостающие локали непосредственно в сценарий Canvas в Braze.

      • Фильтр недавнего импорта

        Установите для параметра «максимальное количество дней с момента последнего обновления» нужное значение, чтобы импортировать только контент, обновлённый за указанное число дней. Установите значение 0, чтобы импортировать весь контент независимо от его возраста.

    9. Нажмите Сохранить.

      Коннектор добавлен в список на странице «Коннекторы».

    Была ли эта статья полезной?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.