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

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 fejezet szól. A beállítófelületről az Analitika és az eseménykövetés fejezet ír. A másik két analitikai hookfejezet: Google Analytics, süti-hozzájárulás, Matomo, Clarity és egyéni kódok, Google Ads, hozzájárulási üzenet, Matomo.

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.

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 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.

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).

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.

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.

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.

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), 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.

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;
} );