Addon CSCZ Google Tag Manager rozšiřuje datový layer (dataLayer) Google Tag Manageru o detailní e-commerce tracking. Automaticky sleduje uživatelské akce a posílá strukturovaná data o produktech, nákupech, přihlášení a dalších důležitých událostech do Google Analytics 4.

Klíčové Vlastnosti

✅ Automatický tracking - sleduje uživatelské akce bez nutnosti ručního kódování
✅ GA4 kompatibilní - plně kompatibilní s Google Analytics 4 enhanced ecommerce
✅ Konfigurovatelné eventy - zapnutí/vypnutí jednotlivých eventů v administraci
✅ Správa cen se slevami - inteligentní handling cen včetně aplikovaných slev
✅ Cache optimalizace - interní cache pro značky produktů a kategorie
✅ Debug režim - console logs pro snadné ladění

Základní Informace

Vlastnost	Hodnota
Verze	1.0
Kompatibilita	CS-Cart Ultimate (ROOT, VENDOR)
PHP	7.4+, 8.0, 8.1
Jazyk	Česky (default)
Priorita	1000
Autor	www.cs-cart.cz

Funkcionality

Addon poskytuje komplexní sledování následujících oblastí:

🛒 Nákupní Proces

Přidání produktu do košíku (add_to_cart)
Odebrání produktu z košíku (remove_from_cart)
Vyprázdnění košíku (clear_cart)
Dokončení objednávky (purchase)

📦 Produkty

Zobrazení detailu produktu (view_item)
Zobrazení seznamu produktů v kategoriích (view_item_list)
Zobrazení produktů v blocích (sidebar, homepage)

🎯 Marketing

Zobrazení propagačních bannerů (view_promotion)
Kliknutí na banner (select_promotion)
Sledování katalogových propagací

👤 Uživatelé

Přihlášení uživatele (login)
Registrace nového uživatele (sign_up)

Konfigurace

Základní Nastavení

Přejděte na Doplňky → Moje doplňky → CSCZ Google Tag Manager

🔧 Obecná Nastavení

Nastavení	Typ	Popis	Výchozí
Container ID	Text	ID kontejneru GTM (např. `GTM-XXXXXX`)	-
Site language	Text	Kód jazyka pro tracking	`cs`
Brand feature	Selectbox	Vlastnost CS-Cartu používaná jako "brand"	-
Default brand	Text	Fallback hodnota pro značku	`Shopex`
Debug mode	Checkbox	Zapne console logs v browseru	`N`

📊 Tracking Nastavení

Propagace

✅ Enable "View Promotion" - sledování zobrazení bannerů
✅ Enable "Select Promotion" - sledování kliknutí na bannery
✅ Include creative fields - přidá creative_name a slot
⬜ Include location_id - přidá location_id (pozice banneru)
Location id strategy:
- None - bez určování pozice
- Controller + mode - podle kontroleru a módu stránky (výchozí)
- URL path - podle URL cesty

Nákupní Proces

✅ Enable "Add to Cart" event
✅ Enable "Remove from Cart" event
✅ Enable "Clear Cart" event

Produkty

✅ Enable "View Item" - detail produktu
✅ Enable "View Item List" in categories
✅ Enable "View Item List" in blocks

Uživatel

✅ Enable "Login" event
✅ Enable "Sign Up" event

Objednávka

✅ Enable "Purchase" event

⚡ Rychlá Konfigurace

1. Container ID: GTM-XXXXXX (povinné)
2. Brand feature: Vyberte vlastnost "Výrobce" nebo "Brand"
3. Debug mode: Zapněte pro testování
4. Povolte požadované eventy (výchozí: všechny zapnuté)

Podporované Eventy

Přehled Eventů

Event	Popis	Kdy se spustí	Konfigurovatelné
`view_promotion`	Zobrazení banneru/promo	Při načtení stránky s bannery	✅
`select_promotion`	Klik na banner	Při kliknutí na banner	✅
`add_to_cart`	Přidání do košíku	Po přidání produktu do košíku	✅
`remove_from_cart`	Odebrání z košíku	Po odebrání produktu z košíku	✅
`clear_cart`	Vyprázdnění košíku	Po vyprázdnění košíku	✅
`view_item`	Detail produktu	Při zobrazení detailu produktu	✅
`view_item_list`	Seznam produktů	V kategoriích a blocích	✅
`login`	Přihlášení	Po úspěšném přihlášení	✅
`sign_up`	Registrace	Po dokončení registrace	✅
`purchase`	Objednávka	Po dokončení checkout procesu	✅

Datová Struktura

Formát Položky Produktu (Item)

Každý produkt poslaný do GTM obsahuje:

{
  "item_id": "123",              // ID produktu (string)
  "item_name": "Název produktu", // Název produktu
  "price": 299.99,               // Cena v hlavní měně (float)
  "quantity": 1,                 // Počet kusů (int)
  "item_brand": "Výrobce",       // Značka produktu
  "item_category": "Elektronika",// Hlavní kategorie
  "item_category2": "Telefony",  // Podkategorie (až 5 úrovní)
  "item_category3": "...",
  "item_category4": "...",
  "item_category5": "..."
}

Formát Eventu

{
  "event": "add_to_cart",        // Název GA4 eventu
  "ecommerce": {
    "currency": "CZK",           // Měna (z CART_SECONDARY_CURRENCY)
    "value": 299.99,             // Celková hodnota transakce
    "items": [...]               // Pole produktů (items)
  }
}

Příklad: Add to Cart Event

window.dataLayer.push({
  event: 'add_to_cart',
  ecommerce: {
    currency: 'CZK',
    value: 599.99,
    items: [{
      item_id: '456',
      item_name: 'Mobilní telefon XYZ',
      price: 599.99,
      quantity: 1,
      item_brand: 'Samsung',
      item_category: 'Elektronika',
      item_category2: 'Telefony',
      item_category3: 'Smartphones'
    }]
  }
});

❌ Časté Problémy

Problem: Značka produktu není vidět (zobrazuje se default)

Příčina: Vlastnost (feature) není nastavena v konfiguraci
Řešení:

Přejděte na Produkty → Vlastnosti
Vytvořte/vyberte vlastnost pro značku (např. "Výrobce", "Brand")
V nastavení addonu vyberte tuto vlastnost v Brand feature
Přiřaďte vlastnost produktům

Problem: Eventy se nespouštějí

Příčina: Event není povolený v nastavení
Řešení:

Přejděte na Doplňky → CSCZ Google Tag Manager
Zkontrolujte, že příslušný event je zaškrtnutý (např. "Enable Add to Cart event")

Problem: GTM kontejner se nenačítá

Příčina: Chybí nebo je nesprávný Container ID
Řešení:

Ověřte Container ID v Google Tag Manager (např. GTM-XXXXXX)
Vložte správný ID do nastavení addonu (Container ID)
Ověřte, že GTM snippet je vložený v šabloně

Problem: Debug zprávy nejsou vidět v konzoli

Příčina: Debug režim není zapnutý
Řešení: Zapněte Debug mode (console logs) v nastavení modulu

Licence a Podpora

Vývojář: www.cs-cart.cz
Licence: Proprietary
Verze: 1.0
Podpora: Kontaktujte autora na www.cs-cart.cz

Google Tag Manager