# Analitikai hookok: Google Analytics, süti-hozzájárulás, Matomo, Clarity

> A Google Analytics 4 követőkód, az e-kereskedelmi események, a süti-hozzájárulás, a Matomo és a Microsoft Clarity kimenetét módosító szűrők.

Ez a fejezet az analitikai modulok kimenetét módosító szűrőket (filter) gyűjti össze. A beállítófelületről az [Analitika](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-google-analytics/), a [süti-hozzájárulásról](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-sutisav-hozzajarulas/), a [Matomóról](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-matomo/) és a [Clarityről](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-clarity/) szóló fejezetek szólnak; a hookok általános használatáról a [Composer és hookok használata](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/fejlesztoknek-composer-es-hookok/) fejezet. A szűrőket a sablon `functions.php` fájljába vagy egy saját bővítménybe tedd.

| Hook | Legkisebb verzió | Mire jó |
|---|---|---|
| `seopress_user_consent` | 7.8 | A Google Consent Mode alapértelmezett JavaScript-kódja. |
| `seopress_gtag_before_closing_script` | 7.5.1 | Saját kód a gtag-szkript záró címkéje elé. |
| `seopress_gtag_ec_item_id` | 9.9 | Az e-kereskedelmi eseményekben küldött termékazonosító. |
| `seopress_rgpd_edit_message` | 8.0 | A süti-választás kezelésére szolgáló üzenet. |
| `seopress_gtag_ec_single_view_details_ev` | 7.0 | A termék részleteinek megtekintése esemény kódja. |
| `seopress_gtag_phone_tracking_ev` | 6.3 | A telefonszám-linkek követésének kódja. |
| `seopress_matomo_dashboard_widget_cap` | 6.1 | A Matomo vezérlőpult-widgetjének jogosultsága. |
| `seopress_clarity_tracking_js` | 5.6 | A Microsoft Clarity követőkódja. |
| `seopress_gtag_ec_status` | 4.5 | A Google Analyticsnek jelentett WooCommerce-rendelésállapotok. |
| `seopress_matomo_no_heatmaps` | 4.2 | A Matomo hőtérképeinek és munkamenet-felvételeinek kikapcsolása. |
| `seopress_gtag_ga4` | 4.2 | A GA4 konfigurációs (`config`) sora. |
| `seopress_gtag_ec_add_to_cart_single_ev` | 3.8.8 | A termékoldali „kosárba” esemény kódja. |
| `seopress_gtag_ec_add_to_cart_archive_ev` | 3.8.8 | A terméklistás „kosárba” esemény kódja. |
| `seopress_gtag_ec_add_to_cart_checkout_ev` | 3.8.8 | A kosár frissítésekor küldött „kosárba” esemény kódja. |
| `seopress_gtag_ec_remove_from_cart_ev` | 3.8.8 | A kosárból törlés esemény kódja. |
| `seopress_gtag_ec_remove_from_cart_checkout_ev` | 3.8.8 | A kosároldali gombokra kattintáskor küldött törlés esemény kódja. |
| `seopress_gtag_ec_purchases_ev` | 3.8.8 | A vásárlás (`purchase`) esemény kódja. |
| `seopress_matomo_link_tracking` | 3.8.5 | A Matomo letöltés- és kimenő link követése. |
| `seopress_matomo_dnt` | 3.8.5 | A Matomo „Do Not Track” beállítása. |
| `seopress_matomo_disable_cookies` | 3.8.5 | A Matomo sütik letiltása. |
| `seopress_matomo_linker` | 3.8.5 | A Matomo több domainre kiterjedő követése. |
| `seopress_matomo_no_js` | 3.8.5 | A Matomo JavaScript nélküli követőképe. |
| `seopress_matomo_cd_categories_ev` | 3.8.5 | A kategóriák egyéni dimenziója a Matomóban. |
| `seopress_matomo_cd_tags_ev` | 3.8.5 | A címkék egyéni dimenziója a Matomóban. |
| `seopress_matomo_cd_cpt_ev` | 3.8.5 | A bejegyzéstípus egyéni dimenziója a Matomóban. |
| `seopress_matomo_cd_logged_in_ev` | 3.8.5 | A bejelentkezett felhasználó egyéni dimenziója a Matomóban. |
| `seopress_cookies_expiration_days` | 4.1 | A hozzájárulást tároló süti lejárata napokban. |

## Google Analytics 4

**Mérési azonosító és konfiguráció.** A `seopress_gtag_ga4` szűrő a GA4 `gtag('config', …)` sorát kapja szövegként, és a visszaadott szöveg kerül az oldalra. Itt tudsz például paramétert hozzáadni a konfigurációhoz.

```php
add_filter( 'seopress_gtag_ga4', function ( $js ) {
    // A konfigurációs sor módosítása vagy cseréje.
    return $js;
} );
```

**Saját kód a szkript végén.** A `seopress_gtag_before_closing_script` szűrő alapértelmezés szerint üres szöveget kap. Amit visszaadsz, az a gtag-szkript záró címkéje elé kerül, tehát JavaScript-kód lehet.

```php
add_filter( 'seopress_gtag_before_closing_script', function ( $js ) {
    return $js . "\nconsole.log('Analitika betöltve');";
} );
```

**Telefonszám-követés.** A `seopress_gtag_phone_tracking_ev` szűrő a telefonszám-linkekre (`tel:`) kattintást figyelő JavaScript-kódot kapja. Akkor van hatása, ha a telefonszám-követés be van kapcsolva az analitikai beállításoknál. A kódot módosíthatod vagy lecserélheted.

## Google Analytics e-kereskedelem (WooCommerce)

**Rendelésállapotok.** A `seopress_gtag_ec_status` szűrő egy tömböt kap azokkal a rendelésállapotokkal, amelyeknél a rendelés adatai a Google Analyticsnek mennek. Alapértelmezés szerint ez `completed` (teljesítve) és `processing` (feldolgozás alatt). Bővítheted például a `on-hold` állapottal.

```php
add_filter( 'seopress_gtag_ec_status', function ( $status ) {
    $status[] = 'on-hold';
    return $status;
} );
```

**Termékazonosító.** Az e-kereskedelmi rendelési eseményben a termék azonosítója alapértelmezés szerint a cikkszám (SKU), ennek hiányában a termék azonosítószáma. A `seopress_gtag_ec_item_id` szűrő négy paramétert kap: az azonosítót, a termék objektumot (`WC_Product`), a rendelési tételt és a rendelést. Így például variációs termékeknél mindig a szülőtermék azonosítóját küldheted.

```php
add_filter( 'seopress_gtag_ec_item_id', function ( $item_id, $product, $item, $order ) {
    if ( $product->is_type( 'variation' ) ) {
        return $product->get_parent_id();
    }
    return $item_id;
}, 10, 4 );
```

**Termék megtekintése esemény.** A `seopress_gtag_ec_single_view_details_ev` szűrő a termékoldal megtekintését jelentő eseményhez tartozó teljes kódrészletet kapja, és a visszaadott szöveg íródik ki az oldalra.

**Kosár- és vásárlási események.** Ezek a szűrők mind szövegként kapják az oldalra kerülő eseménykódot, és a visszaadott szöveg íródik ki. A WooCommerce e-kereskedelmi követésnek be kell lenni kapcsolva.

| Szűrő | Mikor fut |
|---|---|
| `seopress_gtag_ec_add_to_cart_single_ev` | Termékoldal, a „kosárba” esemény. |
| `seopress_gtag_ec_add_to_cart_archive_ev` | Terméklista (bolt, kategória), a „kosárba” esemény. |
| `seopress_gtag_ec_add_to_cart_checkout_ev` | A kosár frissítésekor küldött `add_to_cart` esemény `<script>` kódja. |
| `seopress_gtag_ec_remove_from_cart_ev` | A kosárban a termék melletti eltávolító (×) gombra kattintáskor küldött `remove_from_cart` esemény. |
| `seopress_gtag_ec_remove_from_cart_checkout_ev` | A kosároldali műveleti gombokra kattintáskor küldött `remove_from_cart` esemény; második paramétere a kosár tételeinek tömbje. |
| `seopress_gtag_ec_purchases_ev` | A rendelés-visszaigazoló oldalon a `gtag('event', 'purchase', …)` sor, benne a tranzakció azonosítójával, értékkel, pénznemmel, adóval, szállítási díjjal és a tételekkel. |

```php
add_filter( 'seopress_gtag_ec_purchases_ev', function ( $js ) {
    // A vásárlás esemény módosítása vagy cseréje.
    return $js;
} );
```

## Süti-hozzájárulás

**Consent Mode alapértelmezés.** A `seopress_user_consent` szűrő a Google Consent Mode `default` hívását tartalmazó JavaScript-kódot kapja. Alapértelmezés szerint a `ad_user_data`, `ad_personalization`, `ad_storage` és `analytics_storage` értéke `denied`, a `wait_for_update` pedig 500 ezredmásodperc. A visszaadott érték változtatás nélkül kerül az oldalra, ezért csak megbízható kódot adj vissza.

```php
add_filter( 'seopress_user_consent', function ( $consent ) {
    // Itt módosíthatod az alapértelmezett hozzájárulási értékeket.
    return $consent;
} );
```

**Süti-választás üzenete.** A `seopress_rgpd_edit_message` szűrő két paramétert kap: a süti-választást kezelő üzenet HTML-kódját és a „hozzájárulás módosítása” gomb kódját. A visszaadott HTML jelenik meg a látogatónak.

**Lejárat.** A hozzájárulást tároló süti alapértelmezett lejárata 30 nap, vagy az a szám, amit a süti-beállításoknál megadtál. A `seopress_cookies_expiration_days` szűrővel ezt a számot írhatod felül.

```php
add_filter( 'seopress_cookies_expiration_days', function ( $days ) {
    return 90;
} );
```

## Matomo

**Hőtérképek és munkamenet-felvételek.** Ha a Matomo beállításai között be van kapcsolva a hőtérképek és munkamenet-felvételek tiltása, a követőkódba a `_paq.push(['HeatmapSessionRecording::disable']);` sor kerül. A `seopress_matomo_no_heatmaps` szűrő ezt a sort kapja meg, így módosíthatod vagy lecserélheted.

**Vezérlőpult-widget jogosultsága.** Ha a Matomo widget szerepkör-korlátozása nincs beállítva, a widget a `edit_dashboard` jogosultsághoz kötött. A `seopress_matomo_dashboard_widget_cap` szűrő ezt a jogosultságnevet kapja, és másikat adhatsz vissza.

```php
add_filter( 'seopress_matomo_dashboard_widget_cap', function ( $cap ) {
    return 'manage_options';
} );
```


**Követési funkciók.** Az alábbi szűrők a Matomo-kódba kerülő `_paq.push(…)` sort kapják szövegként, de csak akkor futnak, ha a megfelelő funkció be van kapcsolva a Matomo beállításainál.

| Szűrő | Alapértelmezett sor | Funkció |
|---|---|---|
| `seopress_matomo_dnt` | `_paq.push(['setDoNotTrack', true]);` | Do Not Track tiszteletben tartása. |
| `seopress_matomo_disable_cookies` | `_paq.push(['disableCookies']);` | Az összes követősüti letiltása. |
| `seopress_matomo_linker` | `setDomains` és `enableCrossDomainLinking` | Több domain összekapcsolása (csak ha a domainek meg vannak adva). |
| `seopress_matomo_link_tracking` | `_paq.push(['enableLinkTracking']);` | Letöltések és kimenő linkek követése. |
| `seopress_matomo_no_js` | `<noscript>` blokk a követőképpel | Követés JavaScript nélkül; a kód a `<body>` elejére kerül. |

**Egyéni dimenziók.** Ha a beállításoknál egyéni dimenzióhoz rendelsz egy értéket, a bővítmény `setCustomVariable` sort ír ki, és az alábbi szűrők ezt a sort módosíthatják:

| Szűrő | Mit küld | Mikor |
|---|---|---|
| `seopress_matomo_cd_categories_ev` | A bejegyzés első kategóriájának neve | Bejegyzésen, ha van kategóriája. |
| `seopress_matomo_cd_tags_ev` | A címkék vesszővel elválasztva | Bejegyzésen, ha van címkéje. |
| `seopress_matomo_cd_cpt_ev` | A bejegyzéstípus neve | Egyedi bejegyzésoldalon. |
| `seopress_matomo_cd_logged_in_ev` | A bejelentkezett felhasználó azonosítója | Csak bejelentkezett látogatónál. |

```php
add_filter( 'seopress_matomo_linker', function ( $js ) {
    return $js;
} );
```
## Microsoft Clarity

A `seopress_clarity_tracking_js` szűrő a teljes Clarity JavaScript-kódot kapja `<script>` címkék nélkül. A visszaadott kód kerül az oldalra, a címkékbe csomagolást a bővítmény végzi.

```php
add_filter( 'seopress_clarity_tracking_js', function ( $js ) {
    return $js;
} );
```