Pavel Šabatka

GTM šablona pro Seznam Event Measurement (SEM)

O šabloně

Šablona řeší měření Seznam SEM.

Seznam SEM není kompatibilní s měřením Sklik před rokem 2026. Abyste mohli SEM využívat, musíte nejprve váš účet Sklik migrovat na SEM. Teprve poté v administraci můžete vygenerovat SEM ID.

Nastavení

Povinná data

  • Seznam ID – měřicí ID, které si můžete vygenerovat v administraci Sklik.
    Pokud nemáte Sklik účet migrovaný na SEM, pak tuto hodnotu nemůžete vygenerovat.
  • Event Name – typ události, např. PageView apod.
    V závislosti na typu události mohou být vyžadována různá data.
    SEM zatím neumožňuje odesílat vlastní události, to bude možné pravděpodobně v roce 2027.

Povinná data pro specifické události

Pole pro zadání hodnot se objeví, pokud zvolíte Event Name, pro kterou jsou relevantní.

  • User – objekt uživatele, který má atributy jako email, telefon apod. Přesná specifikace viz níže.
    Relevantní pro události PageView a UserDataUpdate.
  • Products – pole produktů související s danou událostí. Např. pro Purchase jsou to nakoupené produkty, Search jsou to produkty nalezené ve vyhledávání, AddToCart jsou to produkty přidané do košíku, ViewContent je to pole zobrazených produktů.
    Každý produkt může mít ID, jméno, kategorii, cenu a množství, a to v nějakém z formátů:
  • Order – objekt objednávky, a to ve formátu Google Ecommerce nebo Shoptet.
  • Currency Code – třímístný kód měny, např. CZK nebo EUR
  • Content Type – pouze pro událost typu „ViewContent“. Hodnoty mohou být
    • product – pro zobrazení detailu produktu
    • product_group – používá se na stránkách kategorií nebo produktových seznamů
    • page – pro měření obsahových stránek, např. článek na blogu

Volitelné parametry

  • Page URL – pokud potřebujete posílat „virtuální URL stránky“
  • Event ID – musíte posílat, pokud používáte měření v prohlížeči a zároveň server-to-server.
    Na základě Event ID dochází k deduplikaci událostí – počítá se vždy první příchozí událost.
    Pozn.: šablona automaticky generuje ID pro událost Purchase (pokud nezadáte nějaké vlastní). Díky tomu dochází k deduplikaci transakcí.
  • Content Name – jméno obsahu. Dává smysl např. pro ViewContent na článku na blogu
  • Page Category – kategorie stránky
  • Value – hodnota události

Vlastní parametry

Pokud potřebujete zadat vlastní hodnoty, budou můžete zadat ve formátu klíč – hodnota podle dokumentace SEM.

Předávaná data

User

Předává se s událostí PageView. Pokud se stav uživatele změní během načtení stránky, zavolejte po změně událost „User Data Update“.

Předpokládá objekt ve tvaru

{
  email: '[email protected]',
  phone: '+420777111222',
  first_name: 'Harry',
  last_name: 'Potter',
  gender: 'male',
  city: 'Bristol',
  street: 'BS13 9RN',
  postal_code: '12345',
  country: 'Velká Británie',
  registered: true,
  predicted_ltv: 9.75
}

Produkty

Předpokládá se vždy pole objektů ve tvaru Google Ecommerce nebo tvaru, který používá Shoptet.

[
  {
    item_id: "SKU_12345",
    item_name: "Stan and Friends Tee",
    discount: 2.22,
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    price: 10.01,
    quantity: 3
  }
]

Order

Předpokládá se vždy objednávka ve tvaru Google Ecommerce nebo tvaru, který používá Shoptet.

{
  transaction_id: "T_12345_1",
  value: 30.03,
  tax: 4.90,
  shipping: 5.99,
  currency: "USD",
  coupon: "SUMMER_SALE",
}

Režim souhlasu

Používáte-li consent mode v2, šablona si stav souhlasu přečte sama.

Pokud consent mode v2 nepoužíváte, je potřeba „odškrtnout“ pole „Using Consent Mode v2“ a předat stav souhlasu ručně.

Co pole Consent Statuses zadejte objekt ve tvaru

{
  ad_storage: 'granted',
  ad_personalization: 'granted',
  ad_user_data: 'granted',
  analytics_storage: 'granted',
  functionality_storage: 'granted'
}

Možné stavy souhlasu jsou granted, 1, true (povoleno) nebo denied, 0, false (zakázáno).

Doporučené nastavení pro konkrétní stránky

Podle typu stránek doporučujeme následující nastavení:

  • Kategorie produktů
    Posílat události PageView a ViewContent.
    V události ViewContent zvolte
    • Content Type = product_group
    • Products – produkty zobrazené na stránce (do GA4 je posíláte jako imprese)
  • Detail produktu
    Posílat události PageView a ViewContent.
    V události ViewContent zvolte
    • Content Type = product
    • Products – pole s jedním prvkem (zobrazený produkt)
  • Vyhledávání
    Posílat události PageView a Search.
    V události Search zvolte
    • Products – produkty zobrazené na stránce (do GA4 je posíláte jako imprese)
  • První krok checkoutu
    Posílat události PageView a InitiateCheckout.
    V události InitiateCheckout zvolte
    • Products – pole s produkty v košíku
  • Dokončení objednávky
    Posílat události PageView a Purchase.
    V události Purchase zvolte
    • Order – data o objednávce
    • Products – pole s produkty v košíku
  • Článek na blogu nebo obsahová stránka
    Posílat události PageView a ViewContent.
    V události ViewContent zvolte
    • Content Type = page
    • Zadejte Content Name

Povolení CSP

Používá-li Váš web hlavičky CSP (consent security policy), je třeba povolit:

  • script-src l.seznam.cz
    Pozn.: tuto direktivu lze vynechat pokud pro ověření GTM používáte nonce.
  • connect-src https://*.seznam.cz
    Pozn.: skript se připojuje na domény https://l.seznam.cz a https://sem.seznam.cz

Pozn.: pokud vůbec netušíte, co CSP jsou, zkuste nastavit měření a podívejte se, jestli měření jede nebo ne. Pokud ano, nemusíte toto řešit 😀

Pokud měření nejede, podívejte se, jestli je v konzoli prohlížeče není chyba ve smyslu „Refused because Consent Security Policy“. Pokud tam je, je třeba toto řešit.

Pokud stále vůbec netušíte, napište vašemu programátorovi nebo mě.