A Must-Have Analytics dokumentációja

Jelenlegi verzió: 1.0.6.1
Szövegdomain: mhanalytics

A Must‑Have Analytics egy adatvédelem-központú, teljesítményre optimalizált analitikai megoldás WordPresshez.

A felhőalapú szolgáltatásokkal ellentétben az adataid a saját szervereden maradnak. Nincs adatmegosztás harmadik felekkel, és már alapból teljes mértékben megfelel a GDPR előírásainak.

Kövesd nyomon a látogatókat, elemezd a viselkedésüket, mérd a konverziókat és exportáld a célközönségeket – mindezt a felhasználók adatainak védelme mellett.

Telepítés és licencelés

Telepítés

A Must‑Have Analytics egy WordPress-bővítmény, amely ugyanúgy telepíthető, mint bármely más bővítmény.

A WordPress adminfelületén keresztül:

1. Töltsd le a bővítmény ZIP-fájlját a vásárlást visszaigazoló e-mailből vagy a fiókodból
2. Lépj a WordPress adminfelület → Bővítmények → Új hozzáadása → Bővítmény feltöltése menüpontra
3. Válaszd ki a ZIP-fájlt, majd kattints a Telepítés most gombra
4. A telepítés után kattints a Bővítmény bekapcsolása gombra

FTP-n keresztül:

1. Csomagold ki a bővítmény ZIP-fájlját
2. Töltsd fel a must-have-analytics mappát a /wp-content/plugins/ könyvtárba
3. Lépj a WordPress adminfelület → Bővítmények menüpontra, és kapcsold be a Must‑Have Analytics bővítményt

A licenc aktiválása

A telepítés után a bővítmény automatikusan átirányít a musthaveplugins.com weboldalra a hitelesítéshez.

Jelentkezz be a Must‑Have Plugins-fiókoddal, ezután a rendszer automatikusan aktiválja a licencedet, majd visszairányít a WordPress Vezérlőpultodra.

Nincs szükség licenckulcsra – csak jelentkezz be a fiókodba, és a weboldalad aktiválva lesz.

A licencet később a Must‑Have Analytics → Settings → System lapon is kezelheted (License: Connect / Disconnect).

A licenced a csomagodban meghatározott számú weboldalon teszi lehetővé a telepítést (Single: 1 weboldal, Multi: 5 weboldal, Must-Have Pack: korlátlan számú weboldal).

Rendszerkövetelmények

• Minimum: WordPress 5.8+, PHP 7.4+, MySQL 5.7+ / MariaDB 10.2+, 128MB memória
• Ajánlott: WordPress 6.0+, PHP 8.0+, MySQL 8.0+ / MariaDB 10.5+, 256MB memória

Hogyan működik?

A Must‑Have Analytics egy könnyű, a weboldalad minden oldalán futó JavaScript-követő segítségével követi nyomon a látogatók viselkedését.

Amikor egy látogató betölt egy oldalt, a követő adatokat gyűjt a látogatásról, és egy REST API-végponton keresztül elküldi azokat a WordPress-weboldaladra.

Követés sütivel

Ha a sütialapú követés engedélyezve van (Beállítások → Általános → Követési süti), a bővítmény létrehoz egy _mhanalytics nevű, belső sütit.

Ez a süti egy egyedi látogatóazonosítót tartalmaz, amely a munkamenetek között is megmarad. Így a bővítmény felismerheti a visszatérő látogatókat, és idővel egységes látogatói útvonallá kapcsolhatja össze az interakcióikat.

A süti alapértelmezés szerint 365 napos (1 éves) lejárati idővel rendelkezik. Ez egy belső süti (a saját domained állítja be), ezért a harmadik féltől származó sütik blokkolása nem érinti.

Követés süti nélkül

Ha a sütialapú követés ki van kapcsolva, a bővítmény eszköz-ujjlenyomatot használ a visszatérő látogatók azonosítására.

Az ujjlenyomat a következőkből készül: IP-cím (anonimizálva, ha a profilozás ki van kapcsolva) és egyéb eszközazonosítók.

Ez a módszer kevésbé pontos, mint a sütik használata, de így is hasznos információkkal szolgál. A munkameneteket az eszköz-ujjlenyomat alapján, egy 20 perces időablakon belül kapcsolja össze (süti nélkül).

Entitásprofilozás (opcionális)

Ha engedélyezed, a bővítmény személyazonosításra alkalmas adatokat gyűjt a részletes látogatói profilok létrehozásához.

A profiladatok a következőket tartalmazzák: e-mail-címek, telefonszámok, keresztnevek, vezetéknevek, teljes IP-címek (anonimizálás nélkül), teljes böngészési előzmények.

Ezeket az adatokat a felhasználók által megadott adatokból gyűjti össze, például űrlapokból, fizetési folyamatokból, felhasználói regisztrációkból és minden más olyan beviteli mezőből, ahol a látogatók megosztják az adataikat.

Ha a profilozás ki van kapcsolva, minden IP-címet anonimizál (eltávolítja az utolsó oktettet), és nem tárol személyes adatokat.

GDPR-megfelelőség: Bár a weboldal látogatói számára ez nem látható, a profilozást csak a felhasználó hozzájárulásának megszerzése után engedélyezd. Ha a weboldaladra vonatkozik a GDPR, egy szűrő használatával feltételesen kikapcsolhatod a profilozást a felhasználó hozzájárulása alapján::

add_filter('mhanalytics_option_profiling', function($result) {
    if (!isset($_COOKIE['your_custom_profiling_consent_cookie'])) {
        return '';
    }
    return $result;
});

Adatmegőrzés

A nyers analitikai adatokat (látogatások, események, munkamenetek) a Beállítások → Általános → Nyers adatok megőrzése menüpontban meghatározott ideig őrzi meg (alapértelmezés: 24 hónap).

Ezen időszak után az adatok automatikusan törlődnek. Ez segít megfelelni a GDPR adattakarékosságra vonatkozó követelményeinek.

A profilozási adatok saját lejárati idővel rendelkeznek, amelyet a valid_until mezőben állíthatsz be. Az adatokat bármikor exportálhatod vagy törölheted a Beállítások → Rendszer menüpontban.

A célok működése

A célok olyan konverziós események, amelyeket feltételek segítségével határozhatsz meg. Amikor egy látogató az összes feltételnek megfelelő műveletet hajt végre, teljesíti a célt.

A célokat minden eseménynél valós időben értékeli ki. A bővítmény betölti az aktív célokat, ellenőrzi az egyes feltételeket, alkalmazza a logikát, és rögzíti a teljesítéseket.

A célteljesítések kiválthatják a következőket: szerveroldali konverziók küldése a Meta vagy a TikTok számára, pénzbeli érték követése, felvétel remarketinglistára.

Adatfolyam

Az adatok a következőképpen haladnak át a rendszeren:

1. A látogató betölti az oldalt → a követőszkript inicializálódik.
2. Bizonyos idő elteltével (a böngészőtől és egyéb feltételektől függően) a szkript eseményt küld a REST API-nak.
3. Amikor a látogató elnavigál vagy bezárja a lapot, a követő minden eseményadatot elküld a REST API-nak (/wp-json/mh-analytics/v1/event).
4. Az eseményfeldolgozó ellenőrzi és kiegészíti az adatokat (földrajzi hely, eszközfelismerés).
5. Entitásfeloldás (ha a profilozás engedélyezve van). A rendelkezésre álló azonosítók (sütik, felhasználói azonosító, profilozási adatok) alapján azonosít vagy létrehoz egy látogatói entitást.
6. Az időkeretre vonatkozó szabályok alapján létrehoz vagy meghosszabbít egy munkamenetet.
7. A célkiértékelő ellenőrzi, hogy teljesült-e valamelyik cél.
8. Ha egy cél teljesült, aktiválja a konverziós API-kat (Meta/TikTok).
9. Az adatokat normalizált adatbázistáblákban tárolja.

Vezérlőpult

A Vezérlőpult az a központi felület, ahol egyetlen pillantással áttekintheted a weboldalad teljesítményét.

A WordPress Admin → Must‑Have Analytics menüpontban érheted el. A Vezérlőpult testreszabható widgetekben jeleníti meg a főbb mérőszámokat és vizualizációkat.

Elérhető widgetek

• Aktív munkamenetek idővonala: A weboldaladon éppen aktív látogatók valós idejű száma, valamint a látogatói aktivitást időben ábrázoló idővonaldiagram
• Látogatói diagram: Interaktív trenddiagramokon jeleníti meg az oldalmegtekintéseket és az egyedi látogatókat a kiválasztott dátumtartományban. Válthatsz a különböző időszakok között, és napi, heti vagy havi trendeket tekinthetsz meg
• Legnépszerűbb oldalak: Felsorolja a leglátogatottabb oldalakat az oldalmegtekintések számával. Kattints bármelyik oldalra az adott URL részletes analitikai adatainak megtekintéséhez
• Legnépszerűbb érkezési oldalak: Megmutatja, mely oldalakra érkeznek először a látogatók a weboldaladon. Segít azonosítani a leghatékonyabb belépési pontokat
• Leggyakoribb kilépési oldalak: Megmutatja, mely oldalakról távoznak a látogatók. Hasznos lehet a lehetséges problémák vagy a felhasználói útvonal természetes kilépési pontjainak azonosításához
• Legfontosabb hivatkozó források: Megmutatja, honnan érkezik a forgalmad—közvetlen látogatásokból, keresőmotorokból, hivatkozó weboldalakról vagy közösségi médiából. Minden forgalmi forrást kategorizál és összesít
• Eszközök megoszlása: Eszköztípus szerinti megoszlás (asztali gép, mobil, táblagép, viselhető eszköz, TV, konzol). Kördiagramon jelenik meg, részletes százalékos adatokkal
• Legfontosabb országok: A látogatóid földrajzi megoszlása országnevekkel és látogatásszámokkal. Megmutatja, mely régiók generálják a legnagyobb forgalmat
• Legutóbbi célok: A közelmúltbeli célteljesítések időbélyegekkel és a hozzájuk tartozó értékekkel. Megmutatja a legutóbbi konverziókat az összes meghatározott célodnál
• Botforgalom: Felsorolja az észlelt botforgalmat felhasználói ügynök szerint, a találatok számával. Segít azonosítani a feltérképező robotok tevékenységét, és megkülönböztetni azt az emberi látogatóktól
• Sebességi mérőszámok: Megjeleníti a Core Web Vitals értékeit és a teljesítménymutatókat, beleértve az LCP (Largest Contentful Paint), FCP (First Contentful Paint), FID (First Input Delay), CLS (Cumulative Layout Shift), TTFB (Time to First Byte) és Cache Hit Rate értékeket. Vizuális jelzések mutatják, hogy a weboldalad megfelel-e a teljesítményküszöböknek

A Vezérlőpult testreszabása

Teljes mértékben testreszabhatod a Vezérlőpult elrendezését, hogy illeszkedjen a munkafolyamatodhoz.

Widgetek átrendezése: Kattints bármelyik widget címsorára, és húzd az új helyére. A rendszer automatikusan menti az elrendezést, amely a munkamenetek között is megmarad.

Widgetek megjelenítése/elrejtése: Kattints a jobb felső sarokban található Screen Options gombra. A widgetek megjelenítéséhez vagy elrejtéséhez jelöld be őket, illetve töröld a jelölésüket. A rejtett widgeteket bármikor újra engedélyezheted.

A Vezérlőpult beállításait felhasználónként menti a rendszer, így minden adminisztrátor saját, személyre szabott nézettel rendelkezhet.

Funkciók

A Must‑Have Analytics analitikai és marketingeszközök átfogó készletét kínálja.

Valós idejű követés

Nézd meg, kik tartózkodnak éppen a weboldaladon. Az Active Sessions widget automatikusan frissül, és megmutatja az aktuális látogatókat, valamint az általuk megtekintett oldalakat.

Kattints bármelyik aktív munkamenetre a látogató teljes útvonalának valós idejű megtekintéséhez.

Speciális jelentéskészítés

Készíts részletes jelentéseket az oldalmegtekintésekről, munkamenetekről, entitásokról, forgalmi forrásokról, eszközökről, országokról és egyebekről. A teljes listát a Jelentések szakaszban találod.

Minden jelentés tartalmaz rendezhető és szűrhető táblázatokat, dátumtartomány-választót, keresési funkciót, lapozást, valamint CSV-, Excel- és PDF-exportálási lehetőséget.

A kiválasztott oszlopok tetején az összeg vagy az átlag jelenik meg a gyors áttekintés érdekében. Prezentációkhoz minden diagram menthető PNG-képként.

Trenddiagramok

Idősoros elemzéshez vonaldiagramokon jelenítheted meg az adatok időbeli alakulását.

A diagramok dátum szerinti csoportosítási lehetőségekkel (nap, hét, hónap) mutatják a mérőszámok időbeli alakulását. Az összehasonlításhoz több adatsor is megjeleníthető ugyanazon a diagramon.

Minden diagram interaktív, és az elemleírások pontos értékeket jelenítenek meg. A diagramok nagy felbontású PNG-képként tölthetők le.

Exportálási lehetőségek

Bármely jelentést exportálhatod CSV, Excel (XLSX) vagy PDF formátumban.

Kattints bármely jelentésnél az Export gombra a formátum kiválasztásához. Az exportálás minden szűrt adatot tartalmaz (figyelembe véve az alkalmazott keresési vagy dátumtartomány-szűrőket).

A diagramok nagy felbontású PNG-képként menthetők. Kattints jobb gombbal bármelyik diagramra, és válaszd a Save Chart as Image lehetőséget.

Remarketinglisták exportálása

Hozz létre egyéni célközönségeket a Meta (Facebook), TikTok vagy Google Ads hirdetési kampányaidhoz.

Határozz meg szegmenseket a következők alapján: meglátogatott oldalak, elért célok, forgalmi forrás, eszköztípus, ország, dátumtartomány.

Exportálj célközönséglistákat megfelelően hashelt e-mail-címekkel és telefonszámokkal (az egyes platformok követelményeinek megfelelően).

E-mail-listák exportálása

Exportáld a látogatók kapcsolattartási adatait e-mail-marketingkampányokhoz.

Készíts CSV-fájlokat e-mail-címekkel, keresztnevekkel és vezetéknevekkel. Tökéletesen alkalmas Mailchimpbe, ConvertKitbe vagy bármely e-mail-szolgáltatóhoz történő importálásra.

Korrelációelemzés

Statisztikai elemzéssel derítsd ki, mely jellemzők növelik a konverziókat. A mérőszámok részletes magyarázatát a Korrelációelemzés szakaszban találod.

A korrelációelemző 8 dimenzióban (forgalmi források, országok, eszközök, céloldalak, napszak, a hét napja, a hónap napja, hónap) hasonlítja össze a konverziós arányokat, hogy statisztikailag szignifikáns eltéréseket találjon.

Az eredmények megjelenítik a Δ százalékpontokat, a növekedési szorzókat, a z‑értékeket, a p‑értékeket és a szignifikanciaszinteket. Például: a Google felől érkező látogatók konverziós aránya 2,3 százalékponttal magasabb (82%-os növekedés), ahol p = 0,0001 (erősen szignifikáns).

Sankey-folyamatábra

Jelenítsd meg a látogatók teljes útvonalát a forgalmi forrástól az oldalakon át a célkonverzióig. A részletes használati útmutatót a Sankey-folyamat szakaszban találod.

A Sankey-diagram megmutatja, honnan érkeznek a látogatók, mely oldalakat keresik fel (sorrendben), hol morzsolódnak le, és mely útvonalak vezetnek konverzióhoz.

Ennek segítségével azonosíthatod az értékesítési tölcsér szűk keresztmetszeteit, és optimalizálhatod a felhasználói élményt.

Célok és konverziók

Határozz meg konverziós célokat egyéni feltételekkel, fogd és vidd módszerrel használható összetevők segítségével. Mind a 26 feltételtípust megtalálod a Célok szakaszban.

A célok 4 kategória 26 feltételtípusát támogatják: Tartalom (URL, hivatkozó, céloldal, látható elem, médialejátszás), Felhasználó (visszatérő látogató, bejelentkezett felhasználó, ország, eszköz, operációs rendszer, felhasználói ügynök), Aktivitás (görgetés, kattintás, űrlap, az oldalon/weboldalon töltött idő, meglátogatott oldalak), Speciális (WordPress-műveletek), valamint 8 WooCommerce‑specifikus feltételt, ha a WooCommerce aktív.

A célok szerveroldali konverziós eseményeket indíthatnak a Meta és a TikTok felé, nyomon követhetik a pénzbeli értéket, számolhatják az egyedi teljesítéseket, és szegmentálásra is használhatók.

Szerveroldali konverziókövetés

Küldj konverziós eseményeket közvetlenül a szerveredről a Meta és a TikTok felé, megkerülve a hirdetésblokkolókat és az iOS adatvédelmi korlátozásait. A beállítási útmutatókat a Konverziós API-k szakaszban találod.

Ez akkor is pontos attribúciót biztosít a hirdetési kampányaidhoz, ha az ügyféloldali követés blokkolva vagy korlátozva van.

Entitások

Az entitások olyan egyedi látogatói profilok, amelyek a munkamenetek és eszközök között is megmaradnak.

Gondolj egy entitásra úgy, mint egy szállítási címre. Egy háztartásban több személy is használhatja ugyanazt a szállítási címet, és egy személynek több címe is lehet (otthoni, munkahelyi stb.).

Hasonlóképpen egy entitás általában egy személyt jelöl, de a kapcsolat nem mindig tökéletesen 1:1 arányú.

Miért nem mindig egy személyt jelöl egy entitás?

Az entitáskövető rendszer célja az egyedi személyek azonosítása, de a kapcsolat nem mindig tökéletesen 1:1 arányú.

Egy személyhez több entitás is tartozhat: A rendszer nem mindig tudja összekapcsolni egy felhasználó különböző eszközeit. Ha valaki nem jelentkezik be a telefonján és a laptopján is, a rendszer különálló entitásokként követheti őket.

Egy entitás több személyt is képviselhet: Ha a felhasználók nem fogadják el a sütiket, a rendszer tartalékmegoldásként eszköz-ujjlenyomatot használ. Irodákban vagy háztartásokban két, nagyon hasonló konfigurációjú eszközt (azonos böngésző, operációs rendszer, IP-cím) tévesen ugyanannak az entitásnak azonosíthat.

E szélsőséges esetek ellenére az entitáskövetés lényegesen pontosabb betekintést nyújt, mint önmagában a munkamenet‑alapú analitika.

Entitásprofilok

Ha a profilalkotás engedélyezve van, az entitások idővel részletes profiladatokat gyűjthetnek össze.

A profiladatok közé tartozik: e-mail-cím, telefonszám, keresztnév, vezetéknév, teljes IP-cím-előzmény, minden munkamenet és látogatás, minden elért cél, teljes konverziós érték.

Ezeket az adatokat a rendszer a következőkből gyűjti: felhasználói regisztrációk, WooCommerce-pénztárfolyamatok, kapcsolatfelvételi űrlapok beküldései, hírlevél-feliratkozások, valamint bármilyen e-mail-, telefon- vagy névmezőt tartalmazó űrlap.

Entitások megtekintése

Az összes követett entitás megtekintéséhez lépj a Must‑Have Analytics → Entities menüpontra.

Az entitáslista a következőket jeleníti meg: egyedi azonosító, első észlelés dátuma, utolsó észlelés dátuma, munkamenetek teljes száma, oldalmegtekintések teljes száma, e-mail-cím (ha ismert), hely (ország/város), eszköztípus és további részletes információk.

Kattints bármelyik entitásra a teljes részletek megtekintéséhez, beleértve a következőket: munkamenet-előzmények, minden meglátogatott oldal, elért célok, profilinformációk (egy entitáshoz több e-mail-cím, név, telefonszám és cím is társítható), eszközinformációk és a tevékenységek idővonala.

Munkamenetek

Egy munkamenet a weboldaladon tett egyetlen látogatást jelenti. Akkor kezdődik, amikor egy látogató megérkezik, és bizonyos idejű inaktivitás után ér véget.

Munkamenetek észlelése sütikkel

Ha a sütialapú követés engedélyezve van, a munkameneteket a _mhanalytics süti kezeli.

A munkamenet időkorlátja 60 perc. Új munkamenet kezdődik, ha a látogató még nem rendelkezik a sütivel, vagy ha az utolsó tevékenység óta több mint 60 perc telt el.

Minden oldalmegtekintés további 60 perccel hosszabbítja meg a munkamenet időkorlátját. Így a weboldaladat aktívan böngésző látogató ugyanabban a munkamenetben marad.

Munkamenetek észlelése sütik nélkül

Sütik nélkül a bővítmény eszköz-ujjlenyomatot használ a visszatérő látogatók azonosítására. Az ujjlenyomat a következőket egyesíti: IP-cím (anonimizálva, ha a profilalkotás ki van kapcsolva), User Agent karakterlánc és HTTP-fejlécek (Accept‑Language, Accept‑Encoding).

A sütik nélküli munkamenetek időtartama: kizárólag eszköz-ujjlenyomat használatával 20 perc. Engedélyezett profilalkotás és azonosított entitás esetén a munkamenetek akár 60 percre is meghosszabbíthatók.

Ez a módszer kevésbé pontos, mint a sütik használata, mert az ujjlenyomatok ütközhetnek (több, hasonló konfigurációjú felhasználó esetén), vagy a böngésző beállításaitól függően megváltozhatnak.

Munkamenetek időkeretei

A különböző azonosítási módszerek eltérő időkorlátokkal rendelkeznek:

• Süti (_mhanalytics): 60 perc
• Eszköz-ujjlenyomat (profilalkotás nélkül): 20 perc
• Eszköz-ujjlenyomat (profilalkotással): 20‑60 perc

Ezek az időkeretek WordPress-szűrőkkel testreszabhatók (mhanalytics/session_cookie_timeframe, mhanalytics/session_device_timeframe, mhanalytics/session_profile_timeframe).

Munkamenetek megtekintése

Az összes rögzített munkamenet megtekintéséhez lépj a Must‑Have Analytics → Sessions menüpontra.

A munkamenetlista a következőket jeleníti meg: munkamenet-azonosító, entitás (ha azonosítva van), kezdési időpont, időtartam, oldalmegtekintések, belépési oldal, kilépési oldal, forgalmi forrás, eszköz, hely.

Kattints bármelyik munkamenetre a következők megtekintéséhez: teljes oldalmegtekintési idővonal időbélyegekkel, események (űrlapbeküldések, kattintások stb.), elért célok, hivatkozói információk.

Aktív munkamenetek

A bővítmény valós időben követi a munkameneteket. Egy munkamenet akkor tekinthető aktívnak, ha az elmúlt 15 percben történt benne tevékenység.

Az aktív munkameneteket a Vezérlőpult widgetében vagy a Must‑Have Analytics → Sessions → Active Sessions lapon tekintheted meg.

Jelentések

A jelentések részletes betekintést nyújtanak weboldalad teljesítményébe és látogatóid viselkedésébe.

A jelentéseket a Must‑Have Analytics → Reports menüpontban érheted el. Minden jelentés támogatja a dátumtartomány szerinti szűrést, a keresést, a rendezést és az exportálást.

Elérhető jelentések

• Oldalmegtekintések elemzése: A leglátogatottabb oldalak egyedi látogatókkal és visszafordulási arányokkal. Szűrj UTM-paraméterek szerint a kampányspecifikus oldalteljesítmény elemzéséhez
• Forgalmi források: Honnan érkeznek a látogatók (közvetlen, organikus, hivatkozási, közösségi, kampány). Szűrj UTM-paraméterek, célok és események szerint a konverziós útvonalak elemzéséhez
• Keresési statisztikák: A weboldalon belüli keresések kifejezései és találatai
• Eszközmegoszlás: Eszköztípus, böngésző és operációs rendszer szerinti bontás (Device, Browser és OS fül). Szűrj UTM-paraméterek szerint az eszközök kampányokon átívelő teljesítményének összehasonlításához
• Országjelentés: Földrajzi megoszlás konverziós arányokkal. Szűrj UTM-paraméterek, célok és események szerint a földrajzilag célzott kampányok elemzéséhez
• Érkezési oldalak: Az első oldalak, amelyeket a látogatók érkezéskor látnak. Szűrj UTM-paraméterek, célok és események szerint az érkezési oldalak teljesítményének optimalizálásához
• Kilépési oldalak: Az utolsó oldalak, mielőtt a látogatók távoznak. Szűrj UTM-paraméterek, célok és események szerint a lemorzsolódási pontok azonosításához
• UTM-kampányok: A kampányteljesítmény nyomon követése átfogó szűrési lehetőségekkel. Szűrj konkrét célokra és eseményekre a kampányok konverziós hatékonyságának méréséhez
• Botforgalom: A bottevékenységek és -minták elemzése. Szűrj UTM-paraméterek alapján a kampányokon belüli botviselkedés azonosításához
• Visszafordulási arány: Optimalizálást igénylő, magas visszafordulási arányú oldalak. Szűrj UTM-paraméterek, célok és események alapján a célzott elemzéshez
• Web Vitals: Az oldalbetöltési teljesítmény elemzése (Core Web Vitals). Szűrj UTM-paraméterek alapján a kampányok teljesítményének összehasonlításához
• Munkamenetek és Célok: a munkamenetek listája részletekkel és mérőszámokkal; a célteljesítések és a konverziók

WooCommerce-jelentések (ha a WooCommerce aktív)

• Értékesítési trendek: Bevételi és rendelési trendek időbeli alakulása — előfizetési mutatókkal és rendeléstípus-szűrővel, ha a WooCommerce Subscriptions aktív (lásd alább)
• Legnépszerűbb termékek: A legkelendőbb termékek bevétel és eladott darabszám alapján
• Termékmegtekintés–vásárlás arány: Konverziós arányok a termékmegtekintésektől a vásárlásokig
• Elhagyott kosarak: A kosárelhagyások elemzése a kosarak értékével együtt
• Kuponhasználat: A kuponok teljesítményének és a kedvezményeknek az elemzése
• Sikertelen rendelések: Sikertelen fizetési kísérletek és kiesett bevétel
• Visszatérítések: Visszatérítési arányok és összegek termék vagy időszak szerint
• Ügyfélérték: Az ügyfelek értéke a kiválasztott időszakban
• Várható ismétlődő bevétel (WooCommerce Subscriptions esetén): az aktív előfizetésekből várható ismétlődő bevétel

Előfizetési mutatók (ha a WooCommerce Subscriptions aktív)

Ha a WooCommerce Subscriptions aktív, a Sales Trends jelentés négy előfizetési csempével egészül ki az Income, Orders és Coupons kártyák mellett:

• MRR: A kiválasztott időszak végén nyilvántartott havi ismétlődő bevétel. Az eltérő számlázási ütemezésű előfizetések havi összegre vannak normalizálva — egy éves előfizetés a teljes összegének egy tizenkettedével járul hozzá.
• Új MRR: Az időszak során szerzett ismétlődő bevétel (az ebben az időszakban indult előfizetések)
• Elvesztett MRR: Az időszak során elvesztett ismétlődő bevétel (az ebben az időszakban lemondott vagy megszűnt előfizetések)
• ARPU: Az időszak bevétele egyedi fizető ügyfelenként. Ez az egyszeri vásárlókat is tartalmazza — az előfizetőkre vonatkozó értékhez használd a rendeléstípus-szűrővel együtt.

Rendeléstípus-szűrő: A Sales Trends jelentés szűrhető új előfizetési rendelésekre (előfizetést létrehozó rendelések), megújítási rendelésekre vagy egyszeri rendelésekre. A szűrő a jelentés minden mutatójára — így az értékesítésekre, a kuponokra és a visszatérítésekre is —, valamint az entitásexportokra is érvényes.

Jó tudni: A korábbi MRR az előfizetési ütemezés dátumaiból kerül rekonstruálásra, ezért egy felfüggesztett, majd később újraaktivált előfizetés folyamatosan aktívként jelenik meg. A több pénznemet használó áruházakban az összegek pénznemátváltás nélkül adódnak össze. Az elvesztett MRR pénzösszegként, nem pedig lemorzsolódási arányként jelenik meg.

Jelentések használata

Válassz dátumtartományt a dátumválasztóval. Válassz az előre beállított lehetőségek közül (Today, Yesterday, Last 7 days, Last 30 days stb.), vagy adj meg egyéni tartományt.

Használd a keresőmezőt az eredmények szűréséhez. Kereshetsz például konkrét oldal-URL-ekre vagy forgalmi források nevére.

Kattints bármelyik oszlopfejlécre az adott oszlop szerinti rendezéshez. Kattints rá újra a rendezési sorrend megfordításához.

A jelentések alapértelmezés szerint oldalanként 20 sorra vannak bontva. A navigáláshoz használd a Previous/Next gombokat, vagy módosítsd az oldalankénti sorok számát a legördülő választóban.

Oszlopösszesítés: A kiválasztott oszlopok esetében az összeg vagy az átlag az oszlop tetején jelenik meg. Ez gyors áttekintést nyújt az összesített értékekről (pl. teljes bevétel, összes oldalmegtekintés) és az átlagokról (pl. átlagos rendelési érték, oldalon töltött átlagos idő).

Diagramok: Egyes jelentések vizuális diagramokat tartalmaznak a táblázatos adatok felett, hogy gyorsan felismerhesd a trendeket és mintákat. A Sales Trends például vonaldiagramon jeleníti meg a bevétel időbeli alakulását.

Jelentések exportálása

Minden jelentés három formátumban exportálható:

• CSV: Univerzális formátum Excelhez, Google Táblázatokhoz vagy bármilyen táblázatkezelő eszközhöz
• Excel (XLSX): Natív Excel-formátum formázással és megfelelő oszloptípusokkal
• PDF: Professzionális jelentések diagramokkal és táblázatokkal, megosztáshoz

Kattints az Export gombra, válaszd ki a formátumot, és a fájl azonnal letöltődik. Az export minden szűrt adatot tartalmaz (figyelembe véve a keresési és dátumszűrőket).

Célok

A célok lehetővé teszik a konverziók meghatározását és automatikus nyomon követését. Állíts be célokat vásárlásokhoz, regisztrációkhoz, letöltésekhez vagy bármely más értékes művelethez a weboldaladon.

Cél létrehozása

Lépj a Must‑Have Analytics → Goals menüpontra, és kattints az Add New Goal gombra.

Cél neve: Adj beszédes nevet a célodnak (pl. „Purchase Complete”, „Newsletter Signup”, „Free Trial Started”).

Célérték: Opcionális pénzbeli érték, amely a konverzió értékét jelzi (pl. 99,99 $ egy termék megvásárlásáért, 50 $ egy érdeklődő becsült értékeként). Hagyd üresen, ha nincs konkrét érték.

Egyedi cél: Ha bekapcsolod, a cél munkamenetenként csak egyszer teljesülhet. Olyan műveletekhez használd, amelyeket egy látogatás során nem szabad kétszer beszámítani.

Állapot: Active vagy Inactive. Az Inactive célok nem teljesülnek, de az adataik továbbra is láthatók a jelentésekben.

Feltételek hozzáadása

A feltételek határozzák meg, hogy mikor teljesül egy cél. A Goal Editor az oldalsávban, kategóriák szerint rendezve jeleníti meg az elérhető feltétel-összetevőket.

Feltétel hozzáadása: Húzz egy összetevőt az oldalsávról a feltételek területére, vagy kattints duplán egy összetevőre az azonnali hozzáadáshoz.

Elérhető feltételtípusok

Tartalmi feltételek:

• Meglátogatott URL: Oldal-URL-ek egyeztetése operátorokkal (egyenlő, tartalmazza, ezzel kezdődik, ezzel végződik, regex)
• Hivatkozó: Hivatkozó URL-ek egyeztetése a forgalmi források követéséhez
• Érkezési oldal: Egy adott belépési oldal URL-je
• Látható elem: CSS-szelektor a látható elemek észleléséhez
• Médialejátszás: Videó- és hanglejátszási események követése

Felhasználói feltételek:

• Visszatérő látogató: Új vagy visszatérő látogató
• Bejelentkezett felhasználó: WordPress-felhasználó bejelentkezési állapota vagy meghatározott szerepkörei
• Ország: Földrajzi célzás (országok kiválasztása a listából)
• Eszköztípus: Asztali számítógép, mobil vagy táblagép
• Operációs rendszer: Operációs rendszer (Windows, macOS, iOS, Android, Linux stb.)
• User Agent: A böngésző user agent karakterláncának egyeztetése

Aktivitási feltételek:

• Görgetési százalék: Az oldalon végiggörgetett rész százalékos aránya
• Elemre kattintás: CSS-szelektor a kattintott elemhez
• Űrlap-interakció: Űrlap beküldése vagy interakció egy mezővel
• Oldalon töltött idő: Az aktuális oldalon töltött másodpercek minimális száma
• Weboldalon töltött idő: A munkamenet teljes időtartama másodpercben
• Meglátogatott oldalak: A munkamenetben megtekintett oldalak száma

Speciális feltételek:

• WordPress-művelet: Egyéni WordPress hook/művelet aktiválása

WooCommerce-feltételek (ha a WooCommerce aktív):

• Kosárba helyezés: Termék került a kosárba. Szűrhető meghatározott termékek, illetve minimális vagy maximális érték alapján. Egy feltételen belül: VAGY kapcsolat a termékek között (bármelyik kiválasztott termék aktiválja), ÉS kapcsolat az értékkorlátok között (ha meg vannak adva, teljesíteni kell a minimumot/maximumot).
• Pénztár megkezdése: Elindult a fizetési folyamat
• Fizetés: A vásárlás befejeződött. Szűrhető termékek vagy rendelési érték alapján. Ugyanaz a VAGY/ÉS logika érvényes, mint a Kosárba helyezésnél.
• Elhagyott kosár: A kosarat vásárlás nélkül elhagyták
• Kupon hozzáadva: Kuponkódot alkalmaztak a kosárra
• Kupon felhasználva: A rendelést kuponnal fejezték be
• Sikertelen rendelés: A fizetés sikertelen volt
• Fizetési adatok hozzáadása: Megadták a fizetési módot

Feltétellogika (csak ÉS)

Fontos: A feltételek kiértékelése MINDIG ÉS logikával történik. A cél eléréséhez minden feltételnek teljesülnie kell.

Ha 3 feltételt adsz hozzá (például az URL tartalmazza a „/thank-you” kifejezést + az ország „United States” + az eszköz „Mobile”), a látogatónak MINDHÁROM feltételt teljesítenie kell.

VAGY logika a feltételeken belül: Egyes feltételek több értéket is támogatnak VAGY logikával. Például:

• Országfeltétel több országgal: Látogató az USA-ból VAGY Kanadából VAGY az Egyesült Királyságból (bármelyik kiválasztott országból)
• WooCommerce-fizetés termékekkel: A termék VAGY B termék VAGY C termék (bármelyik kiválasztott termék)

ÉS logika a feltételeken belül: Egyes feltételek több feltételtípust kombinálnak ÉS logikával. Például:

• WooCommerce-fizetés termékekkel ÉS minimális értékkel: (A termék VAGY B termék) ÉS (Rendelési érték >= $50)

Célok törlése és deaktiválása

Deaktiválás: Állítsd a cél állapotát Inactive értékre, hogy az adatok elvesztése nélkül szüneteltesd a követést. A rendszer nem rögzít több elérést, de a korábbi adatok megmaradnak.

Törlés: Kattints a Delete gombra a cél végleges eltávolításához. Ez nem vonható vissza, és minden korábbi elérési adat elvész.

Konverziós API integrációja

Kapcsold össze a célokat a hirdetési platformok konverziós eseményeivel a szerveroldali követéshez. Egy cél elérésekor a bővítmény automatikusan elküldi az eseményt a Meta, a TikTok vagy a Google Ads számára.

Facebook Event Name és TikTok Event Name: írd be az elküldendő esemény nevét (például Purchase, Lead, CompleteRegistration; a TikToknál csak betűk, számok, aláhúzásjelek és kötőjelek használhatók, szóköz nem).

Google Conversion Action Name (case sensitive): Add meg a Google Ads konverziós műveletének pontos nevét. A névnek pontosan egyeznie kell a Google Ads konverziós műveletének nevével (a kis- és nagybetűk megkülönböztetésével).

Fontos: A konverziós nevek egyeztetésének szabályai:

• Facebook és TikTok: Az eseménynév szabadon megadható. Ahol van illő szabványos esemény, használd a platform szabványos eseménynevét.
• Google Ads: Add meg pontosan úgy a konverziós művelet nevét, ahogy a Google Ads rendszerében megjelenik. A név megkülönbözteti a kis- és nagybetűket, és a követés működéséhez pontosan egyeznie kell.

A Meta, a TikTok és a Google Ads API-hitelesítő adatainak részletes beállítási útmutatóját lásd lent, a Konverziós API-k szakaszban. Az API-kulcsokat a Beállítások → Meta / TikTok / Google lapokon is konfigurálhatod.

Ez lehetővé teszi a szerveroldali konverziókövetést, amely megkerüli a hirdetésblokkolókat és az iOS korlátozásait, így pontos hozzárendelési adatokat biztosít a fizetett kampányaidhoz.

Visszamenőleges célok

Egy újonnan létrehozott célt a Must‑Have Analytics → Tools → Retrospective Goals menüpontban alkalmazhatsz a korábbi adatokra. Válaszd ki a célt és a dátumtartományt, majd kattints az Apply Goals gombra; az eszköz kiírja, hány látogatást dolgozott fel, és hány cél teljesült.

Korlátok: a WordPress-művelet és a bejelentkezett felhasználó feltételek visszamenőleg nem alkalmazhatók. A kattintás, a látható elem, a médialejátszás és az űrlap feltételek csak akkor egyeztethetők, ha egy másik cél már követte ugyanazokat az elemeket. A kizárások (például a kizárt felhasználók vagy IP-címek) nem vonatkoznak a korábbi adatokra.

A célok teljesítményének megtekintése

A Célok oldal az összes célt megjeleníti az elérések számával és az állapotjelzőkkel együtt. Kattints bármelyik célra a részletes teljesítmény megtekintéséhez:

• Elérési idővonal (napi/heti/havi trendek)
• Konverziós arány (a célt elérő munkamenetek %-a)
• Összes létrehozott érték
• Forgalmi forrás, eszköztípus és ország szerinti bontás
• Legutóbbi teljesítések a látogatók adataival

Korrelációelemzés

A korrelációelemzés a szegmensek statisztikai vizsgálatával segít feltárni, hogy mely látogatói jellemzők korrelálnak magasabb konverziós aránnyal.

Két arány összehasonlítására szolgáló z‑próbákat használ azon szegmensek azonosítására, amelyek az átlagnál jelentősen jobban vagy rosszabbul konvertálnak, így segít optimalizálni a marketingköltést és a célzást.

Korrelációelemzés futtatása

Lépj a Must‑Have Analytics → Tools → Correlations Tool menüpontra.

Válaszd ki az elemezni kívánt dátumtartományt. A hosszabb időszakok (30+ nap) statisztikailag megbízhatóbb eredményeket biztosítanak.

Válaszd ki az optimalizálni kívánt célt (pl. „Purchase Complete”, „Newsletter Signup”). Az elemzés megmutatja, hogy mely szegmensek érik el gyakrabban ezt a célt.

Kattints a Run Analysis gombra. A bővítmény több dimenzióban kiszámítja az egyes szegmensek konverziós arányát, majd összehasonlítja azokat az általános alapértékkel.

Elemzett dimenziók

Az elemzés egyszerre 8 dimenziót vizsgál:

• Forgalmi forrás: Közvetlen, organikus, hivatkozó, közösségi, kampány
• Ország: Földrajzi eloszlás
• Eszköz: Asztali gép, mobil vagy táblagép
• Céloldal: A weboldalad belépési pontjai
• Napszak: Óránkénti bontás (0-23)
• A hét napja: Hétfőtől vasárnapig
• A hónap napja: 1-jétől 31-éig
• Hónap: Januártól decemberig

Az eredmények és mérőszámok értelmezése

Az eredmények minden dimenziónál vízszintes sávdiagramokon jelennek meg, amelyek a Δ százalékpontot (az alapértéktől való eltérést) mutatják.

Megjelenített mérőszámok:

• Δpp (százalékpontos eltérés): A szegmens konverziós aránya és az általános átlag közötti különbség. Példa: ha a szegmens 5%-os, az átlag pedig 3%-os aránnyal konvertál, akkor Δpp = +2.0
• Lift: A relatív teljesítményt mutató szorzó. Példa: az 1.67 az átlagnál 67%-kal jobb, míg a 0.50 50%-kal rosszabb teljesítményt jelent
• All: Az ebbe a szegmensbe tartozó összes munkamenet százalékos aránya és száma
• Converted: Az ebbe a szegmensbe tartozó célteljesítések százalékos aránya és száma
• z (z‑érték): A statisztikai szignifikancia mérőszáma. A magasabb abszolút értékek erősebb bizonyítékot jeleznek
• p (p‑érték): Annak valószínűsége, hogy a különbség a véletlennek köszönhető. Az alacsonyabb értékek erősebb bizonyítékot jeleznek (a p < 0.05 általában szignifikáns)
• FDR (téves felfedezési arány): Többszörös összehasonlításokkal korrigált p‑érték. Konzervatívabb, mint a nyers p‑érték

Szignifikanciajelzők:

• Significant: A különbség statisztikailag szignifikáns (általában p < 0.05 vagy FDR < 0.05). Nagy bizonyossággal valós mintázatról van szó, nem pedig véletlen zajról
• Approximate: A mintaméret kicsi, ezért az eredmények kevésbé megbízhatók. Kezeld őket óvatosan; a nagyobb bizonyossághoz gyűjts több adatot

Színkódolás:

• Zöld sávok: A szegmens az átlagnál jobban konvertál (Δpp > 0)
• Piros sávok: A szegmens az átlagnál rosszabbul konvertál (Δpp < 0)

Példa az értelmezésre: „A Google felől érkező forgalomnál Δpp = +2.3, Lift = 1.82, z = 4.5, p = 0.0001, Significant”

Ez azt jelenti, hogy a Google felől érkező forgalom konverziós aránya 2,3 százalékponttal magasabb az átlagnál (82%-kal jobb teljesítmény), nagyon magas statisztikai megbízhatóság mellett (p = 0.0001).

A korrelációs felismerések használata

Költségkeret elosztása: Növeld a ráfordítást a jelentős pozitív növekedést mutató forgalmi forrásoknál és országoknál.

Időzítés optimalizálása: A kampányokat a magas konverziót hozó napszakokra vagy napokra időzítsd.

Céloldalak fejlesztése: Optimalizáld vagy távolítsd el a jelentős negatív korrelációt mutató céloldalakat.

Eszköz szerinti célzás: Módosítsd az ajánlatokat vagy a kreatívokat a jobban teljesítő eszköztípusokhoz.

A túlzott optimalizálás elkerülése: Hagyd figyelmen kívül az „Approximate” jelölésű szegmenseket, hacsak nem tudod növelni a mintaméretet. Összpontosíts a megfelelő adatmennyiséggel rendelkező, szignifikáns eredményekre.

Sankey-folyamatábra

A Sankey-diagram a látogatók teljes útját szemlélteti a forgalmi forrástól az oldalakon át egészen a célkonverzióig.

Megmutatja, hogyan érkeznek a látogatók (forgalmi források), mely oldalakat keresik fel (sorrendben), hol morzsolódnak le, és mely útvonalak vezetnek konverzióhoz.

Sankey-diagram létrehozása

Lépj a Must‑Have Analytics → Tools → Sankey Diagram menüpontra.

Válaszd ki a dátumtartományt (az elmúlt 7 nap, 30 nap vagy egyéni tartomány).

Válaszd ki azt a célt, amelynek a konverzióit nyomon szeretnéd követni.

Állítsd be az URL-csoportosítási lehetőségeket. Alapértelmezés szerint a hasonló URL-ek egy csoportba kerülnek (pl. minden termékoldal a „Product” csoportba).

Személyre szabhatod a csoportosítási szabályokat: csoportosítás URL-minta (regex) alapján, csoportosítás oldaltípus szerint, teljes URL-ek megtartása bizonyos oldalaknál.

Kattints a Generate Diagram gombra. Megjelenik az interaktív folyamatokat tartalmazó vizualizáció.

A diagram értelmezése

A diagram balról jobbra halad: Forgalmi forrás → Első oldal → Második oldal → ... → Célkonverzió.

A folyamat vastagsága a mennyiséget jelzi. A szélesebb folyamatok azt jelentik, hogy több látogató haladt végig az adott útvonalon.

Vidd az egérmutatót bármelyik csomópont (oldal vagy forrás) fölé, hogy lásd az összes látogatót, a konverziós arányt, a lemorzsolódási arányt és a leggyakoribb következő lépéseket.

Kattints bármelyik útvonalra, hogy a diagramot az azt tartalmazó útvonalakra szűrd.

A Sankey Insights használata

Azonosítsd azokat a lemorzsolódási pontokat, ahol a látogatók gyakran konverzió nélkül távoznak. Optimalizáld ezeket az oldalakat, hogy csökkentsd a súrlódást.

Fedezd fel a váratlan konverziós útvonalakat. A látogatók néha nem nyilvánvaló útvonalakon konvertálnak, amelyeket szintén optimalizálhatsz.

Hasonlítsd össze a forgalmi források teljesítményét. Nézd meg, mely forrásokból érkeznek olyan látogatók, akik hatékonyan navigálnak, és melyekből olyanok, akik gyorsan visszafordulnak.

UTM-paraméterek és URL-készítő

Az UTM-paraméterek olyan címkék, amelyeket az URL-ekhez adhatsz a forgalom forrásának, médiumának és kampányának nyomon követéséhez.

Segítségükkel mérheted az egyes marketingkampányok és -csatornák hatékonyságát.

Mik azok az UTM-paraméterek?

Az UTM-paraméterek az URL-ek lekérdezési karakterláncához adott elemek. Például: https://yoursite.com/?utm_source=facebook&utm_medium=social&utm_campaign=spring_sale

Az öt szabványos UTM-paraméter:

• utm_source: Honnan érkezik a forgalom (pl. google, facebook, newsletter)
• utm_medium: Marketingmédium (pl. cpc, social, email, referral)
• utm_campaign: Az adott kampány neve (pl. spring_sale, product_launch)
• utm_term: Fizetett keresési kulcsszavak (opcionális, PPC-kampányokhoz)
• utm_content: Hasonló tartalmak megkülönböztetése (pl. banner_ad, text_link)

Az URL-készítő használata

Lépj a Must‑Have Analytics → Eszközök → URL-készítő menüpontra.

Add meg a weboldalad URL-jét (annak az oldalnak a címét, amelyre hivatkozni szeretnél).

Töltsd ki az UTM-paramétereket: kampány forrása (kötelező), kampány médiummal (kötelező), kampány neve (kötelező), kampány kifejezése (opcionális), kampány tartalma (opcionális).

A készítő automatikusan létrehozza a címkézett URL-t. Másold ki, és használd a marketinganyagaidban (e-mailekben, hirdetésekben, közösségi bejegyzésekben stb.).

A kampányteljesítmény nyomon követése

Az UTM-kampányok teljesítményét a Must‑Have Analytics → Jelentések → UTM-kampányok menüpontban tekintheted meg.

A jelentés a következőket mutatja: kampány neve, összes látogatás, egyedi látogatók, oldalmegtekintések látogatásonként, konverziós arány, konverziók összértéke.

Hasonlítsd össze a kampányokat, hogy lásd, mely marketingtevékenységek hozzák a legjobb eredményeket.

Konverziós API-k

A szerveroldali konverziókövetés közvetlenül a WordPress-szerveredről küldi el a konverziós eseményeket a Meta (Facebook) és a TikTok számára.

Ez megkerüli a hirdetésblokkolókat, az iOS adatvédelmi korlátozásait és a böngészők követésvédelmét, így pontos hozzárendelést biztosít a hirdetési kampányaidhoz.

Meta (Facebook) Conversions API

1. lépés: Szerezd meg a Pixel ID-t

1. Nyisd meg a Facebook Events Manager felületét
2. Válaszd ki a pixeledet, vagy hozz létre egy újat
3. Másold ki a Pixel ID-t (numerikus, általában 15-16 számjegyű)

2. lépés: Hozz létre hozzáférési tokent

1. Az Events Manager felületén lépj a Settings → Conversions API részhez
2. Kattints a Generate Access Token gombra
3. Másold ki a tokent (az „EAA...” karakterekkel kezdődik)
4. Tárold biztonságosan – csak egyszer fogod látni

3. lépés: Állítsd be a bővítményben

1. Kapcsold be a Conversion tracking beállítást a Settings → General Settings lapon, majd nyisd meg a Must‑Have Analytics → Settings → Meta lapot
2. Illeszd be a Pixel ID-t a Meta Pixel ID mezőbe
3. Illeszd be a hozzáférési tokent a Meta Conversion API mezőbe
4. Válaszd ki a követni kívánt eseményeket (PageView, Purchase stb.)
5. Minden módosított mező mellett kattints az Update changes gombra

4. lépés: Teszteld az integrációt

Kattints a Test Event gombra. A bővítmény tesztkonverziót küld a Meta számára. Az Events Manager → Test Events lapján ellenőrizd, hogy megérkezett-e.

TikTok Events API

1. lépés: Szerezd meg a Pixel ID-t

1. Nyisd meg a TikTok Ads Manager felületét (ads.tiktok.com)
2. Lépj az Assets → Events → Web Events részhez
3. Válaszd ki a pixeledet, vagy hozz létre egy újat
4. Másold ki a Pixel ID-t

2. lépés: Hozz létre hozzáférési tokent

1. Ugyanennek a pixelnek a beállításaiban lépj az Events API lapra
2. Kattints a Generate Access Token gombra
3. Másold ki a tokent

3. lépés: Állítsd be a bővítményben

1. Kapcsold be a Conversion tracking beállítást a Settings → General Settings lapon, majd nyisd meg a Must‑Have Analytics → Settings → TikTok lapot
2. Illeszd be a Pixel ID-t a TikTok Pixel ID mezőbe
3. Illeszd be a hozzáférési tokent a TikTok Events API mezőbe
4. Válaszd ki a követni kívánt eseményeket
5. Minden módosított mező mellett kattints az Update changes gombra

4. lépés: Teszteld az integrációt

Kattints a Test Event gombra. A TikTok Events Manager → Test Events részében ellenőrizd, hogy megérkezett-e az esemény.

Google offline konverziók

A Google Ads más megközelítést használ. A konverziós adatokat exportálod a Must‑Have Analytics szolgáltatásból, majd manuálisan vagy API-n keresztül feltöltöd őket a Google Ads rendszerébe.

1. lépés: Rendeld hozzá a konverzióidat

1. Kapcsold be a Conversion tracking beállítást a Settings → General Settings lapon, majd nyisd meg a Google lapot
2. A Google Ads conversion map részben add meg minden Must‑Have Analytics-eseményhez (Purchase, Sign Up, Lead, Begin Checkout, Add To Cart, View Item, Contact) a Google Ads konverziós műveletének pontos nevét. Ha egy mezőt üresen hagysz, az az esemény nem kerül bele a CSV-fájlba
3. Céloknál a nevet a célszerkesztő Google Conversion Action Name (case sensitive) mezőjében add meg
4. Fontos: A konverziós művelet nevének pontosan meg kell egyeznie (a kis- és nagybetűket is figyelembe véve) a Google Ads-fiókodban szereplő névvel

2. lépés: Exportáld a konverziós adatokat

1. Lépj a Must‑Have Analytics → Tools → Google Conversion Export menüpontra
2. Válaszd ki a dátumtartományt
3. Kattints a Download CSV gombra

3. lépés: Töltsd fel a Google Adsbe

1. Lépj a Google Ads → Tools → Conversions → Uploads menüpontra
2. Kattints a + gombra, és válaszd az Import file lehetőséget
3. Válaszd ki a konverziós műveletet
4. Töltsd fel a Must‑Have Analyticsből letöltött CSV-fájlt
5. Ellenőrizd, majd alkalmazd a feltöltést

A Google a bővítmény által rögzített GCLID (Google Click ID) alapján párosítja a konverziókat.

Exportálás

A Must‑Have Analytics rugalmas exportálási lehetőségeket kínál közvetlenül a jelentésekben, a jelentésadatokhoz és a célközönséglistákhoz egyaránt.

Jelentések exportálása (CSV, Excel, PDF)

Minden jelentés vezérlői között megtalálod az Export gombot. Kattints rá, hogy az aktuális jelentés adatait a választott formátumban töltsd le:

• CSV: Univerzális formátum, amely az Excellel, a Google Táblázatokkal és bármely táblázatkezelővel kompatibilis
• Excel (XLSX): Natív Excel-formátum megfelelő formázással, oszloptípusokkal és stílusokkal
• PDF: Professzionális dokumentumformátum prezentációkhoz és megosztáshoz

Az exportálás figyelembe veszi az aktuális szűrőket: a dátumtartomány, a keresési kifejezések és minden alkalmazott szűrő érvényes az exportra is.

Remarketing- és e-mail-listák exportálása

Az entitásokat (e-mail-címet vagy telefonszámot tartalmazó látogatói profilokat) követő jelentések további exportálási lehetőségeket kínálnak remarketinghez és e-mail-marketinghez.

Entitásexportot támogató jelentések:

• Munkamenetek jelentés
• Célok jelentés
• WooCommerce – Értékesítési trendek
• WooCommerce – Elhagyott kosarak
• WooCommerce – Sikertelen rendelések
• WooCommerce – Visszatérítések

Ezekben a jelentésekben további exportgombok jelennek meg:

Remarketing-export: Megfelelően formázott célközönségfájlokat készít a Meta (Facebook/Instagram), a TikTok vagy a Google Ads számára. Az e-mail-címeket és a telefonszámokat a hirdetési platformok előírásainak megfelelően automatikusan SHA‑256 hash-sel látja el. Az exportált fájlt töltsd fel a hirdetési platformod közönségkezelőjébe egyéni vagy hasonmás célközönségek létrehozásához.

E-mail-lista exportálása: Egyszerű kapcsolattartási adatokat (e-mail-cím, keresztnév, vezetéknév) exportál olyan e-mail-marketing platformokhoz, mint a Mailchimp, a ConvertKit vagy az ActiveCampaign.

Mindkét exporttípus figyelembe veszi a jelentés aktuális szűrőit, így a célközönséget dátumtartomány, elért célok, vásárlási viselkedés vagy a jelentésben elérhető bármely más szempont szerint szegmentálhatod.

Beállítások

Állítsd be a Must‑Have Analyticset az adatvédelmi követelményeidnek, a követési preferenciáidnak és az integrációs igényeidnek megfelelően.

A beállításokat a Must‑Have Analytics → Settings menüpontban éred el. A legtöbb beállítás módosításkor automatikusan mentődik; a szöveges mezők az Update changes gombbal menthetők. Fülek: General Settings, Exclusions, Google, Meta és TikTok (ez a három akkor jelenik meg, ha a Conversion tracking be van kapcsolva), System és Mobile app.

A licenc állapota, valamint a Connect / Disconnect gombok a System fül tetején találhatók.

Általános fül

Követési süti: Az _mhanalytics first‑party süti be- vagy kikapcsolása. Bekapcsolt állapotban a bővítmény pontosan követi a visszatérő látogatókat a munkamenetek között.

Kikapcsolt állapotban helyette eszközujjlenyomat-alapú azonosítás működik (kevésbé pontos, de adatvédelmi szempontból kedvezőbb). A legtöbb weboldalon érdemes bekapcsolva hagyni a pontos analitika érdekében.

Profilalkotás: Azt szabályozza, hogy a bővítmény gyűjt-e személyazonosításra alkalmas adatokat (e-mail-cím, telefonszám, nevek). Bekapcsolt állapotban részletes látogatói profilokat kapsz az űrlapokból és a pénztárfolyamatokból.

Kikapcsolt állapotban csak névtelen analitikai adatok gyűlnek, és minden IP-cím anonimizálva van.

GDPR-megfelelés: Bár a profilalkotás kapcsolója látható a felületen, csak a felhasználó hozzájárulásának megszerzése után szabad bekapcsolni. Ha a weboldalad a GDPR hatálya alá tartozik, a profilalkotást a felhasználói hozzájárulástól függően érdemes letiltani. A mhanalytics_option_profiling szűrőt használó kódpéldát a „Hogyan működik?” szakaszban találod.

Konverziókövetés: Megjeleníti a Google, a Meta és a TikTok fület, ahol a Meta és a TikTok szerveroldali konverziós API-jait, valamint a Google Ads konverziós leképezését állíthatod be.

Ha nem használsz fizetett hirdetéseket, hagyd kikapcsolva. Kapcsold be a konverziós API-integrációk használatához.

Pénznem: Válaszd ki a legördülő listából a weboldalad pénznemét, amellyel a pénzbeli értékek a jelentésekben és a céloknál megjelennek.

A gyakori pénznemek közül választhatsz (USD, EUR, GBP, CAD, AUD stb.). A bővítmény nem vált át pénznemet, csak a megjelenítést formázza.

E-mail-összefoglaló: A megadott címekre küldött automatikus e-mail-jelentések. Gyakoriság: Disabled (nincs e-mail), Daily, Weekly vagy Monthly.

Az összefoglalók tartalma: összes oldalmegtekintés, egyedi látogatók, legnépszerűbb oldalak, legfontosabb forgalmi források, célteljesítések. A kiküldést naponta egyszer a WordPress ütemezett feladatai (WP‑Cron) végzik, ezért a pontos időpont attól függ, mikor aktiváltad a bővítményt, és mekkora a weboldal forgalma. A heti összefoglaló hétfőnként, a havi minden hónap 1-jén megy ki, és mindegyik csak a lezárult napokat tartalmazza.

E-mail-címek: Az e-mail-összefoglalók címzettjeinek vesszővel elválasztott listája. Alapértelmezés szerint a weboldal adminisztrátori e‑mail-címe. Csak az érvényes e-mail-címeket használja a rendszer; az érvénytelenek figyelmeztetés nélkül kimaradnak.

Példa: [email protected], [email protected], [email protected]

Botadatok összesítése (alapértelmezés szerint bekapcsolva): a botlátogatásokat a bővítmény kiszűri, és csak az összesített botadatokat tartja meg a jelentésekhez, ami tárhelyet takarít meg. Kikapcsolt állapotban a botlátogatásokat a normál látogatásokhoz hasonlóan követi.

Nyers adatok megőrzése: Meddig őrizze meg a rendszer a részletes analitikai adatokat (látogatások, események, munkamenetek). Az alapértelmezés 24 hónap (2 év).

Lehetőségek: Forever (minden adat megőrzése), 1, 3, 6, 12, 24, 36 vagy 48 hónap. Ezt követően az adatok automatikusan törlődnek, a GDPR adattakarékossági követelményeinek megfelelően.

Kizárások fül

Felhasználók kizárása: Válaszd ki azokat a WordPress-felhasználókat, akiknek a látogatásait nem szeretnéd követni. Hasznos az adminisztrátori tevékenység kizárásához az analitikából.

Bevált gyakorlat: zárd ki az összes adminisztrátort, hogy tiszta látogatói adatokat kapj. A legördülő menüből több felhasználót is kiválaszthatsz.

Szerepkörök kizárása: Teljes WordPress felhasználói szerepköröket zárhatsz ki. Ha sok adminisztrátorod van, ez kényelmesebb, mint egyenként kiválasztani a felhasználókat.

Gyakran kizárt szerepkörök: Adminisztrátor, Szerkesztő. A Feliratkozók és a Vásárlók követése általában engedélyezett.

User Agentek kizárása: Letilthatod a követést bizonyos böngészőknél vagy botoknál a User Agent karakterlánc alapján. Soronként egy vagy vesszővel elválasztott mintákat adj meg.

A részleges egyezések is működnek. Példa: a "bot" megadása kizárja a Googlebot, Bingbot stb. forgalmát. Ezzel kiszűrheted a nem kívánt botforgalmat.

IP-címek kizárása: Add meg a kizárandó IP-címeket, soronként egyet. Az IPv4, az IPv6 és a CIDR-jelölés (pl. 192.168.1.0/24) is támogatott.

Országok kizárása: Válaszd ki azokat az országokat, amelyekből érkező látogatásokat nem szeretnéd követni.

Google, Meta és TikTok fül

Akkor látható, ha a Conversion tracking be van kapcsolva (General Settings). Állítsd be a szerveroldali konverziókövetést a Meta (Facebook), a TikTok és a Google Ads számára. Az API-kulcsok és tokenek létrehozásának részletes, lépésenkénti útmutatóiért lásd alább a Konverziós API-k szakaszt.

Meta Pixel ID: A Facebook Pixel ID-d (15‑16 jegyű szám). A Facebook Events Managerben találod.

Meta API Token: A Facebook Conversions API hozzáférési tokenje. "EAA" karakterekkel kezdődik. Tartsd titokban.

Meta által követett események: Válaszd ki, mely eseményeket szeretnéd elküldeni a Facebooknak. Gyakori események: PageView, ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase.

A quickselect gombbal alkalmazhatod a Facebook szabványos eseménykészletét.

TikTok Pixel ID: A TikTok Pixel ID-d a TikTok Ads Managerből.

TikTok API Token: A TikTok Events API hozzáférési tokenje. Tartsd titokban.

TikTok által követett események: Válaszd ki, mely eseményeket szeretnéd elküldeni a TikToknak. Gyakori események: ViewContent, AddToCart, Purchase, InitiateCheckout, CompletePayment.

Google Ads conversion map (Google fül): Rendeld hozzá az analitikai eseményeidet (Purchase, Sign Up, Lead, Begin Checkout, Add To Cart, View Item, Contact) a Google Ads konverziós műveleteinek nevéhez. Add meg a Google Adsben szereplő konverziós művelet pontos nevét (a kis- és nagybetűk számítanak); ha egy mezőt üresen hagysz, az az esemény nem kerül bele a CSV-fájlba. A célokat a célszerkesztőben rendelheted hozzá. Ezt a leképezést a Tools → Google Conversion Export használja.

Rendszer fül

Kezeld az analitikai adatbázisodat, ellenőrizd a tárhelyhasználatot, valamint exportáld vagy töröld az adatokat.

Tárhelyhasználat: Megnézheted, mennyi lemezterületet foglalnak az analitikai adatok. Válassz egy dátumtartományt, majd kattints az Apply gombra az adott időszak tárhelyhasználatának megtekintéséhez.

A táblázat megmutatja az egyes adatbázistáblák (munkamenetek, látogatások, események stb.) tárhelyhasználatát. A teljes tárhelyhasználat alul látható.

Tárhelyhasználati viszonyítási értékek: Engedélyezett profilalkotás mellett 1 000 oldalmegtekintés körülbelül 2‑2,5 MB lemezterületet foglal.

Letiltott profilalkotás mellett (anonimizált IP-címek, személyes adatok nélkül) 1 000 oldalmegtekintés körülbelül 1‑1,5 MB-ot foglal.

Például: havi 100 000 oldalmegtekintés = ~200 MB/hó profilalkotással, ~125 MB/hó profilalkotás nélkül.

Adatok exportálása: Töltsd le az analitikai adatokat SQL-fájlként biztonsági mentéshez vagy költöztetéshez. Válassz dátumtartományt, majd kattints az Export gombra.

Az exportált fájl a kiválasztott időszak összes látogatását, eseményét, munkamenetét és profilalkotási adatát tartalmazza. Importáld egy másik WordPress-weboldalra, vagy őrizd meg biztonsági mentésként.

Adatok importálása: Tölts fel egy korábban exportált SQL-fájlt vagy egy webszerver-hozzáférési naplót (Apache, Nginx vagy LiteSpeed). Támogatott formátumok: .sql (a bővítmény exportjai), .log és .gz (tömörített naplók). Az importálás sorokat szúr be a Must‑Have Analytics tábláiba, ezért előtte készíts biztonsági mentést az adatbázisról.

A bővítmény ellenőrzi és végrehajtja az SQL-utasításokat. A duplikált adatokat automatikusan kihagyja.

Adatok törlése: Véglegesen eltávolíthatod egy adott dátumtartomány analitikai adatait. Válaszd ki a tartományt, majd kattints a Delete gombra.

A törlés előtt meg kell erősítened a műveletet. Ez nem vonható vissza, ezért szükség esetén először exportáld a fontos adatokat.

GDPR & Adatvédelmi megfelelés

A Must‑Have Analytics alapvető szempontként kezeli az adatvédelmet, rugalmas adatgyűjtési módokat és teljes, azonnal használható GDPR-megfelelést kínál.

Sütialapú és süti nélküli követés

Követősütikkel (hozzájárulást igényel):

• A munkamenetek pontos azonosítása több látogatáson keresztül
• Az ugyanahhoz a látogatóhoz tartozó munkamenetek összekapcsolása
• Hosszú távú látogatókövetés és viselkedéselemzés
• A teljes látogatói út követése
• GDPR-követelmény: A követősütik beállítása előtt a felhasználó kifejezett hozzájárulása szükséges

Követősütik nélkül (alapértelmezett mód):

• Anonim, összesített analitikai adatokat gyűjt
• Eszközujjlenyomatot használ a munkamenetek ideiglenes azonosításához
• Rövidebb munkamenet-időtúllépési időszakok
• Adatvédelem-központú megközelítés tartós azonosítók nélkül
• GDPR-megfelelés: Az összesített, anonim, sütik nélküli adatgyűjtéshez általában nincs szükség kifejezett hozzájárulásra

Legfontosabb előny: A bővítmény akkor is folytatja az értékes analitikai adatok gyűjtését, ha a felhasználók elutasítják a sütiket, így mindig teljes rálátásod marad weboldalad teljesítményére.

Látogatói profilalkotás & Hozzájárulási követelmények

Ha a profilalkotás engedélyezve van, a Must‑Have Analytics automatikusan gyűjt azonosításra alkalmas adatokat az űrlapokból, felhasználói regisztrációkból, e-kereskedelmi megrendelésekből és integrációkból.

Munkamenetek összekapcsolása sütik nélkül: A profilalkotás követősütik nélkül is összekapcsolhatja ugyanazon látogató munkameneteit az e-mail-címek, WordPress felhasználói azonosítók, WooCommerce-munkamenetek vagy más Must‑Have bővítményekből származó azonosítók egyeztetésével.

A profilalkotás GDPR-követelményei:

• Jogalap: jogos érdek vagy kifejezett hozzájárulás
• Átláthatóság: egyértelmű tájékoztatás az adatvédelmi szabályzatban
• Felhasználói jogok: hozzáférés, helyesbítés, törlés, hordozhatóság
• Adattakarékosság: csak a szükséges adatokat gyűjtsd
• Célhoz kötöttség: az adatokat csak a meghatározott célokra használd

Fontos: A profilalkotás a GDPR 4. cikkének (4) bekezdése szerint személyes adatok kezelésének minősül. Csak akkor engedélyezd a profilalkotást, ha átfogó adatvédelmi szabályzattal, süti-/hozzájárulás-kezelési megoldással és az érintetti kérelmek kezelésére szolgáló eljárásokkal rendelkezel.

Személyes adatok exportálása a WordPressben

A Must‑Have Analytics zökkenőmentesen integrálódik a WordPress beépített GDPR-eszközeivel.

Amikor egy felhasználó a Eszközök → Személyes adatok exportálása menüponton keresztül kéri a személyes adatait, a bővítmény automatikusan mellékeli a következőket:

Entitásadatok: E-mail-címek, telefonszámok, nevek, WordPress felhasználói azonosító, az első és utolsó észlelés dátuma, munkamenetek és oldalmegtekintések teljes száma, országok, eszközök, célteljesítések, konverziós érték.

Munkamenetadatok: Munkamenet-azonosítók, időbélyegek, IP-címek (ha megőrzöd őket), helyadatok, eszközinformációk, böngészőadatok, hivatkozó oldalak, meglátogatott oldalak, teljesített célok.

Az exportálás a WordPress szabványos JSON-formátumában történik, így géppel olvasható és könnyen áttekinthető.

Nincs szükség beállításra — ez a funkció automatikusan működik a WordPress natív exportálóeszközén keresztül.

Személyes adatok törlése a WordPressben

Amikor egy felhasználó az Eszközök → Személyes adatok törlése menüponton keresztül kéri az adatai törlését, a bővítmény két törlési kezelővel automatikusan feldolgozza a kérelmet:

Entitásadatok törlése: Törli az e-mail-címeket, telefonszámokat, neveket és minden profilalkotási adatot. Az entitásrekordot egy új anonim azonosítóval anonimizálja, a munkamenet-társításokat pedig megőrzi, de az anonimizált entitáshoz kapcsolja.

Munkamenetadatok anonimizálása: Anonimizálja az IP-címeket (eltávolítja az utolsó oktettet, például a 192.168.1.123 címből 192.168.1.0 lesz), törli a hivatkozó URL-eket és a lekérdezési karakterláncokat, valamint kiüríti a felhasználói ügynök karakterláncait.

Ami megmarad: Az elemzések pontosságának fenntartása érdekében megmaradnak az összesített statisztikák (oldalmegtekintések, munkamenetek), az eszköztípusokra vonatkozó statisztikák, az országszintű adatok és az anonim célteljesítések.

Fontos: A bővítmény a teljes törlés helyett anonimizálást alkalmaz, hogy megőrizze az összesített statisztikákat, miközben megfelel a GDPR szerinti „elfeledtetéshez való jognak” (17. cikk). Az anonimizálás a törléssel egyenértékűnek minősül, ha az adatok alapján többé nem azonosítható egyetlen személy sem.

Adattárolás és adatok megosztása harmadik felekkel

Minden analitikai adatot a WordPress-szervereden tárolunk:

• Adatbázistáblák a WordPress-adatbázisodban
• Nincsenek külső adatgyűjtő szerverek
• Teljes körű ellenőrzés az adataid felett
• Nincs függőség harmadik fél szolgáltatásaitól
• GDPR-kompatibilis adattárolási hely

Adatok megosztása harmadik felekkel:

• Must‑Have Plugins: Csak a licenckulcsot és a weboldal URL-jét küldi el a licenc ellenőrzéséhez (személyes adatokat nem)
• Meta (Facebook/Instagram): Kivonatolt e-mail-cím/telefonszám és konverziós események — csak akkor, ha kifejezetten engedélyezed és beállítod a konverziókövetést
• TikTok: Kivonatolt e-mail-cím/telefonszám és konverziós események — csak akkor, ha kifejezetten engedélyezed és beállítod a konverziókövetést

Fontos: A konverziók követése a Meta vagy a TikTok felé CSAK akkor történik meg, ha engedélyezed a Beállításokban, megadod az API-hitelesítő adatokat, kiválasztod a követni kívánt konkrét konverziókat, és bekövetkezik egy követett konverzió. A Must‑Have Analytics semmilyen adatot nem továbbít más harmadik félnek.

Adatmegőrzési szabályzatok

Állítsd be az adatmegőrzési időszakot a Beállítások → General → Raw Data Retention menüpontban:

• Örökre (minden adat határozatlan ideig megmarad)
• 1 hónap, 3 hónap, 6 hónap, 12 hónap, 24 hónap, 36 hónap vagy 48 hónap

Az automatikus tisztítás eltávolítja a megőrzési időszaknál régebbi munkameneteket, látogatásokat és eseményeket, valamint a nem hivatkozott URL-eket, felhasználói ügynököket és lekérdezési karakterláncokat.

GDPR-megfelelőségi ellenőrzőlista

Általános követelmények:

• ☑ Az adatvédelmi szabályzat közzé van téve és elérhető
• ☑ Az adatvédelmi szabályzat tartalmazza a Must‑Have Analytics használatára vonatkozó tájékoztatást
• ☑ Az adatmegőrzési szabályzat meg van határozva és be van állítva
• ☑ A WordPress személyes adatok kezelésére szolgáló eszközei tesztelve vannak és működnek
• ☑ Az adminisztrátorok képzést kaptak a GDPR-eljárásokról

Ha követősütiket használsz:

• ☑ A sütikhez való hozzájárulást kérő sáv be van állítva
• ☑ A sütikre vonatkozó tájékoztató szerepel az adatvédelmi szabályzatban
• ☑ Elérhető a letiltási lehetőség
• ☑ A hozzájárulás előtt nem kerülnek sütik beállításra
• ☑ A hozzájárulás rögzítve van és auditálható

Ha profilalkotást használsz:

• ☑ A jogalap meg van határozva (hozzájárulás vagy jogos érdek)
• ☑ Az adatvédelmi szabályzat tartalmazza a profilalkotásra vonatkozó tájékoztatást
• ☑ Az adattakarékosság meg van valósítva
• ☑ A felhasználói jogok érvényesítésére szolgáló eljárások dokumentálva vannak
• ☑ Az adatmegőrzés be van állítva

Ha konverziós API-kat használsz:

• ☑ Az adatvédelmi szabályzat megemlíti a Meta/TikTok felé történő adatmegosztást
• ☑ A követés előtt megtörténik a felhasználói hozzájárulás beszerzése
• ☑ Adatfeldolgozási megállapodás van érvényben a Meta/TikTok szolgáltatóval
• ☑ Az API-hitelesítő adatok biztonságosan vannak tárolva
• ☑ Ellenőrizd, hogy az események megfelelően működnek-e

Ne feledd: a GDPR-megfelelőség nemcsak az általad használt eszközökről szól, hanem arról is, hogyan használod őket. Mindig egyeztess jogi szakértővel, hogy az adott megvalósítás megfeleljen minden vonatkozó előírásnak.

AI-ügynökök & MCP

A Must‑Have Analytics a teljes jelentéskészítő motorját elérhetővé teszi az AI-ügynökök számára. Minden jelentés, munkamenetlista és vezérlőpulti összefoglaló típusdefinícióval ellátott, jogosultság-ellenőrzött képességként érhető el a WordPress Abilities API-ra építve, az MCP Adapter bővítménnyel pedig egy dedikált MCP-szerver eszközeiként is, így az olyan asszisztensek, mint a Claude vagy a ChatGPT, közvetlenül lekérdezhetik az analitikai adataidat.

WordPress 6.9 vagy újabb verzió szükséges (az Abilities API a 6.9-es verziótól a rendszer része). Régebbi verziókban az integráció észrevétlenül kikapcsolja magát.

Mihez férhetnek hozzá az ügynökök?

• Teljes jelentéskészítő motor: a mhanalytics/run-report az analitikai vezérlőpult bármely jelentését lefuttatja a teljes szegmentációs szűrőkészlettel, dátumtartományokkal és részletességgel (napi/heti/havi/éves)
• Munkamenetek: lapozható munkamenetlisták, egyetlen munkamenet teljes útvonala (oldalak, az oldalon töltött idő, görgetési mélység, események, célok), valamint az aktuálisan aktív munkamenetek élő nézete
• Szűrők feltérképezése: a nyomon követett oldalak, forgalmi források, célok és termékek listázása az azonosítóikkal együtt, így az ügynök a neveket a jelentésszűrők által várt azonosítókká alakíthatja
• Gyors összefoglalók: látogatói áttekintés, legnépszerűbb oldalak, forgalmi források, legfontosabb országok, eszközök szerinti bontás, érkezési oldalak és legutóbbi célok — amikor egy teljes jelentés már túlzás lenne

Minden képesség csak olvasható — az itt elérhetővé tett elemek egyike sem ír az adatbázisba. A hozzáféréshez a mhanalytics_report jogosultság szükséges, az MCP pedig a hitelesített WordPress-felhasználó jogosultságait örökli: egy AI-kliens csak azt olvashatja, amit az adott felhasználó a wp‑admin felületén is láthatna.

A dedikált MCP-szerver

Ha az MCP Adapter bővítmény aktív, a bővítmény regisztrálja a saját elnevezett MCP-szerverét, így az AI-asszisztensek egy általános eszközlista helyett egyetlen Must‑Have Analytics szervert látnak:

• Végpont: /wp-json/mhanalytics/mcp
• Szerver neve: Must‑Have Analytics

A képességek az adapter alapértelmezett MCP-szerverén is közzé vannak téve, így a bármelyik végpontra irányított kliensek működnek. Az MCP Adapter nélkül a képességek továbbra is használhatók a WP‑CLI-n, a REST API-n és a wp_get_ability() függvényt meghívó bármely kódon keresztül — csak MCP-n keresztül nem.

AI-kliens csatlakoztatása

1. Használj WordPress 6.9-es vagy újabb verziót
2. Telepítsd és aktiváld az MCP Adapter bővítményt (wordpress/mcp-adapter)
3. Hozz létre alkalmazásjelszót egy mhanalytics_report jogosultsággal rendelkező felhasználó számára
4. Irányítsd az MCP-klienst a https://yoursite.com/wp-json/mhanalytics/mcp címre

A hitelesítés WordPress-alkalmazásjelszavakat (vagy JWT-t) használ. A távoli HTTP-átvitelt igénylő klienseknél a szokásos megoldás a @automattic/mcp-wordpress-remote proxy; helyi fejlesztéshez az adapter WP‑CLI-n keresztüli STDIO-átvitele használható.

Bővítési pontok

mhanalytics_ability_definitions — A regisztráció előtt megszűri a képességdefiníciók teljes tömbjét. Az itt hozzáadott bejegyzést képességként regisztrálja, és automatikusan elérhetővé teszi MCP-n keresztül. Állítsd a 'timerange' => false értéket egy definíción, ha ki szeretnéd hagyni a közös dátumtartomány-bemeneteket.

mhanalytics/register_abilities — A beépített képességek regisztrálása után fut le, és képességek közvetlen regisztrálására használható a wp_register_ability() segítségével. Ezeket az MCP-szerver nem veszi át automatikusan — add hozzá őket a mhanalytics_mcp_tools segítségével.

mhanalytics_mcp_tools — Megszűri a dedikált MCP-szerver által kínált eszközlistát. Adj hozzá integrációs képességeket, vagy rejts el egy eszközt az MCP elől úgy, hogy közben elérhető maradjon a wp‑admin felületén. Üres tömb visszaadása esetén a szerver regisztrációja teljesen kimarad.

mhanalytics_ability_mcp_public — Megszűri az egyes képességek láthatóságát az adapter alapértelmezett szerverén. Paraméterek: $public, $ability_name.

Példa: a munkamenetszintű részletek kizárása az MCP-ből

add_filter('mhanalytics_mcp_tools', function($tools) {
    return array_values(array_diff($tools, array('mhanalytics/get-session-details')));
});

Fejlesztői referencia

A Must‑Have Analytics számos hookot és szűrőt biztosít a fejlesztők számára a funkcionalitás bővítéséhez és a működés testreszabásához.

Alapvető műveletek

mhanalytics/init — A bővítmény inicializálása után fut le. Egyéni integrációk betöltésére használható.

mhanalytics/load_integrations — Az integrációk betöltésekor fut le. Itt adhatsz hozzá egyéni integrációs osztályokat.

mhanalytics_option_{key}_updated — Egy adott beállítás frissítésekor fut le. Cseréld le a {key} elemet a beállítás nevére (például mhanalytics_option_profiling_updated).

Eseményfeldolgozási műveletek

mhanalytics/process_event/visit — Egy látogatási esemény feldolgozása után fut le. Paraméterek: $visit_data, $sid.

mhanalytics/process_event/bot — Botforgalom észlelésekor fut le. Paraméterek: $bot_data.

mhanalytics/login_event — Egy felhasználó bejelentkezésekor fut le. Paraméterek: $user_id, $sid.

mhanalytics/logout_event — Egy felhasználó kijelentkezésekor fut le. Paraméterek: $user_id, $sid.

mhanalytics/register_event — Új felhasználó regisztrációjakor fut le. Paraméterek: $user_id, $sid.

mhanalytics/search_event — Keresés végrehajtásakor fut le. Paraméterek: $search_term, $sid.

WooCommerce-műveletek

mhanalytics/event/view_content — Termék megtekintve. Paraméterek: $product_id, $sid, $data.

mhanalytics/event/add_to_cart — Termék a kosárhoz adva. Paraméterek: $product_id, $sid, $cart_data.

mhanalytics/event/initiate_checkout — Pénztári folyamat elindítva. Paraméterek: $sid, $cart_data.

mhanalytics/event/add_payment_info — Fizetési adatok megadva. Paraméterek: $sid, $payment_data.

mhanalytics/event/checkout — Rendelés teljesítve. Paraméterek: $order_id, $sid, $order_data.

mhanalytics/event/failed_order — Rendelés sikertelen. Paraméterek: $order_id, $sid.

mhanalytics/event/refund — Rendelés visszatérítve. Paraméterek: $order_id, $sid, $refund_data.

mhanalytics/event/coupon_added — Kupon alkalmazva. Paraméterek: $coupon_code, $sid.

mhanalytics/event/coupon_used — Kupon felhasználva a rendelésben. Paraméterek: $coupon_code, $order_id, $sid.

mhanalytics/event/abandoned_cart — Kosár elhagyva. Paraméterek: $sid, $cart_data.

mhanalytics/event/achieve_goal — Cél elérve. Paraméterek: $goal, $sid.

mhanalytics/woocommerce/purchase_trends_stat_cards — A Sales Trends statisztikai rácsán belül, a beépített kártyák után fut le. Itt jelenítsd meg az egyéni .mhanalytics-stat-card jelölőkódot.

Célok és testreszabási szűrők

mhanalytics/goal_components — Egyéni célfeltétel-típusok hozzáadása. Szakaszt és feltételeket tartalmazó tömböt adj vissza.

mhanalytics/get_goals — Az elérhető célok módosítása vagy szűrése. Paraméterek: $goals tömb.

Beállításszűrők

mhanalytics_option_{key} — A beállítás értékének szűrése lekéréskor. A {key} helyére a beállítás nevét írd.

mhanalytics_option_not_set_{key} — Alapértelmezett érték visszaadása, ha a beállítás nem létezik.

mhanalytics_update_option_{key} — Az érték ellenőrzése/átalakítása mentés előtt.

mhanalytics_check_option_{key} — Logikai ellenőrzési érték visszaadása a beállítás létezéséről.

mhanalytics/frontend_options — Egyéni beállítások hozzáadása a frontend követőhöz. Paraméterek: $options tömb.

Jelentés- és eszközszűrők

mhanalytics/report_types — Egyéni jelentéstípusok regisztrálása. Paraméterek: $types tömb.

mhanalytics/report_tiles — Egyéni jelentéscsempék hozzáadása a Reports oldalhoz. Paraméterek: $tiles tömb.

mhanalytics/tool_tiles — Egyéni eszközcsempék hozzáadása a Tools oldalhoz. Paraméterek: $tiles tömb.

mhanalytics/report_filters/filters — Szűrővezérlők hozzáadása a jelentésekhez. Paraméterek: $filters, $report_type.

mhanalytics/report_sql/options — Az SQL-generálási beállítások módosítása. Paraméterek: $options tömb.

mhanalytics/report/data — A jelentésadatok átalakítása megjelenítés előtt. Paraméterek: $data, $sql, $report_type.

mhanalytics/report/data/response — A végső REST API-válasz módosítása. Paraméterek: $response tömb.

mhanalytics/report_display_names — Egyéni oszlopcímkék. Paraméterek: $names tömb.

Munkamenet- és formázási szűrők

mhanalytics/session_device_timeframe — Az eszköz-ujjlenyomat időkorlátja másodpercben. Alapértelmezés: 1200 (20 perc) süti nélkül, 300 (5 perc) sütivel.

mhanalytics/session_cookie_timeframe — A sütialapú munkamenet időkorlátja másodpercben. Alapértelmezés: 3600 (1 óra).

mhanalytics/session_profile_timeframe — A profiladatok időkorlátja másodpercben. Alapértelmezés: 3600 (1 óra).

mhanalytics/bounce_threshold — A visszafordulás küszöbértéke másodpercben. Alapértelmezés: 30.

mhanalytics/date_format — A megjelenítéshez használt dátumformátum. Alapértelmezés: WordPress-beállítás.

mhanalytics/decimal_separator — Számok tizedesjel-elválasztója. Alapértelmezés: '.'

mhanalytics/thousands_separator — Ezreselválasztó. Alapértelmezés: ','

mhanalytics/currencies — Az elérhető pénznemek tömbje. Egyéni pénznemeket adhatsz hozzá.

mhanalytics/traffic_source — Az észlelt forgalmi forrás normalizálása/felülírása. Paraméterek: $source, $referrer.

WooCommerce-adatszűrők

mhanalytics/woocommerce/add_to_cart/product_data — A termékadatok módosítása a kosárba helyezési eseménynél.

mhanalytics/woocommerce/add_to_cart/product_id — A termékazonosító felülírása.

mhanalytics/woocommerce/add_to_cart/cart_data — A kosáradatok módosítása.

mhanalytics/woocommerce/cart_data — A kosáradatok módosítása a pénztári eseményeknél.

mhanalytics/woocommerce/order_data — A rendelési adatok módosítása a követés előtt.

mhanalytics/woocommerce/failed_order_data — A sikertelen rendelés adatainak módosítása.

mhanalytics/woocommerce/refund_data — A visszatérítési adatok módosítása.

mhanalytics/woocommerce/payment_data — A fizetési mód adatainak módosítása.

mhanalytics/woocommerce/view_content/product_id — A megtekintett termék azonosítójának felülírása.

mhanalytics/woocommerce/report_tiles — Egyéni WooCommerce-jelentéscsempék hozzáadása.

mhanalytics/woocommerce/purchase_trends_filters — A Sales Trends jelentésben felkínált szűrőkulcsok listájának szűrése (így adható hozzá a rendeléstípus-szűrő).

Conversion API-szűrők

mhanalytics/meta_pixel_body — A Meta CAPI-kérés törzsének kibővítése. Paraméterek: $body, $event_name, $sid.

mhanalytics/tiktok_body — A TikTok Events API-kérés törzsének kibővítése. Paraméterek: $body, $event_name, $sid.

Sablon- és erőforrásszűrők

mhanalytics/get_template — A sablon HTML-kódjának módosítása a kimenet előtt. Paraméterek: $html, $template_name.

mhanalytics/get_svg — Az SVG-kimenet módosítása. Paraméterek: $svg, $icon_name.

mhanalytics/session/print_event_data — Az esemény HTML-kimenetének módosítása a munkamenet részleteiben. Paraméterek: $output, $event.

mhanalytics/client_ip — Az észlelt kliens IP-címének felülírása vagy szűrése. Paraméterek: $ip.

Gyakorlati példák

1. példa: Egyéni célfeltétel hozzáadása

add_filter('mhanalytics/goal_components', function($components) {
    $components[] = [
        'section' => 'Membership',
        'conditions' => [
            'membership_level' => [
                'name' => 'Membership Level',
                'type' => 'select',
                'options' => ['free', 'premium', 'vip'],
                'operators' => ['is', 'is_not']
            ]
        ]
    ];
    return $components;
});

2. példa: Meta konverziós adatok kibővítése

add_filter('mhanalytics/meta_pixel_body', function($body, $event, $sid) {
    $eid = MH_Analytics_Profiling::get_eid_by_sid($sid);
    if ($eid) {
        $customer_ltv = calculate_customer_ltv($eid);
        $body['data'][0]['custom_data']['predicted_ltv'] = $customer_ltv;
    }
    return $body;
}, 10, 3);

3. példa: Egyéni jelentéscsempe hozzáadása

add_filter('mhanalytics/report_tiles', function($tiles) {
    $tiles[] = [
        'slug' => 'customer-segments',
        'title' => 'Customer Segments',
        'desc' => 'RFM segmentation analysis',
        'icon' => 'chart-bar' // Use custom icon name
    ];
    return $tiles;
});

4. példa: Egyéni munkamenet-időtúllépés

// Extend session timeout to 2 hours
add_filter('mhanalytics/session_cookie_timeframe', function($seconds) {
    return 7200; // 2 hours (120 minutes)
});

5. példa: A frontend követési beállításainak módosítása

add_filter('mhanalytics/frontend_options', function($opts) {
    // Force disable tracking cookie
    $opts['cookie'] = false;
    return $opts;
});

Változásnapló