Přeskočit na obsah
API dokumentace

Google Tag Manager

Web, který měří přes Google Tag Manager, napojíte na Poštárnu jednou značkou místo úpravy kódu webu. Značka načte kód Poštárny (postarna.js) s adresou vašeho e-shopu; kód pak sám čte události GA4 ecommerce z dataLayer (zobrazení produktu, košík, pokladna, objednávka) pro opuštěný košík a tržby z e-mailů.

Šablona zatím není v galerii šablon GTM. Do té doby ji importujete ze souboru: stáhnout šablonu.

Import a nastavení

  1. V GTM otevřete Šablony › Šablony značek › Nová, v menu se třemi tečkami zvolte Importovat, vyberte stažený soubor a Uložte.
  2. Značky › Nová › Poštárna. Do pole Adresa kódu e-shopu vložte adresu z řádku, který Poštárna ukazuje v Nastavení › Napojení e-shopu (končí /postarna.js).
  3. Co tag dělá: Načíst kód. Spouštěč All Pages (Všechny stránky).
  4. Nechte zaškrtnuté Souhlas s cookies přebírat z Google Consent Mode: bez souhlasu ad_storage Poštárna nic neukládá ani neposílá.
  5. Volitelně E-mail známého návštěvníka: proměnná GTM s e-mailem přihlášeného zákazníka. Poštárna ho použije jen po souhlasu a nikdy nezaloží nový kontakt.
  6. Náhled: v Poštárně v Nastavení › Napojení e-shopu se objeví „Napojeno, data chodí“. Pak kontejner Publikujte.

Webtracking musí být u e-shopu zapnutý (Nastavení › Datové zdroje › Webtracking), jinak kód události neposílá.

Režim Předat událost

Když web posílá e-commerce data jinam než do window.dataLayer nebo s jinými názvy událostí, přidejte druhou značku Poštárna v režimu Předat událost se spouštěčem Vlastní událost (například purchase) a v poli Událost zvolte odpovídající událost GA4. Značka předá objekt ecommerce posledního zápisu do dataLayer. Zaškrtnuté Nečíst dataLayer automaticky vypne čtení dataLayer kódem, takže události posílají jen značky. Stejná událost z dataLayer i ze značky se do 3 sekund započítá jednou.

Oprávnění

OprávněníRozsah
Injects scriptshttps://*.postarna.cz/t/*, https://*.postarna.sk/t/*, https://postarna.cz/t/*, https://postarna.sk/t/*
Accesses global variablespostarna, postarna.q
Reads data layerevent, ecommerce
Accesses consent statead_storage (jen čtení)
Logs to consolejen v režimu ladění

Má-li e-shop vlastní odkazovou doménu (například links.vas-eshop.cz), přidejte po importu v šabloně na záložce Oprávnění › Injects scripts adresu https://links.vas-eshop.cz/t/*.

Co se posílá

Jen události e-commerce (produkty, množství, ceny, měna, číslo objednávky) a e-mail známého návštěvníka, a to jen na adresu kódu vašeho e-shopu v Poštárně. Adresa stránky se posílá bez parametrů. Objednávky a události ze serveru: Objednávky a události přes API a webhook.