Seznam SEM pro server-side GTM: Novinky verze 3.0 a nejčastější chyby v nastavení

Naše serverová šablona Seznam SEM pro Google Tag Manager má novou verzi 3.0, vydanou 29. 10. 2026. Opravuje data, která šablona posílala do Seznamu a zjednodušuje nastavení tagu. Shrnujeme, co se změnilo, a chyby v nastavení, na které Seznam v datech inzerentů upozorňuje nejčastěji.

Šablona posílá konverze a další události ze server-side GTM přímo do Seznam SEM API (S2S měření pro Sklik). Frontendový skript sul.js nenahrazuje, doplňuje ho.

Co přináší verze 3.0 ?

Přesnější data

Šablona nejdřív složí všechny vstupy, výsledek jednou vyčistí a zkontroluje přesně ten payload, který odešle Seznamu.

  • Množství: položka s quantity 0, záporným nebo desetinným se neodešle, chybějící množství je 1.

  • null a undefined: prázdné hodnoty a texty 'undefined' / 'null' z rozbitých proměnných se neodešlou a nepřepíšou platnou hodnotu.

  • Purchase: bez order_id, currency nebo value se neodešle, tag skončí jako Failed a chybu zapíše do logu. value se už nedopočítává z cen položek, protože ty jsou s DPH a value bez DPH.

  • Souhlas: 1, '1' a 'true' se převedou na granted, 0, '0' a 'false' na denied. Chybně nastavený consent tag zastaví.

  • Chybný JSON v proměnné už tag neshodí bez jediného řádku v logu.

Jednodušší nastavení

Nový tag má 21 polí a 4 pole pro BigQuery logging. Data události a uživatele zadáte v tabulce Klíč – Hodnota, kde klíč vybíráte ze seznamu, nebo jako objekt z GTM proměnné. Pole z předchozích verzí zůstávají ve sbalené skupině Starší pole (v2.x) a fungují dál; jeden řádek v logu vypíše, která z nich tag používá.

Co po aktualizaci zkontrolovat

Některé tagy, které dřív tiše posílaly chybná data, teď v sGTM Preview skončí chybou nebo warningem, který říká, co opravit. Dále se mění:

  • Názvy událostí z GA4 se mapují 1:1 na 13 událostí. login, add_shipping_info, view_item_list, select_item a view_promotion tag zastaví.

  • event_id se už nedoplňuje z transaction_id. Pro deduplikaci s frontendem ho nastavte sami.

  • Cookie sznaiid drží poslední proklik 30 dní, dřív první proklik 90 dní.

  • Validace je vždy přísná a Report success before Seznam answers je u nových tagů vypnuté.

  • V produkci se ve výchozím nastavení nelogují warningy, jen chyby.

  • Starší tagy, kterým GTM kvůli volbě Event Data input mode v předchozí verzi nepředával jednotlivá pole, je teď znovu posílají. U takových tagů mohl dosud selhávat Purchase.

Všech 15 bodů s postupem kontroly je v CHANGELOGu.

Nejčastější chyby v nastavení

Tyto chyby vznikají na webu nebo v nastavení kontejneru a šablona je sama neopraví.

Chyba

Co se stane

Jak opravit

sul.js chybí nebo se načítá až po GA4

Hity odejdou bez sid a udid, Seznam hůř páruje uživatele

Načíst sul.js na každé stránce před GA4 tagem

CMP bez IAB TCF nepředá souhlas sul.js

sul.js nevytvoří cookies sid a udid

Volat SEM('updateConsent', …) při načtení stránky a po každé změně souhlasu

SGTM běží na jiné doméně než web (například výchozí adresa Cloud Run)

Cookies sid a udid do SGTM nedorazí

Provozovat SGTM na subdoméně webu, například sgtm.eshop.cz

Consent Mode Object není v SEM tagu namapovaný

Hit odejde bez informace o souhlasu

Přenést stav souhlasu do SGTM a namapovat ho v každém SEM tagu, i s GA4 prefill

Vyplněný TCF consent string, ač CMP nemá Seznam ve vendor listu

Seznam vyhodnotí souhlas podle TCF stringu, ne podle consent_mode

Pole Consent String nechat prázdné

Frontendové SEM ID místo S2S SEM ID

Odpověď 401/403, kterou dokumentace Seznamu uvádí u chybného SEM ID

Použít S2S SEM ID z pokročilého nastavení účtu ve Skliku

transaction_id není přímo na události purchase, value je s DPH

Purchase se neodešle, nebo s chybnou hodnotou

Poslat transaction_id, currency a value bez DPH v CZK přímo s purchase

Spoléhání na page_view znovu odeslaný po kliknutí na „Přijmout“

V našem testu se na něm SEM tag nespustil, Seznam měl ze vstupní stránky jen hit před souhlasem

Po souhlasu poslat samostatnou událost (například sem_consent_ready) a na ni spustit SEM tag s PageView

Nezahashovaný e-mail a telefon

Šablona hodnoty nehashuje a odešle je, jak přišly

Hashovat SHA-256 na frontendu před odesláním do SGTM

Jak aktualizovat

Šablona zatím není v galerii šablon GTM, novou verzi proto naimportujete ze souboru template.tpl v repozitáři. Existující šablonu otevřete v kontejneru v sekci Templates a v menu ⋮ zvolte Import; tagy zůstanou na šablonu navázané. Doporučený postup:

  1. Naimportujte verzi 3.0 a v sGTM Preview opravte všechny řádky [ERROR] a [WARN].

  2. Na dobu testu vypněte Report success before Seznam answers, aby stav tagu odpovídal odpovědi Seznamu.

  3. Projděte body CHANGELOGu, které se týkají vašeho nastavení.

  4. Starší pole, která vypíše řádek v2.x settings in use, přesuňte do nových tabulek.

  5. Kontejner publikujte až po kontrole v Preview.

Více informací

Podrobný návod v češtině, popis všech polí a dotaz do BigQuery na kontrolu kvality dat najdete v repozitáři optimics/SEM na GitHubu. Změny po verzích jsou v CHANGELOG.md, chyby z tabulky výše i s ověřením v Preview v README v sekci Nejčastější problémy v datech.

S nastavením nebo kontrolou dat vám rádi pomůžeme, ozvěte se nám.