Sema Track for VirtueMart

Joomla System Plugin pro kompletní server-side měření pro e-shopy na Joomla 4/5 + VirtueMart 4.x. Nahrazuje client-side JS snippety a odesílá data přímo ze serveru do měřicích platforem přes jejich API.

Podporované platformy: GA4, Google Ads, Sklik.cz, Zboží.cz, Heureka Ověřeno zákazníky, Heureka OCM, Google Customer Reviews.

2. Instalace

Získání balíčku

Stáhněte soubor plg_system_semakin_sst-1.0.4.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-1.0.4.zip.
4. Po instalaci plugin vytvoří dvě databázové tabulky: #__semakin_sst_log a #__semakin_sst_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. 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).

8. 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 nákupu (L0+)
• Parametr consent: Dynamicky – consent:0 bez marketingového souhlasu, consent:1 se souhlasem
• EID a Zboží.cz parametry: Pouze při L2

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.

10. Heureka – Ověřeno zákazníky

Záložka: Heureka (první sekce)

Opt-out checkbox

Checkbox používá opt-out model: nezaškrtnutý = zákazník souhlasí; zaškrtnutý = zákazník se odhlašuje. Cookie semakin_sst_heureka_optout=1 (expirace 2 hodiny).

GDPR: E-mail zákazníka se odesílá v plaintextu do Heureky. Do logu pluginu se nikdy neukládá.

12. Google Customer Reviews

Záložka: Google Customer Reviews

GCR vyžaduje pouze L1 (Analytics) souhlas – nejde o reklamu. E-mail zákazníka se vloží do widgetu jen při L2.

14. Logování a diagnostika

Záložka: Logování a fronta

Kontrola DB logu

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

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

• consent_level by měl být 2 pro purchase eventy (pokud má zákazník marketingový souhlas).
• status by měl být sent pro úspěšné odeslání.

16. Ř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).

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.

Zboží.cz chyba ORPHANED_BACKEND

• Obě složky (backend API i frontend JS rc.conversionHit s zboziId) jsou nutné.
• Ověřte, že Sklik je povolen (Sklik rc.js obsluhuje frontend jak pro Sklik, tak pro Zboží.cz).

Heureka HTTP 400 „Missing expected key e-mail“

• Ověřte, že „Odesílat e-mail zákazníka“ je zapnuto v nastavení Heureky.
• E-mail vyžaduje L2 souhlas.

Purchase eventy se nedetekují (OPC)

• One Page Checkout pluginy obcházejí VirtueMart hooky. Plugin používá DB polling (detectUnloggedPurchases) jako fallback.
• Ověřte, že DB logování je zapnuto (nutné pro deduplikaci).
• Zkontrolujte, že requesty nepřicházejí od botů (prázdné cookies = přeskočeno).

Kontrolní seznam pro spuštění

• Plugin nainstalován a povolen
• GDPR komponenta vybrána a nastavena
• Bridge cookie semakin_sst_cl zařazena jako Nezbytná
• GA4: Measurement ID a API Secret nastavené
• Google Ads: Konverzní akce vytvořena jako „Import z kliknutí“
• Google Ads: OAuth credentials v textarea polích, consent screen v režimu Production
• Google Ads: Enhanced Conversions for Leads zapnuté
• Sklik: ID konverze a ID retargetingu nastavené
• Zboží.cz: Shop ID a PRIVATE_KEY nastavené
• Heureka: API klíč nastaven, opt-out checkbox povolen
• Heureka OCM: OCM API klíč nastaven (odlišný od klíče Ověřeno)
• GCR: Merchant Center ID nastaveno
• CSP hlavičky aktualizované (pokud je to relevantní)
• DB logování zapnuto
• Testovací režim VYPNUT
• Inline zpracování fronty nastaveno (nebo Task Scheduler nakonfigurován)
• Testovací nákup proveden a ověřen v DB logu a dashboardech platforem

Jak to vypadá v administraci