Sema Track for Joomla

Joomla System Plugin pro server-side měření webu bez e-shopu (bez VirtueMart). Odlehčená varianta Sema Track for VirtueMart. Konverze = návštěva děkovací stránky po odeslání formuláře nebo AJAX detekce formulářů.

Podporované platformy: GA4, Google Ads, Sklik.cz.

2. Instalace

Získání balíčku

Stáhněte soubor plg_system_semakin_sst_web-1.0.6.zip ze SemaHub (Semakin.cz).

Postup instalace

1. Přihlaste se do administrace Joomla.
2. Přejděte do System > Install > Extensions.
3. Nahrajte ZIP soubor plg_system_semakin_sst_web-1.0.6.zip.
4. Po instalaci plugin vytvoří dvě databázové tabulky: #__semakin_sst_web_log a #__semakin_sst_web_queue.

Upgrade: Stejný postup jako instalace. Joomla použije method="upgrade". Data v tabulkách zůstanou zachována.

4. Základní nastavení

Otevřete nastavení: System > Plugins > klik na název pluginu.

Záložka: Základní nastavení

6. Detekce konverzí

Plugin detekuje konverze (odeslání formuláře) jedním ze tří režimů, nastavitelných přes pole Režim detekce konverzí.

Režim: URL match (výchozí)

Plugin porovná aktuální URL stránky (REQUEST_URI) s nastavenou URL konverze (např. /dekujeme, /thank-you). Když návštěvník přistane na děkovací stránce po odeslání formuláře, spustí se event generate_lead.

Režim: AJAX formulář

Pro formuláře odesílané přes AJAX (bez přesměrování stránky), jako SP Page Builder, RSForm nebo vlastní JavaScript formuláře. Plugin injektuje JavaScript, který zachytává AJAX odpovědi. Když je detekováno úspěšné odeslání formuláře, nastaví se cookie semakin_sst_web_ajax_cv=1. Na další stránce plugin přečte tuto cookie a spustí event generate_lead.

JS intercept pokrývá tři AJAX metody:

1. jQuery $(document).ajaxComplete() – většina Joomla komponent
2. XMLHttpRequest monkey-patch – non-jQuery AJAX
3. Fetch API monkey-patch – moderní implementace

Režim: Obojí

Kombinace URL match a AJAX detekce. Deduplikace je sdílená – pouze jedna konverze per session bez ohledu na režim.

Deduplikace

Všechny režimy sdílejí deduplikační flag na úrovni session (semakin_sst_web.lead_tracked). Pouze jeden generate_lead event se odešle per session.

8. Google Analytics 4

Záložka: GA4

Sledované eventy

Fallback client_id

Bez gtag.js neexistuje cookie _ga. Plugin automaticky vytvoří náhradní cookie semakin_sst_cid s GA4 kompatibilním formátem (expirace 2 roky).

10. Sklik.cz

Záložka: Sklik

Jak to funguje

Sklik nemá server-side API. Plugin injektuje JavaScript snippety (rc.js) před </body>:

• Retargeting (rc.retargetingHit) na každé stránce (L0+)
• Konverze (rc.conversionHit) při generate_lead (L0+)
• Parametr consent: Dynamicky – consent:0 bez marketingového souhlasu, consent:1 se souhlasem
• EID: Pouze při L2

Skript rc.js se načítá jako synchronní <script> tag (vyžadováno Sklikem).

CSP: Pokud web používá Content-Security-Policy, přidejte https://c.seznam.cz do script-src, connect-src a img-src. Přidejte https://h.seznam.cz do connect-src. Viz CSP poznámka v nastavení pluginu.

12. Logování a diagnostika

Záložka: Logování

Kontrola DB logu

SELECT event_name, platform, consent_level, status, http_status, created_at
FROM #__semakin_sst_web_log
ORDER BY id DESC
LIMIT 20;

Nahraďte #__ vaším prefixem tabulek.

14. Řešení problémů

Žádné eventy v databázi

1. Ověřte, že plugin je povolený (Status = Enabled).
2. Zkontrolujte, že services/provider.php existuje v adresáři pluginu na serveru.
3. Ověřte, že bridge cookie semakin_sst_cl je nastavena (DevTools > Application > Cookies).
4. Pokud cookie chybí, zkontrolujte konfiguraci GDPR komponenty a že bridge JS není stripován.

consent_level je vždy 0

• Bridge cookie semakin_sst_cl chybí nebo je blokována.
• Zkontrolujte, že semakin_sst_cl je zařazena jako Nezbytná v consent komponentě (ne Analytická/Marketingová).
• Na první stránce po instalaci je consent vždy L0 (bridge cookie potřebuje jeden page load pro inicializaci).

generate_lead se nespouští (URL match)

1. Ověřte, že URL konverze odpovídá skutečné cestě děkovací stránky (např. /dekujeme).
2. Cesta se porovnává s REQUEST_URI – zkontrolujte přesnou shodu (case-sensitive).
3. Ověřte, že návštěvník již nespustil konverzi v aktuální session (deduplikace).

generate_lead se nespouští (AJAX)

1. Zkontrolujte DevTools > Cookies na semakin_sst_web_ajax_cv=1 po odeslání formuláře.
2. Pokud cookie chybí, JS intercept nedetekoval úspěšnou AJAX odpověď. Zkontrolujte konzoli prohlížeče na chyby.
3. Pokud je cookie přítomna, ale žádný event se neobjeví v DB logu, přejděte na další stránku – event se spustí na dalším page load.
4. Pokud používáte CSS selektor formuláře, ověřte, že selektor odpovídá vašemu formuláři.

Google Ads konverze se nezobrazují v dashboardu

1. Ověřte, že konverzní akce je typu „Import z kliknutí“ (ne Webové stránky).
2. Zkontrolujte, že GCLID/GBRAID je přítomen v payloadu v DB logu.
3. Ověřte, že OAuth consent screen je v režimu Production (ne Testing).
4. Zkontrolujte, že Enhanced Conversions for Leads je zapnuto v nastavení Google Ads.
5. Pokud je aktivní i webová konverzní akce, deaktivujte ji nebo přepněte na sekundární.

Sklik kód se nespouští

• Ověřte, že rc.js je načteno jako synchronní <script> tag (zkontrolujte zdrojový kód stránky).
• Pokud web používá CSP, přidejte požadované domény (viz CSP poznámka v záložce Sklik).
• Zkontrolujte konzoli prohlížeče na chyby.

PII hashe chybí v konverzích

• Ověřte, že formulář obsahuje pole input[type="email"] nebo input[type="tel"].
• Zkontrolujte DevTools > Cookies na semakin_sst_form_pii po odeslání formuláře.
• Cookie má 30minutovou expiraci – pokud se konverze spustí později, hashe už mohou být pryč.

Cookies používané pluginem

semakin_sst_cl musí být v kategorii Nezbytné cookies. Ostatní cookies patří do kategorie Analytické nebo Marketingové.

Plugin sám hlídá, aby žádná z těchto cookies nevznikla bez odpovídajícího souhlasu. Při odmítnutém souhlasu (L0) neuloží plugin do zařízení návštěvníka nic kromě consent bridge.

Identifikátory kliknutí z reklamy (gclid, gbraid) se při příchodu bez marketingového souhlasu uloží pouze do Joomla session. Jakmile návštěvník souhlas udělí, plugin je automaticky povýší na 90denní cookie — atribuce se tedy neztratí ani když návštěvník souhlasí až o několik stránek později.