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

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, a süti-hozzájárulásról, a Matomóról és a Clarityről szóló fejezetek szólnak; a hookok általános használatáról a Composer és hookok használata 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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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