# Analitikai hookok: egyéni kódok, Google Ads, hozzájárulási üzenet, Matomo

> További szűrők: az egyéni követőkódok, a Google Ads sor, a süti-hozzájárulási sáv üzenete és stílusa, a Google Analytics widget jogosultsága és a Matomo beállításai.

Ez a fejezet az [előző analitikai hookfejezet](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-analitika-google-analytics-matomo-clarity/) kiegészítése. Itt az egyéni követőkódok, a Google Ads, a süti-hozzájárulási sáv, a Google Analytics vezérlőpult-widgetje és a Matomo néhány további szűrője található. A szűrőket a sablon `functions.php` fájljába vagy egy saját bővítménybe tedd. 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ás](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-sutisav-hozzajarulas/) és a [Matomo](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-matomo/) fejezet szól.

| Hook | Legkisebb verzió | Mire jó |
|---|---|---|
| `seopress_gtag_after_additional_tracking_html` | 3.5 | Az egyéni követőkód a fejlécben. |
| `seopress_custom_body_tracking` | 3.6.2 | Az egyéni követőkód a `<body>` nyitása után. |
| `seopress_custom_footer_tracking` | 3.7.5 | Az egyéni követőkód a `<body>` zárása előtt. |
| `seopress_gtag_ads` | 3.6 | A Google Ads `config` sora. |
| `seopress_ga_dashboard_widget_cap` | 3.5.4 | A Google Analytics vezérlőpult-widget jogosultsága. |
| `seopress_rgpd_message` | 3.1 | A süti-hozzájárulási sáv szövege. |
| `seopress_rgpd_full_message` | 3.3.7 | A süti-hozzájárulási sáv teljes HTML-je. |
| `seopress_rgpd_full_message_styles` | 3.8.2 | A sáv beágyazott stíluslapja. |
| `seopress_matomo_site_domain` | 3.8.5 | Az oldal domainjének az oldalcím elé írása a Matomóban. |
| `seopress_matomo_cookie_domain` | 3.8.5 | A Matomo sütijének domainje aldomainek követésekor. |
| `seopress_matomo_cd_author_ev` | 3.8.5 | A szerző egyéni dimenziója a Matomóban. |
| `seopress_matomo_tracking_html` | 3.8.5 | A teljes Matomo-követőkód. |

## Egyéni követőkódok

Az **Analytics › Tracking code** részen három mezőbe írhatsz saját kódot: **Other tracking code (head)**, **Other tracking code (body)** és **Other tracking code (footer)**. Mindhárom kódja az oldalra kerülés előtt átmegy egy szűrőn, amely szövegként megkapja a mezőbe írt kódot. A visszaadott szöveg kerül az oldalra változtatás nélkül, ezért csak megbízható kódot adj vissza. Ha a mező üres, a szűrő nem fut.

| Mező | Szűrő | Hová kerül a kód |
|---|---|---|
| **Other tracking code (head)** | `seopress_gtag_after_additional_tracking_html` | A fejlécbe (`<head>`), a Google Analytics kódja után. |
| **Other tracking code (body)** | `seopress_custom_body_tracking` | Közvetlenül a `<body>` nyitó címkéje után. |
| **Other tracking code (footer)** | `seopress_custom_footer_tracking` | A `<body>` záró címkéje elé. |

```php
add_filter( 'seopress_custom_footer_tracking', function ( $html ) {
    // Például egy megjegyzés hozzáfűzése a lábléci kódhoz.
    return $html . "\n<!-- Saját követőkód vége -->";
} );
```

Ugyanígy működik a másik kettő is: a hook neve cserélődik, a függvény a mezőbe írt HTML-t kapja és adja vissza.

## Google Ads

Ha az **Enable Google Ads** mezőbe beírtál egy `AW-…` azonosítót, a bővítmény egy `gtag('config', …)` sort ír az oldalra. A sort a `seopress_gtag_ads` szűrő szövegként kapja meg, és a visszaadott szöveg kerül az oldalra. A sor csak akkor készül el, ha a látogató nem utasította el a süti-hozzájárulást.

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

## A Google Analytics vezérlőpult-widgetje

Ha a biztonsági beállításoknál nincs szerepkör megadva a Google Analytics widgethez, a widgetet az látja, akinek az `edit_dashboard` jogosultsága megvan. A `seopress_ga_dashboard_widget_cap` szűrő ezt a jogosultságnevet kapja, és másikat adhatsz vissza. Ha a szerepkör meg van adva, a szűrő nem fut.

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

## A süti-hozzájárulási sáv

Három szűrő módosítja a hozzájárulási sávot, a szűrők sorrendje szerint haladva a szövegtől a teljes kódig.

**Szöveg.** A `seopress_rgpd_message` szűrő a sáv szövegét kapja. Ez a beállításoknál megadott üzenet, ennek hiányában az alapértelmezett szöveg, az adatvédelmi oldal linkjével. Ha az üzenetben a `[seopress_privacy_page]` helyőrző szerepelt, a szűrő már a kicserélt (valódi hivatkozást tartalmazó) szöveget kapja.

```php
add_filter( 'seopress_rgpd_message', function ( $msg ) {
    return $msg . ' Kérdés esetén írj nekünk.';
} );
```

**Teljes HTML.** A `seopress_rgpd_full_message` szűrő a sáv teljes HTML-jét kapja, és a visszaadott kód jelenik meg a látogatónak. Öt paramétere van:

| Paraméter | Tartalma |
|---|---|
| 1. | A sáv teljes HTML-je (ezt kell visszaadni). |
| 2. | A szöveg, a `seopress_rgpd_message` szűrő utáni állapotban. |
| 3. | Az elfogadó gomb felirata. |
| 4. | Az elutasító gomb felirata. |
| 5. | A háttérréteg (backdrop) HTML-je, amely a sáv után kerül az oldalra. |

```php
add_filter( 'seopress_rgpd_full_message', function ( $html, $msg, $accept, $decline, $backdrop ) {
    // Itt újraépítheted a sáv szerkezetét. A gombok azonosítói
    // (seopress-user-consent-accept, seopress-user-consent-close)
    // maradjanak meg, különben a gombok nem működnek.
    return $html;
}, 10, 5 );
```

**Stílusok.** A `seopress_rgpd_full_message_styles` szűrő a sáv beágyazott `<style>` blokkját kapja szövegként (a nyitó és záró címkével együtt). A visszaadott szöveg íródik ki az oldalra. Így a sáv színeit, méretét vagy elhelyezését egy saját szabállyal is felülírhatod, a beállítófelület használata nélkül.

```php
add_filter( 'seopress_rgpd_full_message_styles', function ( $styles ) {
    return $styles . '<style>.seopress-user-consent button{border-radius:0;}</style>';
} );
```

## Matomo

A Matomo-szűrők csak akkor futnak, ha a Matomo be van kapcsolva, és az azonosító mezők ki vannak töltve.

| Szűrő | Alapértelmezett érték | Mikor fut |
|---|---|---|
| `seopress_matomo_cookie_domain` | `_paq.push(['setCookieDomain', '*.example.com']);` | Ha az aldomainek követése be van kapcsolva; a domain a webhely címéből készül. |
| `seopress_matomo_site_domain` | `_paq.push(['setDocumentTitle', document.domain + '/' + document.title]);` | Ha a **Prepend site domain** be van kapcsolva. |
| `seopress_matomo_cd_author_ev` | `_paq.push(['setCustomVariable', …, 'visit']);` a szerző nevével | Ha a szerző egyéni dimenziójához rendeltél helyet, és egyedi bejegyzés vagy oldal van megnyitva. |
| `seopress_matomo_tracking_html` | A teljes `<script>` blokk | Mindig, amikor a Matomo-kód készül. |

Az első három szűrő az adott `_paq.push(…)` sort kapja szövegként, a visszaadott szöveg kerül a kódba. A `seopress_matomo_tracking_html` a teljes, `<script>` címkékkel együtt összeállított követőkódot kapja, így ezzel bármelyik sort módosíthatod vagy a kódot kiegészítheted.

```php
add_filter( 'seopress_matomo_tracking_html', function ( $html ) {
    // A teljes Matomo-kód módosítása vagy kiegészítése.
    return $html;
} );
```