EdeeShop · Implementace

Strukturovaná data v transakčních e-mailech objednávek

Upraveno

V transakčních e-mailech k objednávkám jsou implementována strukturovaná data ve formátu application/ld+json. Data jsou generována pomocí makra printOrderJsonLd, které vkládá JSON-LD blok na konec těla HTML e-mailu.

Cíl

Cílem je zlepšit čitelnost a interpretaci e-mailových zpráv v e-mailových klientech (např. Gmail, Seznam.cz), které strukturovaná data podporují. To umožňuje např. zobrazení přehledné informační karty s detaily objednávky přímo v inboxu uživatele.

Podpora a kompatibilita

Gmail

Gmail strukturovaná data podporuje a zobrazování objednávek lze aktivovat po úspěšném schvalovacím procesu.

Příklad seznam.cz

Aktivace

Pro aktivaci je třeba:

  1. Odeslat testovací e-maily z projektu na adresu schema.whitelisting+sample@gmail.com.
  2. Vyplnit registrační formulář dle dokumentace:
    https://developers.google.com/workspace/gmail/markup/registering-with-google

⚠️ Známý problém: V Gmailu se aktuálně vždy zobrazuje stav „Objednávka byla přijata“, i v případech, kdy je stav jiný (např. storno, doručeno, k vyzvednutí). Hodnota orderStatus je v datech nastavena správně, ale Gmail ji zřejmě nesprávně interpretuje. Tento problém je na straně Gmailu.

Seznam.cz

E-mailový klient Seznam.cz zatím (stav k 06/2025) strukturovaná data oficiálně nepodporuje. Ve spolupráci se Seznamem ale proběhlo předběžné testování a aktuální implementace je kompatibilní.

Není zatím známo, zda Seznam začne data zobrazovat automaticky, nebo bude třeba projít schvalovacím procesem.

Příklad seznam.cz

Ostatní klienti

Klienti, kteří strukturovaná data nepodporují (např. Outlook, Thunderbird), JSON-LD blok ignorují. Zobrazení e-mailu tím není nijak ovlivněno.

Shrnutí

  • Strukturovaná data byla přidána do e-mailů pomocí makra printOrderJsonLd.
  • Gmail podporuje zobrazování těchto dat po registraci.
  • Seznam.cz testováním úspěšně prošel, oficiální podpora zatím není spuštěna.
  • Ostatní klienti data ignorují bez negativního dopadu na zobrazení.