Настройка платформы Email

Примечание

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

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

Верифицируйте вашу учетную запись

Первый шаг — верификация вашей учетной записи. Это необходимо для обеспечения надежной и безопасной доставки ваших писем. Верификация помогает предотвратить неправомерное использование платформы для спама или вредоносных действий и обеспечивает соблюдение нормативных требований.

Выполните следующие шаги для завершения процесса верификации:

1. Перейдите в Settings > Configure platforms.

2. Найдите Email message и нажмите Configure.

3. В появившейся форме укажите URL-адрес веб-сайта вашей компании в поле Your company website URL (например, https://example.com).

4. В поле Primary technical contact введите адрес электронной почты человека, который управляет техническими аспектами вашей интеграции. Этот контакт будет использоваться для технических запросов или проблем.

5. В поле Tell us about how you’ll be using Pushwoosh предоставьте подробную информацию о том, как вы собираетесь использовать Pushwoosh для своих email-кампаний. Включите такую информацию, как:

• Типы сообщений, которые вы планируете отправлять (например, новостные рассылки, рекламные предложения и т.д.).

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

После заполнения всей информации нажмите Verify my account, чтобы отправить запрос. Pushwoosh рассмотрит ваши данные и ответит как можно скорее.

После верификации вашей учетной записи вы получите подтверждающее письмо. Затем вы сможете перейти к настройке параметров отправителя электронной почты.

Для этого:

1. Перейдите в Settings.
2. Выберите Configure platforms.
3. Нажмите Continue configuration рядом с платформой email.

Настройте данные отправителя

Добавьте домен

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

В поле Domain введите домен, который вы хотите использовать для отправки писем (например, yourcompany.com). Этот домен должен быть верифицирован через DNS на следующем шаге, прежде чем его можно будет использовать в ваших email-кампаниях.

Совет

В верхней части экрана вы увидите оставшееся количество доменов, которые можно добавить. Чтобы увеличить этот лимит, пожалуйста, свяжитесь с нашей службой поддержки

Добавьте данные отправителя по умолчанию

Адрес отправителя

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

• Name: Введите имя отправителя (например, John).
• Email: Введите адрес электронной почты отправителя до символа ”@”. Например, для marketing@yourcompany.com введите marketing.

Как определяются данные отправителя в Customer Journeys и разовых рассылках

Эти данные отправителя по умолчанию используются, когда отправитель не указан в контенте письма или на шаге Journey (или разовой рассылки). Отправитель, указанный на шаге Customer Journey или в форме разовой рассылки, имеет приоритет как над контентом письма, так и над настройками платформы по умолчанию. Отправитель, указанный в контенте письма, имеет приоритет над настройками платформы по умолчанию.

Установите флажок Use this as reply-to address to track replies, если вы хотите, чтобы ответы от получателей поступали непосредственно на адрес электронной почты отправителя.

Адрес для ответа

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

• Reply-To name: Имя, которое будет отображаться как контакт для ответов.
• Reply-To email: Адрес электронной почты, на который должны отправляться ответы.

Если оба поля останутся пустыми, ответы будут отправляться на адрес электронной почты отправителя по умолчанию, указанный в разделе From address.

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

Настройте DNS-записи

Может потребоваться техническая помощь

---

Добавление DNS-записей требует доступа к настройкам DNS вашего домена. Если вы не уверены, как их настроить, обратитесь за помощью к вашей IT-команде или провайдеру домена.

Для аутентификации вашего домена и включения отправки писем для ваших кампаний настройте следующие DNS-записи в настройках DNS вашего хостинг-провайдера:

• DKIM (Обязательно). Эта запись ставит цифровую подпись на ваши письма, позволяя почтовым провайдерам проверять, что письмо исходит от вашего домена и не было изменено в пути.
• SPF (Обязательно): Эта запись указывает, каким почтовым серверам разрешено отправлять письма от имени вашего домена, что помогает предотвратить спуфинг.
• DMARC (Обязательно): Эта запись предоставляет инструкции по обработке неаутентифицированных писем и отправке отчетов вам, повышая безопасность электронной почты.

DKIM-записи (обязательно)

Что такое DKIM-записи?

DKIM (DomainKeys Identified Mail) — это метод аутентификации электронной почты, который позволяет принимающим серверам проверять, что письмо было отправлено указанным доменом и не было изменено в пути.

Добавляя DKIM-записи в ваши DNS-настройки, вы применяете криптографическую подпись к исходящим письмам. Эта подпись подтверждает, что содержимое сообщения осталось неизменным, и аутентифицирует его как легитимное сообщение от вашего домена.

Скопируйте CNAME-записи и добавьте их в ваши DNS-настройки.

Для настройки DKIM вам потребуется добавить все четыре CNAME (Canonical Name) записи в ваши DNS-настройки. Эти записи необходимы для аутентификации вашего домена и подтверждения того, что письма, отправленные с вашего домена, авторизованы.

Примечание

DNS-провайдеры обрабатывают записи по-разному. Некоторые требуют вставить всю запись (имя хоста + домен), в то время как другим нужна только уникальная часть ключа (имя хоста без домена). Ознакомьтесь с инструкциями вашего DNS-провайдера о том, как добавлять записи.

Если запись настроена неправильно, под ней появляется примечание с описанием проблемы, например:

• Запись отсутствует.
• Запись указывает на неверное значение.
• К записи по-прежнему дважды добавлено имя вашего домена.
• Запись опубликована как TXT-запись вместо CNAME.
• DNS не ответил. Проверьте снова через несколько минут.

После добавления необходимых DNS-записей процесс верификации домена обычно занимает от 5 до 10 минут, но в некоторых случаях может занять до 24 часов. В течение этого времени вы не сможете отправлять письма через Pushwoosh, пока верификация не будет завершена. Тем временем вы можете продолжить другие шаги настройки и вернуться позже, чтобы проверить статус верификации.

Нажмите Verify DNS records, чтобы обновить статус верификации после добавления DNS-записей. Как только верификация будет успешной, статус верификации домена изменится на Verified.

Отправьте тестовое письмо

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

Чтобы отправить тестовое письмо:

1. В разделе Email Channel Configuration нажмите Send test email.

2. В открывшейся форме введите данные отправителя и получателя:

• From: Адрес электронной почты отправителя, который вы настроили.
• Recipient: Введите адрес электронной почты, на который вы хотите отправить тестовое письмо. По умолчанию это поле заполнено адресом вошедшего в систему пользователя, но при необходимости его можно изменить.

3. Выберите контент письма из выпадающего списка для включения в тестовое письмо.
4. Нажмите Send.

Отправка не удастся, если домен не верифицирован

Если домен “From” или домен для ответа не полностью верифицирован, создание тестового письма теперь немедленно завершится ошибкой From email domain is not verified или Reply email domain is not verified, вместо того чтобы тестовое письмо создавалось, но молча отбрасывалось при фактической отправке. Проверьте статус домена в Ваши домены отправителя, завершите настройку всех DNS-записей, которые все еще отмечены как Pending, и попробуйте снова.

SPF-записи (обязательно)

Pushwoosh требует настройки записи Sender Policy Framework (SPF) для авторизации своих почтовых серверов на отправку писем от имени вашего домена. SPF — это протокол аутентификации электронной почты, который помогает предотвратить спуфинг и улучшает доставляемость писем.

Примечание

Перед добавлением новой SPF-записи проверьте, есть ли у вашего домена уже такая запись, так как большинство DNS-провайдеров разрешают только одну SPF-запись на домен.

Добавление новой SPF-записи

Если у вашего домена нет SPF-записи, добавьте новую TXT-запись со следующим значением.

Значение SPF

"v=spf1 include:spf.pushwoosh.io ~all"

В зависимости от вашего DNS-провайдера, имя записи может быть пустым или установлено как @.

Добавление к существующей SPF-записи

Если у вашего домена уже есть SPF-запись, просто добавьте следующий SPF-механизм в вашу существующую запись, чтобы авторизовать Pushwoosh.

include:spf.pushwoosh.io

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

Верификация DMARC (обязательно)

DMARC (Domain-based Message Authentication, Reporting, and Conformance) — это протокол аутентификации электронной почты. Он помогает защитить ваш домен от несанкционированного использования, такого как спуфинг.

Pushwoosh требует, чтобы DMARC был настроен на вашем домене для обеспечения безопасной и аутентифицированной доставки писем. Для получения дополнительной информации о DMARC см. документацию по протоколу DMARC.

DMARC-запись, которую Pushwoosh генерирует для вас, использует политику только мониторинга (p=none): неаутентифицированные письма по-прежнему доставляются и попадают в отчеты, а не помещаются в карантин и не отклоняются. Если у вашего домена уже есть DMARC-запись с более строгой политикой, оставьте существующую запись, а не заменяйте ее.

Для настройки DMARC:

1. Скопируйте DMARC TXT-запись, показанную на этом шаге.

2. Перейдите в настройки вашего DNS-провайдера и добавьте DMARC-запись в DNS-настройки. Пожалуйста, обратитесь к документации вашего DNS-провайдера, если вам нужна помощь в добавлении этих записей.
3. Включите отчетность (необязательно). Чтобы получать отчеты о проблемах с аутентификацией и безопасностью электронной почты, добавьте адрес электронной почты в поле rua в параметре Value.

Проверка статуса домена и исправление проблем

После добавления записей используйте кнопки над списком DNS-записей:

• Verify DNS records: нажмите после добавления или изменения записей, чтобы обновить их статус.
• Send test email: убедитесь, что отправка работает, когда домен настроен (см. Отправьте тестовое письмо).
• Copy instructions: скопируйте все необходимые DNS-записи с примечаниями по настройке в виде обычного текста, чтобы вставить их куда угодно.
• Email to your IT team: откройте почтовый клиент с теми же заполненными инструкциями, готовыми к отправке тому, кто управляет вашим DNS.

Если что-то требует вашего внимания, баннер над записями сообщает, в чем проблема:

• Some required DNS records are missing or wrong: проверьте примечание под каждой записью, чтобы узнать, как ее исправить.
• DNS records are in place: Pushwoosh нашел ваши записи и подтверждает их у почтового провайдера. Это отдельный шаг, не связанный с распространением DNS, описанным в разделе DKIM-записи. Обычно он занимает до 30 минут, и от вас ничего не требуется.
• Verification stopped before the records were added: ваши записи теперь корректны, но предыдущая попытка верификации истекла. Нажмите Restart verification в баннере. Ваши SPF- и DMARC-записи останутся без изменений, и DKIM-записи обычно тоже не меняются. После перезапуска проверьте DKIM-записи на случай, если они изменились.
• This domain does not exist in DNS: имя домена не зарегистрировано или не может быть найдено. Проверьте написание или сначала зарегистрируйте домен.

Если в баннере указан DNS-провайдер (например, «DNS for this domain is managed at …»), добавьте записи у него, а не у регистратора домена.

Выбор другого домена

Если на этом шаге вы поняли, что вам нужно изменить домен, нажмите Choose different domain. Затем вы сможете добавить новый домен отправителя.

Имейте в виду, что изменение имени вашего домена сгенерирует новые DNS-записи. Это гарантирует, что лимит доменов отслеживается правильно, и исключает любые домены, которые вам больше не нужны.

Настройте отслеживание ссылок

Отслеживание ссылок помогает вам понять, как ваша аудитория взаимодействует со ссылками в ваших письмах, добавляя UTM-параметры. С помощью UTM-меток вы можете отслеживать вовлеченность в email-рассылках непосредственно в Google Analytics или любой другой аналитической системе, которая отслеживает UTM.

Примечание

Если вы решите не настраивать отслеживание URL-адресов Google Analytics, Pushwoosh все равно будет отслеживать клики по ссылкам и предоставлять базовую статистику. Просто оставьте переключатель Google Analytics URL tracking выключенным и нажмите Complete setup.

Чтобы включить отслеживание ссылок, включите переключатель Google Analytics URL tracking.

К вашим ссылкам будут добавлены следующие UTM-параметры:

• utm_source: Идентифицирует источник трафика.

• utm_medium: Указывает маркетинговый канал, который по умолчанию установлен как “email”.

• utm_campaign: Добавляет код кампании (например, ID кампании). Вставляется автоматически.

• utm_content: Отслеживает конкретный контент в письме, например, тему. Вставляется автоматически.

Link Preview показывает пример того, как будут выглядеть ваши ссылки с выбранными UTM-параметрами.

3. После настройки UTM-параметров нажмите Complete setup, чтобы сохранить настройки.

UTM-метки будут автоматически добавлены к каждой ссылке в вашем письме, что позволит вам отслеживать источник, канал, кампанию и эффективность контента непосредственно в Google Analytics.

Просмотр и управление настройками вашего email-канала

После настройки вашего email-канала панель Email channel configuration предоставляет обзор и позволяет управлять ключевыми настройками для отправки писем, включая домены отправителя, данные отправителя по умолчанию и опции отслеживания ссылок.

Статус конфигурации

Вверху вы можете видеть статус email-платформы, который указывает, настроена ли она. Если платформа не настроена, это может быть по следующим причинам:

• Данные отправителя по умолчанию не указаны. Узнайте больше о данных отправителя по умолчанию.

• Неверифицированный домен установлен в качестве отправителя по умолчанию. Узнайте больше о верификации вашего домена.

Ваши домены отправителя

В разделе Your sender domains вы можете просматривать и управлять доменами, которые вы используете для отправки писем, и статусом каждого домена:

• READY: Домен настроен и готов к отправке писем.
• NOT READY: Верификация домена не завершена, обычно из-за ожидающей верификации DKIM, которая является обязательной. Домены, отмеченные как NOT READY, не могут отправлять письма до тех пор, пока все необходимые верификации не будут завершены. Чтобы завершить настройку, нажмите на имя домена в списке.

Кроме того, в этом разделе отображается статус каждой записи верификации (DKIM, SPF, DMARC) как Verified или Pending. Pending указывает, что запись либо ожидает верификации, либо еще не была настроена. Если домен все еще показывает Pending, хотя вы добавили DNS-записи, свяжитесь со службой поддержки Pushwoosh, чтобы уточнить, какие записи требуются для вашей учетной записи.

Нажмите Update status, чтобы обновить статус верификации для каждого домена.

Добавление домена

Чтобы добавить дополнительные домены, нажмите Add domain. Чтобы увеличить этот лимит, пожалуйста, свяжитесь со службой поддержки.

Удаление домена

Важно

---

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

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

1. В Your Sender Domains найдите домен для удаления.
2. Нажмите на меню из трех точек рядом с именем домена и выберите Delete domain.
3. Подтвердите удаление или нажмите Cancel, чтобы сохранить домен.

Примечание: Если домен установлен в качестве адреса “From” по умолчанию в каком-либо проекте, вы не сможете его удалить, пока информация об отправителе не будет обновлена в этих проектах. Появится сообщение об ошибке со списком проектов, использующих этот домен в качестве отправителя по умолчанию. Обновите адрес “From” в каждом проекте на другой верифицированный домен, а затем попробуйте удалить домен снова.

Отправка тестового письма

Из списка доменов вы также можете отправить тестовое письмо.

Для этого нажмите на меню из трех точек рядом с настроенным доменом и выберите Send Test Email. Обратите внимание, что эта опция доступна только для полностью настроенных доменов.

Данные отправителя по умолчанию

В этом разделе вы можете просматривать и управлять данными отправителя по умолчанию, включая:

• From Address: Имя и адрес электронной почты, которые будут отображаться в качестве отправителя в письмах.
• Reply-To Address: Имя и адрес электронной почты по умолчанию для ответов.

Чтобы внести изменения, нажмите Edit default sender details.

Важно

---

Email-канал не будет настроен, если вы не укажете данные отправителя по умолчанию, и появится предупреждающее сообщение. Чтобы установить данные отправителя по умолчанию, нажмите Set sender details.

Отслеживание URL-адресов Google Analytics

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

При включении UTM-параметры автоматически добавляются к ссылкам в письмах, что позволяет отслеживать вовлеченность пользователей в Google Analytics. Вы также увидите Link Preview, показывающий, как будут выглядеть ваши URL-адреса с UTM-метками.

Настройка email через Pushwoosh API

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

Настройте центр предпочтений подписки

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

Настройте пользовательский домен для отслеживания

Click Tracking Domain (CTD) — это доменная часть URL-адреса отслеживаемой ссылки, отображаемой в email-сообщении. Он состоит из поддомена и вашего основного домена, например, click.yourdomain.com. Поддомен создается в DNS-настройках вашего домена у вашего доменного провайдера, обычно путем добавления CNAME-записи. С помощью CTD вы можете оборачивать ссылки в письмах для отслеживания кликов на вашем собственном поддомене, сохраняя при этом доставляемость и корректную работу диплинков.

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

Чтобы настроить пользовательский домен для отслеживания:

1. Решите, какой поддомен вы будете использовать в качестве вашего CTD (например, click.yourdomain.com).
2. В Pushwoosh откройте Settings, затем выберите Configure Platforms.
3. На странице Email channel configuration прокрутите до Custom tracking domain и выберите Enable.

Примечание

Раздел Custom tracking domain отображается только после того, как email-канал настроен для вашего приложения. Если вы его не видите, сначала завершите настройку email.

4. Введите ваш CTD в поле Domain и выберите Next.

5. Вне Pushwoosh откройте сервис, где вы управляете публичными DNS для домена вашего CTD (обычно это ваш регистратор доменов, DNS-хостинг или ваш хостинг-аккаунт). В его редакторе DNS или зон для этого домена добавьте CNAME, который Pushwoosh показывает на этом шаге, чтобы ваш CTD указывал на api.pushwoosh.com.

Распространение DNS

Изменения DNS обычно вступают в силу в течение нескольких минут, но могут занять до 48 часов.

6. В Pushwoosh выберите Verify.

7. Когда верификация будет успешной, выберите Save.

8. Если вам нужно изменить Domain или DNS-запись, выберите Back и скорректируйте предыдущие шаги.

9. После нажатия Save ваш CTD появится в списке Custom tracking domain в Email channel configuration.

Чтобы отключить его позже, выберите ... рядом с вашим CTD, затем выберите Disable custom tracking domain.