# analytics

Ładuje GA4 albo Google Tag Manager, spięte z modułem consent: Consent Mode
dostaje decyzję odwiedzającego, zanim tag się załaduje, i aktualizację w
momencie kliknięcia w banerze.

## Config

Brak opcji w `payload.config` — plugin czyta ID z globala **Site Integrations**
(Settings → Site Integrations):

- **GA4 Measurement ID** — `G-XXXXXXXXXX`
- **GTM Container ID** — `GTM-XXXXXXX`

Gdy ustawione są oba, wygrywa GTM. Gdy żadne — komponent nie robi nic.

To jedyne pola z Site Integrations, które trafiają na klienta — są publiczne
(widać je w źródle każdej strony z GA). `getAnalyticsConfig` czyta wyłącznie je,
więc sekrety (Turnstile, SMTP) nie mają jak wyciec.

## Front

W layoucie locale, **wewnątrz `ConsentProvider`**:

```tsx
import { getAnalyticsConfig } from '@intecion/ipal-kit'
import { ConsentProvider, CookieBanner, Analytics } from '@intecion/ipal-kit/client'

export default async function LocaleLayout({ children, params }) {
  const payload = await getPayload({ config })
  const analytics = await getAnalyticsConfig(payload)   // server

  return (
    <ConsentProvider texts={texts}>
      {children}
      <CookieBanner />
      <Analytics {...analytics} />
    </ConsentProvider>
  )
}
```

`Analytics` nie renderuje nic — wstrzykuje skrypty. Zamontuj raz, wysoko w
drzewie.

## Jak działa Consent Mode

1. Przed załadowaniem tagu: `gtag('consent', 'default', …)` z zapisaną decyzją
   odwiedzającego (albo wszystko `denied`, gdy jeszcze nie zdecydował).
2. Tag się ładuje i respektuje ten stan od pierwszego trafienia.
3. Klik w banerze → `gtag('consent', 'update', …)` → tagi reagują natychmiast.

Mapowanie kategorii na sygnały Google:

| Kategoria | Sygnały |
|---|---|
| analytics | `analytics_storage` |
| marketing | `ad_storage`, `ad_user_data`, `ad_personalization` |
| functional | `functionality_storage`, `personalization_storage` |
| necessary | `security_storage` (zawsze `granted`) |

## Testowanie

W konsoli: `window.dataLayer` — powinien zawierać `Arguments(3)` z `consent` /
`default`, a po decyzji `consent` / `update`. Jeśli widzisz `Array` zamiast
`Arguments`, komenda nie zostanie rozpoznana przez Google.

Ciasteczko `_ga` pojawia się dopiero po zgodzie na analytics — to jest sedno
Consent Mode.

**GTM sam nie ustawia ciasteczek** — to pojemnik. Bez opublikowanego (Submit →
Publish, nie sam zapis) tagu GA4 w kontenerze wszystko wygląda dobrze:
`gtm.load` w dataLayer, Tag Assistant widzi kontener — a `_ga` nie ma, bo nic go
nie tworzy. Przy debugowaniu warto tymczasowo wyczyścić GTM Container ID i
zostawić samo GA4, żeby wyeliminować kontener jako zmienną.