Картки підсумків Gmail та email-розмітка

Gmail іноді показує короткий підсумок вмісту листа — картку підсумків — над вмістом повідомлення або в списку вхідних. Типові приклади — картки замовлень і відстеження доставки, картки авіа- та готельних бронювань, а також картки з пропозиціями Deal cards.

Такі картки формуються за допомогою двох різних механізмів. Важливо розрізняти їх, оскільки відправник може керувати лише одним із них.

Два різні механізми

1. Розмітка, яку додає відправник

Ви можете самостійно додати до листа структуровані дані, щоб Gmail розпізнав їх і показав картку або кнопку дії, наприклад Track package чи View reservation.

Розмітку створюють за словником Schema.org у форматі JSON-LD. Підтримувані типи Google описує в документації Gmail Markup / Actions in Gmail.

Як і AMP, це механізм, який налаштовує відправник. Ви самостійно додаєте код до листа, а для використання інтерактивних кнопок Go-to action маєте також зареєструвати домен відправника в Google.

Інформаційна розмітка, яка створює картку без кнопки, не потребує реєстрації. Однак вимоги та поведінка Gmail можуть змінюватися, тому перед використанням певного типу розмітки перевіряйте актуальну документацію Google.

Розмітка Gmail підтримує не лише замовлення та бронювання, а й промоконтент. Для акцій і знижок не потрібно додавати JSON-LD вручну: в eSputnik є вбудований інструмент анотацій для вкладки Промоакції, який налаштовується безпосередньо в редакторі листів.

Ручне додавання JSON-LD, описане нижче, потрібне лише для типів Schema.org, які не підтримує редактор, наприклад для замовлень, доставок і бронювань.

2. Автоматичні анотації Gmail

Gmail також може самостійно створити картку підсумків, проаналізувавши вміст листа. Для цього відправнику не потрібно додавати структуровані дані.

Саме тому картка Deal card може з’явитися в листі, до якого ви не додавали розмітку.

Додавання розмітки до листа в eSputnik

Окремий інтерфейс без коду в eSputnik передбачено лише для анотацій промовкладки Gmail. Для інших типів Schema.org розмітку потрібно додати як HTML-код — так само, як будь-який інший кастомний блок.

1. Перейдіть до розділу Повідомлення → Повідомлення → Email і відкрийте наявний лист або створіть новий.
2. У редакторі коду додайте блок <script type="application/ld+json"> із потрібною розміткою.

Вміст такого блоку не відображається в листі як звичайний текст. Gmail зчитує його на сервері під час оброблення повідомлення.

Приклад розмітки для підтвердження замовлення:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Order",
  "merchant": "Your Store",
  "orderNumber": "1234567",
  "priceCurrency": "USD",
  "price": "49.99",
  "acceptedOffer": {
    "@type": "Offer",
    "itemOffered": {
      "@type": "Product",
      "name": "Your Product Name"
    }
  },
  "url": "https://example.com/orders/1234567"
}
</script>

Дані в розмітці можна персоналізувати за допомогою Velocity — так само, як в інших частинах шаблону. Наприклад, ви можете підставити номер замовлення або ціну з параметрів події.

Тестування та реєстрація

1. Перевірте синтаксис JSON-LD у валідаторі Schema.org, наприклад у Schema Markup Validator, перш ніж надсилати лист. Некоректний блок Gmail не розпізнає, однак у самому листі повідомлення про помилку не з’явиться.
2. Надішліть тестовий лист на власну адресу Gmail і перевірте, чи відображається картка. Оскільки eSputnik передає розмітку без змін, такий тест допоможе перевірити, як Gmail обробляє лист із вашого домену.

3. Для розмітки з клікабельною дією, а не лише інформаційною карткою, зареєструйте відправника в Google. Заявку потрібно подати самостійно: eSputnik не подає її та не супроводжує процес реєстрації від вашого імені.

   Процес подібний до реєстрації відправника AMP: надішліть із робочого домену реальний лист із розміткою на адресу Google для перевірки, заповніть реєстраційну форму та дочекайтеся схвалення.

4. Актуальний перелік підтримуваних типів, вимоги та рекомендації щодо тестування дивіться в документації Google щодо Gmail Markup. Google може змінювати ці умови незалежно від eSputnik.

Читайте також

• Оформлення промовкладки для Gmail
• AMP
• Email-доставлення: початкове налаштування
• Velocity у повідомленнях