# Analitikai hookok: egyéni dimenziók, linkkövetés, hozzájárulás utáni kód, widget

> A Google Analytics egyéni dimenzióit, a külső, letöltési és partnerlink-követést, a teljes követőkódot, a hozzájárulás utáni egyéni kódot és a vezérlőpult-widgetet módosító szűrők.

Ez a fejezet a Google Analytics kimenetét módosító további szűrőket gyűjti össze. A szűrőket a sablon `functions.php` fájljába vagy egy saját bővítménybe tedd; az általános használatukról a [Composer és hookok használata](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/fejlesztoknek-composer-es-hookok/) fejezet szól. A beállítófelületről az [Analitika](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-google-analytics/) és az [eseménykövetés](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-google-esemenykovetes/) fejezet ír. A másik két analitikai hookfejezet: [Google Analytics, süti-hozzájárulás, Matomo, Clarity](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-analitika-google-analytics-matomo-clarity/) és [egyéni kódok, Google Ads, hozzájárulási üzenet, Matomo](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-analitika-tovabbi-szurok/).

| Hook | Legkisebb verzió | Mire jó |
|---|---|---|
| `seopress_custom_tracking` | 3.0 | Saját követőkód, amely csak süti-hozzájárulás után kerül az oldalra. |
| `seopress_ga_dashboard_widget` | 2.7.1 | A Google Analytics vezérlőpult-widget eltávolítása. |
| `seopress_gtag_html` | 2.6 | A teljes Google Analytics követőkód. |
| `seopress_gtag_cd_author_cf` / `_ev` | 2.6 | A szerző egyéni dimenziója. |
| `seopress_gtag_cd_categories_cf` / `_ev` | 2.6 | A kategória egyéni dimenziója. |
| `seopress_gtag_cd_tags_cf` / `_ev` | 2.6 | A címkék egyéni dimenziója. |
| `seopress_gtag_cd_cpt_cf` / `_ev` | 2.6 | A bejegyzéstípus egyéni dimenziója. |
| `seopress_gtag_cd_logged_in_cf` / `_ev` | 2.6 | A bejelentkezett felhasználó egyéni dimenziója. |
| `seopress_gtag_cd_hook_cf` / `_ev` | 2.6 | Saját egyéni dimenzió. |
| `seopress_gtag_link_tracking_ev` | 2.6 | A külső linkek követésének kódja. |
| `seopress_gtag_download_tracking_ev` | 2.6 | A letöltések követésének kódja. |
| `seopress_gtag_outbound_tracking_ev` | 2.6 | A partner- és kimenő linkek követésének kódja. |

## Saját követőkód a hozzájárulás után

A `seopress_custom_tracking` szűrő alapértelmezés szerint üres szöveget kap. Amit visszaadsz, az az oldal fejlécébe (`wp_head`) kerül változtatás nélkül, ezért csak megbízható kódot adj vissza. Ha a süti-hozzájárulási sáv be van kapcsolva, a kód csak azoknak a látogatóknak jelenik meg, akik elfogadták a követést.

```php
add_filter( 'seopress_custom_tracking', function ( $html ) {
    return $html . "\n<script>/* saját követőkód */</script>";
} );
```

Ha a kódot a beállítófelületen szeretnéd megadni, használd az **Other tracking code** mezőket; azokhoz a [további szűrők](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-analitika-tovabbi-szurok/) fejezet tartozik.

## A vezérlőpult-widget eltávolítása

A Google Analytics widget a WordPress vezérlőpultján jelenik meg. A `seopress_ga_dashboard_widget` szűrő a widget létrehozása előtt fut. Ha van hozzá csatolt szűrő, és az `false` értéket ad vissza, a widget nem jön létre. Így a felhasználóktól függetlenül, kódból is eltüntetheted.

```php
add_filter( 'seopress_ga_dashboard_widget', '__return_false' );
```

Ha csak a jogosultságot szeretnéd módosítani, azt a `seopress_ga_dashboard_widget_cap` szűrő teszi (lásd az [egyéni kódok fejezetet](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/hook-analitika-tovabbi-szurok/)).

## A teljes követőkód

A `seopress_gtag_html` szűrő a Google Analytics teljes kimenetét kapja szövegként, a `<script>` címkékkel együtt: a mérési azonosítót, a konfigurációt, az eseménykövetéseket és a `seopress_gtag_before_closing_script` szűrő kódját is. A visszaadott szöveg kerül az oldalra, így bármelyik részét átírhatod vagy kiegészítheted.

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

## Egyéni dimenziók

Ha az analitikai beállításoknál a szerzőhöz, a kategóriához, a címkéhez, a bejegyzéstípushoz vagy a bejelentkezett felhasználóhoz egyéni dimenziót rendelsz, a bővítmény mindegyikhez két kódrészletet készít. Mindkettőhöz tartozik szűrő:

- **`_cf` végű szűrő (konfiguráció).** Az adott dimenzió sora a `config` hívásban, például `'dimension1': 'cd_author',`. A szűrő ezt a szöveget kapja.
- **`_ev` végű szűrő (esemény).** Az az esemény, amely a dimenzió értékét elküldi, például `gtag('event', 'Authors', {'cd_author': 'Kovács Anna', 'non_interaction': true});`. A szűrő ezt a szöveget kapja.

Mindkét szűrő szövegként kapja és adja vissza a kódrészletet, és a visszaadott szöveg kerül az oldalra.

| Dimenzió | Szűrők | Mikor készül el | Mit küld |
|---|---|---|---|
| Szerző | `seopress_gtag_cd_author_cf`, `seopress_gtag_cd_author_ev` | Egyedi bejegyzésen vagy oldalon. | A szerző megjelenített neve. |
| Kategória | `seopress_gtag_cd_categories_cf`, `seopress_gtag_cd_categories_ev` | Bejegyzésoldalon, ha van kategóriája. | Az első kategória neve. |
| Címkék | `seopress_gtag_cd_tags_cf`, `seopress_gtag_cd_tags_ev` | Bejegyzésoldalon, ha van címkéje. | A címkék nevei vesszővel elválasztva. |
| Bejegyzéstípus | `seopress_gtag_cd_cpt_cf`, `seopress_gtag_cd_cpt_ev` | Bejegyzésoldalon. | A bejegyzéstípus neve. |
| Bejelentkezett felhasználó | `seopress_gtag_cd_logged_in_cf`, `seopress_gtag_cd_logged_in_ev` | Csak bejelentkezett látogatónál. | A felhasználó azonosítószáma. |

Az egyéni dimenziók csak akkor készülnek el, ha a látogató nem utasította el a süti-hozzájárulást.

```php
add_filter( 'seopress_gtag_cd_author_ev', function ( $js ) {
    // A szerző eseményének módosítása vagy cseréje.
    return $js;
} );
```

### Saját egyéni dimenzió

A `seopress_gtag_cd_hook_cf` és a `seopress_gtag_cd_hook_ev` szűrővel saját dimenziót is hozzáadhatsz. A bővítmény csak akkor veszi figyelembe, ha **mindkét** szűrőhöz tartozik függvény; ha az egyik hiányzik, a saját dimenzió kimarad. Mindkét szűrő egy logikai értéket kap (hogy van-e már ilyen dimenzió), és a visszaadott értékből dől el, hogy a kód bekerül-e.

```php
add_filter( 'seopress_gtag_cd_hook_cf', function ( $van ) {
    return "'dimension6': 'cd_sajat',";
} );
add_filter( 'seopress_gtag_cd_hook_ev', function ( $van ) {
    return "gtag('event', 'Sajat', {'cd_sajat': 'ertek', 'non_interaction': true});";
} );
```

## Külső linkek, letöltések és partnerlinkek követése

Ha az eseménykövetést bekapcsoltad (lásd: [Google Analytics eseménykövetés](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/analitika-google-esemenykovetes/)), a bővítmény egy kis JavaScript-kódot ír az oldalra, amely a linkekre kattintáskor `click` eseményt küld. A három kódot külön-külön módosíthatod. A szűrők a kódot szövegként kapják (`window.addEventListener('load', …)` blokk), a visszaadott szöveg kerül az oldalra.

| Szűrő | Mikor fut | Az esemény kategóriája |
|---|---|---|
| `seopress_gtag_link_tracking_ev` | Ha az **Enable external links tracking** be van kapcsolva. | `external links` |
| `seopress_gtag_download_tracking_ev` | Ha az **Enable downloads tracking** be van kapcsolva, és a kiterjesztések mezője nem üres. | `downloads` |
| `seopress_gtag_outbound_tracking_ev` | Ha az **Enable affiliate/outbound links tracking** be van kapcsolva, és az útvonalrészletek mezője nem üres. | `outbound/affiliate` |

Az esemény címkéje (`event_label`) mindhárom esetben a link teljes URL-je. A külső linkek kódja azt nézi, hogy a link címe tartalmazza-e az oldal domainjét; ha nem, külső linknek számít.

```php
add_filter( 'seopress_gtag_download_tracking_ev', function ( $js ) {
    // A letöltéskövető kód módosítása vagy cseréje.
    return $js;
} );
```
