Интеграции

Braze (TMS)

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

Доступно для

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

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

Доступно для

  • Планы Ultimate и Enterprise (Legacy)

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

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

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

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

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

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

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

Примечание

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

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

  • Шаблоны

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

  • Кампании:

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

  • Канвасы:

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

  • Контентные блоки:

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

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

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

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

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

    • Поддерживаются только HTML-шаблоны для email, push и in-app (не drag-and-drop).

    • Шаблоны drag-and-drop поддерживаются при использовании в кампаниях и канвасах.

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

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

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

Ограничения

Ограничение

Описание

Обходное решение

Шаблоны drag-and-drop

Не видны как шаблон

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

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

Может привести к ошибкам при создании задания

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

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

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

Обеспечьте создание новых ключей API с предоставлением доступа к Template, Canvas и Campaign

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

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

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

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

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

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

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

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

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

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

  3. Выберите опцию разрешения IP для Braze, если планируете создавать вебхуки Braze-to-Braze.

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

    1. Перейдите в раздел Templates в консоли разработчика.

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

  4. Создайте новый Rest API Key.

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

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

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

    • Шаблоны

    • Канвасы

    • Кампании

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

  5. Скопируйте Braze REST Endpoint URL.

  6. Убедитесь, что языковые локали в разделе Workspace Settings — Multi-Language Locale Setttings представлены в стандартном формате с подчеркиванием. Дефисы или другие форматы приведут к ошибкам.

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

Настройки Prase TMS

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

  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 и укажите идентификаторы тегов.

  9. При необходимости выберите папку по умолчанию (возможно только после сохранения).

  10. Нажмите «Сохранить».

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

Удаление коннектора

Чтобы удалить коннектор:

  1. На странице Integrations выберите коннектор для удаления.

  2. Нажмите Delete.

    Откроется окно Delete connector.

  3. Введите «delete» и нажмите Delete.

    Коннектор удален, и отображается список коннекторов.

Примечание

Коннектор нельзя удалить, пока он связан с незавершёнными заданиями в проекте, включая задания, находящиеся в корзине. Попытка удалить такой коннектор приводит к ошибке «Не удалось удалить коннектор».

Решение: Откройте проект, связанный с коннектором, и завершите или удалите все оставшиеся задания. Перейдите в Настройки/Корзина и очистите её, чтобы удалить все задания, которые всё еще связаны с коннектором. Повторите попытку удаления коннектора.

Локализация шаблонов электронных писем в формате HTML

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

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

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

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

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

      {% translation phrase_body %}
      ...содержимое вашего электронного письма здесь...
      {% endtranslation %}

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

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

    • Чтобы перевести тему и прехедер, оберните их по отдельности:

      {% translation phrase_subject %}Текст темы{% endtranslation %}
      {% translation phrase_preheader %}Текст прехедера{% endtranslation %}
      
  3. Сохраните шаблон.

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

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

  6. В Phrase TMS выберите Import from Integration - Braze - Templates.

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

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

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

    Локализованные версии появятся автоматически в соответствующих локалях. Используйте Preview & Test - Multi-language user, чтобы проверить отображение и макет.

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

Примечание

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

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

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

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

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

  • Все типы сообщений (email, push, in-app) можно локализовать, если обернуть их тегами Phrase.

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

  1. Из Campaigns or Canvases откройте нужный актив.

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

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

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

        {% translation phrase_body %}
        ...содержимое вашего электронного письма здесь...
        {% endtranslation %}

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

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

      • Чтобы перевести тему и прехедер, оберните их по отдельности:

        {% translation phrase_subject %}Текст темы{% endtranslation %}
        {% translation phrase_preheader %}Текст прехедера{% endtranslation %}
        
      • Для писем с поддержкой drag-and-drop добавьте один блок Paragraph в начале и один в конце письма. Поместите открывающий тег {% translation phrase_body %} в верхний блок, а закрывающий тег {% endtranslation %} — в нижний блок. Это охватывает все письмо целиком; каждое предложение не нужно оборачивать отдельно.

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

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

  4. Импорт в Phrase TMS

    В Phrase TMS перейдите в Import from Integration - Braze - Campaigns/Canvases. Отмеченные кампании появятся для выбора.

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

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

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

    После завершения экспортируйте локализованную версию обратно в Braze. Используйте Preview & Test - Multi-language user для переключения локалей и проверки.

Braze Legacy (TMS)

Доступно для

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

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

Доступно для

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

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

Важно

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

См. полное руководство по миграции в разделе Legacy Connector Deprecation.

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

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

Примечание

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

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

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

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

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

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

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

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

Настройки Braze

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

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

  3. Создайте новый Rest API Key.

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

  4. Скопируйте Braze REST Endpoint URL.

Настройки Prase TMS

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

  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 и укажите идентификаторы тегов.

  9. При необходимости выберите папку по умолчанию (возможно только после сохранения).

  10. Нажмите «Сохранить».

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

Удаление коннектора

Чтобы удалить коннектор:

  1. На странице Integrations выберите коннектор для удаления.

  2. Нажмите Delete.

    Откроется окно Delete connector.

  3. Введите «delete» и нажмите Delete.

    Коннектор удалён, и отображается список коннекторов.

Примечание

Коннектор нельзя удалить, пока он связан с незавершёнными заданиями в проекте, включая задания, находящиеся в корзине. Попытка удалить такой коннектор приводит к ошибке «Не удалось удалить коннектор».

Решение: Откройте проект, связанный с коннектором, и завершите или удалите все оставшиеся задания. Перейдите в Настройки/Корзина и очистите её, чтобы удалить все задания, которые всё ещё связаны с коннектором. Повторите попытку удаления коннектора.

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

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.