---
title: "Локализация писем в Adapty Mail"
description: "Отправляйте одну кампанию Adapty Mail на нескольких языках: каждый получатель видит письма на языке своего устройства, а английский используется как резервный."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-skills && claude plugin install adapty-skills@adapty` — other tools: `npx skills add adaptyteam/adapty-skills --all`

Чтобы обращаться к пользователям на их родном языке, локализуйте кампании. Adapty Mail переводит письма кампании с помощью ИИ и отправляет каждому получателю версию на языке его устройства — или на английском, если нужного языка в кампании нет. Все переводы хранятся внутри одной кампании, так что создавать отдельную кампанию или сегмент для каждой страны не нужно.

Вы можете локализовать любую кампанию — маркетинговую или транзакционную. У каждой кампании свои переводы: ни у проекта, ни у флоу нет языков по умолчанию, и каждая новая кампания создаётся только на английском. В [A/B-тесте](mail-ab-testing) каждый вариант — это отдельная кампания, поэтому нужно локализовать каждый вариант для одних и тех же аудиторий. Так тест сравнивает сами письма, а не разные рынки.

## Что переводится, а что нет \{#what-is-and-isnt-translated\}

Adapty Mail переводит:

- Тему и прехедер
- Текст письма и версию в виде простого текста
- Текст кнопок
- Alt-текст изображений
- Текст на главном изображении (hero image)

Adapty Mail оставляет без изменений:

- Ссылки и адрес получателя письма
- Плейсхолдеры, например `{{ company_address }}`
- Макет и стили
- Логотип и все изображения, кроме главного (hero image)

## Перевод кампании \{#translate-a-campaign\}

У каждой кампании свои переводы: Adapty Mail не применяет выбор языка одной кампании к другим.

1. В Adapty Mail перейдите в раздел **Campaigns** и откройте существующую кампанию или создайте новую.
2. Прокрутите до раздела **Emails** в редакторе кампании и нажмите **Localize**. Откроется меню выбора языка.

### Выберите языки \{#select-languages\}

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

Adapty Mail сопоставляет получателей по языку устройства, а не по стране: получатель в Германии с устройством, настроенным на английский, получит письма на английском. Эти данные поступают из [Adapty](mail-collect-emails), из [FunnelFox](mail-funnelfox) или передаются как `device_info.locale` в запросах [Adapty Mail API](mail-send-data-via-api). FunnelFox передаёт язык браузера в качестве локали.

Adapty определяет локаль пользователя следующим образом:

1. Adapty Mail берёт локаль с самого нового устройства в профиле. У профиля может быть несколько устройств — например, телефон и ноутбук. Если с самого нового устройства локаль не поступила, Adapty Mail проверяет следующее по новизне устройство, с которого она была отправлена. Если ни одно устройство не отправило локаль, получатель получает письма на английском языке.
2. Сначала ищется точное совпадение среди переводов кампании, например `pt-BR`. Если такого нет, проверяется локаль без региона, например `pt`.
3. Если ничего не совпало, получатель получает письма на английском языке.

Adapty Mail устанавливает язык один раз — когда получатель входит во флоу. Все письма в цепочке отправляются на этом языке, даже если впоследствии язык устройства изменится.

В списке языков выберите языки, на которые нужно локализовать кампанию.

#### Региональные варианты \{#regional-varieties\}

Португальский и китайский языки встречаются в списке дважды. Чтобы охватить всех получателей, использующих эти языки, выберите оба варианта:

- **Бразильский португальский** и **Португальский**: Получатели видят бразильский португальский только если язык их устройства — бразильский португальский (`pt-BR`). Все остальные получатели с португальским языком устройства получают **португальский** — европейский вариант. Бразильские получатели тоже получают его, если в кампании нет бразильского португальского.
- **Традиционный китайский** и **Упрощённый китайский**: Получатели видят традиционный китайский только если язык устройства установлен на китайский (Тайвань) (`zh-TW`). Все остальные получатели с китайским языком устройства получают упрощённый китайский, независимо от письма. Тайваньские получатели тоже получают его, если в кампании нет версии на традиционном китайском.

Для всех остальных языков действует единый вариант для всех регионов:

- **Английский**: Письма с `en-US` и `en-GB` идентичны. То же самое получают пользователи, чей язык устройства не локализован в кампании, и профили без указанного языка (locale).
- **Испанский**: В списке языков есть только одна запись **Spanish** — без отдельного латиноамериканского варианта. Она охватывает все испаноязычные локали устройств: `es-MX`, `es-ES` и прочие.

### Добавить переводы

1. В списке языков выберите нужные и нажмите **Localize**. Дождитесь завершения перевода. Пока он идёт, вы не можете редактировать английский источник или сохранить кампанию. Страницу можно закрыть: Adapty Mail хранит переводы 2 часа. Если вы вернётесь позже — переводы исчезнут, нажмите **Try again**, чтобы локализовать снова. Если кампания новая, держите вкладку браузера открытой.
2. Проверьте каждую локализованную версию:
   - Чтобы увидеть письмо так, как его увидят получатели, нажмите Preview на карточке письма.
   - Чтобы получить письмо в свой почтовый ящик, нажмите **Send test email**.
   - Проверьте текст на каждом hero-изображении и убедитесь, что ничего лишнего на нём не изменилось. Чтобы перевести письмо заново, включая текст на hero-изображении, нажмите Re-localize this email **Re-localize this email** на карточке письма.
   - Проверьте названия брендов, названия продуктов, цены и даты в каждом переводе. Adapty Mail не верифицирует их после перевода.
   - Чтобы вручную исправить перевод, отредактируйте поля **Subject**, **Template HTML** или **Plain text** письма. Поле **Delay** всегда соответствует исходному письму.

3. Когда всё готово, нажмите **Save** или **Create**. Обязательно сохраните изменения перед тем, как закрыть или обновить страницу: переводы хранятся только в вашем браузере.

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

### Проверка перевода

Adapty Mail сравнивает каждое переведённое письмо с английским оригиналом. Меняется только текст: перевод сохраняет те же абзацы, изображения и кнопки в том же порядке с теми же ссылками и плейсхолдерами. Если что-то отличается — например, появляется лишний абзац — Adapty Mail переводит письмо заново. Если письмо продолжает не проходить проверку, весь перевод завершается с ошибкой, и вы можете [попробовать снова](#troubleshooting). Adapty Mail не проверяет hero-изображения в переводах, поэтому проверьте их самостоятельно.

## Сравнение эффективности по языкам \{#compare-performance-by-language\}

Чтобы сравнить, как письма работают на каждом языке, откройте [Analytics](mail-analytics#group-break-down-filter) и выберите **Email language** в выпадающем списке **Group by**. Чтобы ограничить сравнение одной кампанией, нажмите **Add filter** > **Campaigns** и выберите нужную кампанию.

**Email language** — это язык, на котором было отправлено письмо, а не язык устройства получателя. В строку **English** попадают письма получателям, для которых не нашлось подходящего перевода, а также все письма, отправленные до 6 октября 2026 года.

## Управление переводами \{#manage-translations\}

### Значки переводов \{#translation-badges\}

Значки на вкладках языков и карточках email-рассылок отображают состояние каждого перевода:

| Значок | Отображается на | Значение |
| --- | --- | --- |
| **New** | Вкладка языка, любая карточка письма | Adapty Mail добавит перевод или письмо при сохранении. |
| **Modified** | Вкладка языка, любая карточка письма | Изменения этого перевода или письма применятся при сохранении. |
| **Outdated** | Вкладка языка, переведённое письмо | Английское письмо изменилось после того, как Adapty Mail его перевёл. |
| **Not translated** | Английское письмо | Как минимум в одном переводе этого письма ещё нет. |
| **Translations outdated** | Английское письмо | Это письмо устарело как минимум в одном переводе. |

### Обновление переводов \{#update-translations\}

Когда вы меняете тему, HTML или текстовую версию исходного письма либо перегенерируете его, переводы сохраняют прежний текст. Adapty Mail помечает их как **Outdated**. Новое изображение-баннер ведёт себя иначе: во всех переводах сразу появляется новое изображение, а текст на нём (если был) берётся из оригинала.

Чтобы снова перевести письма, нажмите один из следующих элементов:

- Update translations **Update translations** на исходном письме. Переводит это письмо там, где перевод устарел.
- Re-localize this email **Re-localize this email** на переведённом письме. Переводит только это письмо.
- **Re-localize** на вкладке языка: переводит все письма в этом переводе.

Затем сохраните кампанию. Если вы сгенерируете всю последовательность заново и сохраните, Adapty Mail удалит все существующие переводы.

### Удаление переводов \{#remove-translations\}

Чтобы удалить перевод из черновика, перейдите на его вкладку и нажмите **Remove**. Adapty Mail удалит его при сохранении.

В активной или неактивной кампании нельзя удалить перевод, добавить письмо или удалить письмо. Чтобы внести эти изменения, обновите все переводы со статусом **Outdated** и сохраните кампанию. Затем продублируйте её и работайте с копией как с отдельной кампанией. Получатели, уже находящиеся в последовательности исходной кампании, продолжат получать её письма.

:::note
Дублирование кампании сбрасывает статус перевода. Устаревший текст отображается как актуальный. Перед активацией дублированной кампании проверьте переводы.
:::

## Ограничения \{#limitations\}

- **Изображения не локализуются, кроме главного**: Если логотип или другое изображение содержит видимый текст, он остаётся на исходном языке.
- **Главное изображение нельзя редактировать в переводе**: Чтобы изменить его, загрузите другое изображение в исходное письмо, а затем [повторно локализуйте письмо](#update-translations) в каждом переводе.
- **Страницы не локализуются**: Adapty Mail переводит только письма. Страница подтверждения double opt-in и страница отписки остаются на английском для всех получателей.
- **Язык не передаётся в назначение**: Все переводы ведут на одно и то же назначение, и Adapty Mail не передаёт язык письма туда.

## Устранение неполадок \{#troubleshooting\}

- **Получатель получает письмо на английском вместо своего языка**: Когда получатель вошёл во флоу, его локаль не совпала ни с одним из переводов кампании согласно [правилам подбора языка](#select-languages). Чтобы узнать, на каком языке он получил письма, откройте [journey](mail-profiles#the-activity-journey) профиля: там отображается тема каждого отправленного письма. Частые причины:
  - **У профиля нет локали**: Для профилей, которые вы отправляете через Adapty Mail API, передавайте `device_info.locale`.
  - **На устройстве установлен другой язык**: Язык определяется по устройству, а не по стране.
  - **Региональный вариант отсутствует**: Например, в кампании есть бразильский португальский, а устройство использует `pt-PT`. Добавьте португальский.
  - **Получатель начал последовательность до того, как вы добавили его перевод**: Он будет получать письма на английском, пока его последовательность не завершится.
- **Получатели получают устаревший перевод после редактирования английского письма**: Правки темы, HTML или текстовой версии меняют только исходное письмо. Его переводы остаются прежними, и Adapty Mail помечает их значком **Outdated** [badge](#translation-badges). Чтобы применить изменения ко всем переводам, [обновите переводы](#update-translations) и сохраните кампанию. Письма, отправленные после этого, будут использовать обновлённые переводы. Уже отправленные письма не изменятся.
- **В переводе отображается изображение-герой с текстом на английском**: Adapty Mail перевёл письмо до того, как вы изменили изображение-герой исходного письма, или до 6 октября 2026 года. В карточке письма строка **Hero image** показывает **Same as English**. Чтобы перевести текст на изображении, [повторно локализуйте письмо](#update-translations) и сохраните кампанию. Письма, отправленные после этого, будут использовать новую версию.
- **Кнопка Save или Create неактивна**: Adapty Mail выполняет перевод, либо в каком-то переводе не хватает одного из английских писем. Письмо в переводе отсутствует, если вы добавили письмо в уже локализованный черновик. В баннере этого перевода нажмите **Localize it** или **Localize them**, если писем несколько.
- **Перевод завершился с ошибкой**: Если одно письмо или его изображение-герой не удалось перевести, Adapty Mail отбрасывает весь перевод на этот язык: кампания сохраняет предыдущий перевод или остаётся без него. Остальные переводы из того же запуска появляются на своих вкладках. Чтобы сохранить их, сохраните кампанию. Если запуск не завершается в течение 10 минут, Adapty Mail отбрасывает его результат. Чтобы повторить попытку, в уведомлении **Couldn't localize** нажмите **Try again**.
- **Кампания, сгенерированная на другом языке, имеет вкладку English (base)**: До запуска локализации 1 октября 2026 года Adapty Mail мог генерировать кампании на другом языке. Каждая такая кампания теперь имеет английскую версию, а исходный язык является одним из её переводов. Получатели с этим языком устройства по-прежнему получают оригинальные письма, все остальные — письма на английском.