Как разметить письмо для карточки в почте

Оглавление

1. Что это и чем не является ›
2. Как включить в конструкторе ›
3. Mail.ru: шапка и смарт-карточки ›
4. Gmail: кнопка, заказ и промо ›
5. Поля подписчика ›
6. Почему карточки нет ›
7. Частые ошибки ›

Карточка во входящих — это не блок на холсте письма. Почта рисует её сама: шапка заказа в Mail.ru, кнопка перехода или промо во вкладке акций в Gmail. Чтобы почтовик понял, что показать, в HTML письма нужна служебная разметка.

В конструкторе Mailganer она включается в настройках письма: тогл «Карточка в почте», тип, поля, при необходимости сырой JSON. На холсте превью карточки нет — так и задумано.

Что это и чем не является

Это разметка письма для почтового ящика. Формат тот же, что у поисковой разметки сайта (JSON-LD), но кладётся он в HTML рассылки, а не на страницу магазина. Поисковик сайта по ней ничего не проиндексирует.

Не путайте с AMP-письмом: это другой канал и другая вёрстка. Как отправить AMP-письмо ›

Сейчас карточка собирается в конструкторе массовой рассылки. В триггерах того же экрана пока нет — в сценарии эту разметку вручную не копируйте в надежде, что «так же сработает». Настройки триггера — в отдельной статье ›.

Как включить в конструкторе

Откройте массовую рассылку на шаге вёрстки письма. Как устроен запуск — Как отправить рассылку ›. Карточка включается в настройках этого письма, а не блоком из палитры и не в старом редакторе со строками.

1. Откройте вкладку настроек письма.
2. Включите «Карточка в почте».
3. Выберите тип: Mail.ru или Gmail. Превью рядом показывает, как карточка выглядит у почтовика, не в письме.
4. Заполните поля формы. Ссылки — с https:// или через переменную.
5. Если нужно поправить JSON вручную — раскройте «Дополнительно». Неверный JSON подсветится.

Mail.ru: шапка и смарт-карточки

Три заготовки. В каждой уже стоят обязательные ключи спецификации Mail.ru — подставьте свои значения, а не собирайте JSON с нуля.

• Шапка заказа — статус, номер, товар, сумма. Статусы: обрабатывается, ожидает оплаты, в доставке, в пункте самовывоза, доставлен, проблема, возвращён, отменён.
• Счёт на оплату — магазин, номер счёта, срок оплаты, сумма. Срок оплаты в заготовке обязателен.
• Заказ / корзина — заказ без статуса шапки: брошенная корзина или подтверждение заказа.

Перед боевой отправкой прогоните JSON в валидаторе Mail.ru. Валидатор Mail.ru ›. Спецификация шапки — шапка заказа ›, смарт-карточки — разметка смарт-карточек ›.

Без идентификатора отправителя Mail.ru карточка не появится. В тестах на один адрес её часто нет. Это не ошибка конструктора: разметка в HTML есть, показа нет.

Gmail: кнопка, заказ и промо

Промо во вкладке акций — три вида, как принято у почтовика:

• акция и карточка скидки — лого, описание, промокод, даты, ссылка оффера и сайта магазина;
• карусель товаров — до 10 слайдов: картинка, ссылка, заголовок, цена, валюта, скидка;
• одна картинка — лого, одна карточка товара.

В том же списке типов, но уже про само письмо:

• кнопка перехода — подпись и ссылка;
• заказ — магазин, номер, статус, товар, сумма. Это не копия шаблона Mail.ru: набор полей другой.

Документация Google: вкладка акций ›, кнопка перехода ›, заказ ›, регистрация отправителя ›.

Без регистрации отправителя у Google карточка не появится. На телефоне её видно чаще. В ЕС и в тесте на один адрес обычно нет. Разметка в письме при этом на месте.

Поля подписчика

В поля карточки можно писать те же переменные, что и в тему или тело письма: двойные фигурные скобки. В заготовках уже стоят, например, {{order_id}}, {{order_total}}, {{payment_due}}. Подстановка при отправке — как у любой другой переменной. Как подставить переменную в письмо ›

Ссылки тоже можно собрать из переменной. Пустое поле ссылки у заказа Gmail просто не добавит кнопку перехода — это нормально, если URL ещё нет.

Перед запуском проверьте персонализацию на третьем шаге рассылки. Как протестировать письмо ›

Почему карточки нет

Самая частая жалоба: «в письме ничего не вижу». Карточки на холсте и не должно быть. Смотрите HTML письма: если тогл был включён, служебный блок разметки там есть.

Дальше решает почтовик, а не конструктор:

• отправитель не зарегистрирован у Mail.ru или Google;
• письмо ушло на один тестовый адрес;
• ящик в ЕС, промо Gmail там часто не рисуют;
• вы смотрите веб-Gmail на компьютере, а промо живёт во вкладке акций, чаще на телефоне;
• выбран тип не той почты: шапка Mail.ru не станет кнопкой Gmail.

Если разметки в HTML нет — тогл выключен, JSON в «Дополнительно» сломан, или письмо собрали не в этом конструкторе рассылки.

Частые ошибки

• Ждут карточку без регистрации у почтовика и считают это багом редактора.
• Путают с разметкой сайта для поиска или с AMP-письмом.
• Копируют шаблон Mail.ru в тип Gmail или наоборот.
• Ставят ссылку без https:// и без переменной — форма на это ругается.
• В карусели больше 10 слайдов: в письмо уйдёт только десять.
• Правят JSON в «Дополнительно» так, что он перестаёт разбираться, и сохраняют.