Tartalom
- oldal: Alapfeltételek áttekintése és a tárhely előkészítése a Matomo számára
- oldal: Matomo letöltése és telepítése
- oldal: Követőkódok elhelyezése WordPress rendszerű oldalakon
- oldal: Követőkódok elhelyezése Drupal rendszerű oldalakon
- oldal: Követőkódok elhelyezése és testreszabása egyedi fejlesztésű oldalakon
- oldal: A telepítés utáni fontos beállítások elvégzése
- oldal: GeoIP 2 (PHP) alapú geolokációs rendszer beüzemelése
- oldal: Matomo teljes rendszer átállítása PHP-FPM alapú szerver API működésre
A 3. oldal tartalma
Folytatás
Az előző oldalon feltelepítettük a Matomo (Piwik) webstatisztikai rendszert, itt folytatjuk a követőkódok elhelyezésével a WordPress rendszerű weboldalakba. A bővítmény beállítása nem bonyolult, a leírás ezen részét inkább azért készítetem el, hogy akik még a Matomo rendszer telepítésén gondolkodnak, előre láthassák a bővítmény által kínált lehetőségeket.
Követőkódok elhelyezése WordPress rendszerű oldalakon
Ha WordPress alapú CMS rendszerű oldalban szeretnénk elhelyezni a Matomo követőkódját, akkor egyszerű dolgunk van: csak le kell tölteni a megfelelő WordPress bővítményt, és beállítgatni azt.
Bővítmény telepítése
A Matomo hivatalos telepítő oldaláról kiindulva eljutunk a gyártó által hivatalosan is ajánlott WordPress bővítmény oldalára. Tehát ezt kell megkeresnünk a weboldal admin felületén lévő bővítménykezelő részben (Admin - Bővítmények - Új hozzáadása - Keresés kulcsszóra: "matomo"):
Meg is van, itt rögtön a legelső, a többivel ne foglalkozzunk. Telepítsük majd kapcsoljuk be. Ezután a rendszer visszadob a telepített bővítmények listájára:
Itt a WP-Matomo-nál kattintsunk a beállításokra, ekkor bejön a plugin beállító oldala:
Csatlakozás a Matomo-hoz fül
Itt a következőket kell beállítani:
- Matomo mode: Itt hagyjuk az alapértelmezetten (HTTP API).
- Matomo URL: Adjuk meg a Matomo példányunk elérési könyvtárát. Például a korábban is említett weboldal alatti könyvtárból. Itt a "házilag hosts fájlba beállított" domain nevet nem fogadja el alapból, mert ilyenkor a szerver is egy külső DNS szolgáltatás segítségével próbálja feloldani a nevet, ezért nem találja meg a saját gépen lévő virtualhost-ot. Ehhez be kellene állítani a szerver /etc/hosts fájljába is a domain nevet a szerver saját IP-címével. De most egyelőre a virtuális gép IP-címe alatti matomo elérést használom.
- Authorizációs token: Itt pedig egy hosszú hexadecimális kódot kell megadni, amivel azonosítja magát az API-n keresztül. Ezt mindjárt meg is nézzük hogyan szerezhetjük be.
- Automata konfiguráció: Ha korábban nem vittük fel a weboldalt a Matomo rendszerébe, pl. ez egy újabb weboldal, stb., akkor ezzel az opcióval engedélyezzük, hogy ez a bővítmény most létrehozza a Matomo-ban ezt a weboldalt, új oldalként. Ha már szerepel a rendszerben, akkor nincs jelentősége hogy be van-e kapcsolva.
Authorizációs token beszerzése
Váltsunk át a Matomo felületére, ott ügyeljünk, hogy ez az oldal legyen beállítva a fejléc alatti oldalválasztó legördülőben. Ekkor kattintsunk a fejléc jobb szélén lévő fogaskerék ikonra. Ezután bejön a Matomo fő beállítások oldala. Itt görgessünk lejjebb, amíg a bal oldali menüsávban megtaláljuk az API almenüt (a Platform csoportban). Kattintsunk az API menüre, ekkor bejön az API-ra vonatkozó beállítások oldala:
Itt először a szürke sávon kicsillagozva jelenik meg az azonosító. Kattintsunk rá, ekkor előjön az egész, ki is másolja nekünk a vágólapra. Térjünk vissza a WordPress Piwik beállításaihoz, majd a kimásolt sorból csak az egyenlőségjel utáni kódrész kell nekünk, ezt illesszük be a fenti Authorizációs token mezőbe, levágva az elejéről a "&token_auth=" részt.
Ha megvagyunk az űrlappal, akkor kattintsunk a módosítások mentése gombra. Sikeres csatlakozás után ilyen ablak fogad minket:
Lépjünk a következő fülre.
Statisztikák megjelenítése fül
Ezen a fülön a WordPress admin felületén a plugin által megjelenített Matomo statisztikákat lehet testreszabni. Ezekre most nem térek ki, mert nem tárgya ennek a leírásnak, csak két képet mutatok a beállításokról, ahol kinyitogattam a súgókat is:
Itt tehát egy jól testre szabható statisztikai felületet állíthatunk be a WordPress oldalunk admin felületén is, ami a Matomo-ból szedi az adatokat az API segítségével.
Követés engedélyezése fül
Ezen az oldalon van a lényeg: itt kell engedélyeznünk az egész statisztikai rendszer működését, valamint aprólékosan testre szabhatjuk a mérőkód működését (itt az űrlap terjedelme miatt több részre bontottam a beállítások magyarázatát):
- Követőkód hozzáadása: Itt többféle követési módszer közül választhatunk. Ha nincs különösebb okunk eltérni a normális működéstől, akkor válasszuk az Alapértelmezett követést. Ez egy normál HTTP vagy HTTPS kapcsolaton keresztül történő mérést biztosít a weboldal számára, amely a legtöbb esetben ajánlott.
- Követőkód: Ez egy előnézeti, vagy szerkesztő mező a JavaScript követőkód számára. Ha fent nem a "Megadás manuálisan" opciót választjuk, akkor itt egyelőre üres marad, majd az űrlap lementése után fogja beadni a kód előnézetét, miután már minden opció be lett állítva. Ezzel ilyenkor nem lesz dolgunk, csak ellenőrizhetjük magát a kódot.
Ha pedig a kézi beállítást választottuk, akkor írhatóvá válik ez a textbox, és beilleszthetjük a magunk által elkészített kódot, vagy éppen azt, amit a Matomo ajánlott fel nekünk az oldal létrehozása után.
- JavaScript kód pozíció: Ezt állítsuk a fejlécre. A Matomo is így javasolja, hogy a </head> tag elé kell tenni.
- Noscript kód: Ez a kódrész (leginkább egy URL erőforrásra mutató hivatkozás) akkor fut le, ha a a látogató böngészőjében nincs engedélyezve a JavaScript. Ma már ez nem nagyon fordul elő, így inkább a robotok követésére alkalmasabb, amik nem futtatnak JavaScript kódokat. Itt szintén nem tudunk szerkeszteni, ez egy előnézet megjelenítés lesz az űrlap lementése után.
- <noscript> Hozzáadása: Itt engedélyezhetjük az imént említett Noscript részt.
- Rec paraméter hozzárendelése a noscript kódhoz: További beállítást ad a Noscript részhez.
- Tartalom követés engedélyezése: Itt szabályozhatjuk, hogy a WordPress rendszerünkben milyen típusú tartalmak látogatásait kövesse a Matomo
- Keresés követése: Az oldal kereséseinek követését engedélyezhetjük itt.
- 404 követése: A hibaoldalak követését is szabályozhatjuk
- Add annotation on new post of type: Ha új bejegyzés jön létre az itt beállított tartalomtípusoknál, akkor elhelyez egy megjegyzést a Matomo statisztikáinál lévő idővonalon.
- Egyedi változók doboz megjelenítése: Ha bekapcsoljuk, akkor a WordPress tartalmi szerkesztő részénél előjön egy doboz a felhasználható változókkal. Ezekkel a változókkal egyedi és célirányos nyomkövetéseket végezhetünk a különböző tartalmainkban.
- Új fájltípusok hozzáadása a letöltés követéshez: Az itt felsorolt fájlkiterjesztéseket a Matomo letöltésként fogja regisztrálni, így másik eseménytípust kapcsol hozzájuk, mint egy sima oldalletöltés. Például, ha az oldalunkon kínálunk zip, gzip, stb letöltéseket, akkor itt sorolhatjuk fel ezeket a kiterjesztéseket, amiket azután a statisztikában elkülönítve is megjeleníthetünk a lekérdezések során.
- Sütik letiltása: Letiltja a követési sütiket. Nem ajánlott a használata, mert rontja a követés pontosságát.
- Süti élettartamának limitálása: Itt határozhatjuk meg, hogy egy látogatót mennyi idő elteltével fogja a Matomo új munkamenetnek tekinteni. Ha bekapcsoljuk, akkor megjelenik újabb 3 mező: Látogatói időkorlát (másodpercben), Munkamenet időkorlát (másodpercben), Hivatkozás időkorlát (másodpercben). Ezeket finomhangolhatjuk ilyenkor.
- Admin oldalak követése: Ha bekapcsoljuk, akkor az adminban tett látogatásokat is továbbítja ez a WordPress plugin a Matomo számára.
- Követési szűrő: Ha az iménti admin oldal követés be van kapcsolva, akkor itt választhatjuk ki, hogy mely felhasználói szinteket kövesse a rendszer.
- Aldomainek követése ugyanazon weboldalon: Ha bekapcsoljuk, akkor prefixeli a látogatásokat az aldomainekkel. Így a statisztikákban könnyebben meg tudjuk különböztetni azokat. Pl nyelvi aldomainek, stb.
- Ne számolja az aldomaineket a kilépési linkeknél: Ha bekapcsoljuk, akkor az aldomainek közötti átlépéseket nem számítja kilépési pontnak.
- Enable cross domain linking: Ha bekapcsoljuk, akkor a saját kezelésünkben lévő domainek/weboldalak látogatásait egyedi azonosítóval látja el, így nem fordulhat elő kettő egyforma azonosító két weboldalon.
- RSS csatornák követése: Bekapcsoláskor az RSS csatornáinkat is követi a rendszer, egy hozzáadott pixel segítségével.
- RSS csatorna linkek kampánykénti követése: Az RSS csatornákat egyedileg, kampányként követi.
- RSS csatorna kampány: Ha az előzőt bekapcsoltuk, akkor itt lehet megadni az RSS csatorna nevét.
- Heartbeat időzítő engedélyezése: Ha itt beállítunk egy másodperc értéket, akkor a JavaScript ennyi időnként elküld egy "életjelet" a Matomo szervernek, ezáltal pontosabb látogatási időtartamokat kapunk. A funkció hatására a megnövekedett a HTTP forgalom miatt a szerver is jobban terhelődik. Így optimális értéket állítsunk itt be. 0 érték=funkció letiltása.
- User ID Tracking: Itt választhatjuk ki, hogy a WordPress rendszerén belül milyen azonosítót adjon a látogatásokhoz. Itt én a WP User ID-t ajánlom, mert ezzel később rugalmasabban tudunk dolgozni akár az adatbázisokban is, szükség esetén.
Ezek volnának a követés engedélyezés beállításai. Ha mindent beállítottunk igényeink szerint, mentsük le az űrlapot. Mentés után visszatérve ugyanerre a fülre, már megjelenik a követőkódunk is. Persze csak érdekességképpen tekintsünk rá.
Ezek a beállítások már elegendőek a WordPress oldal méréséhez.
A Haladó beállítások fül alatt lévő opciókat csak akkor módosítsuk, ha valamelyik szolgáltatás vagy egy szituáció konkrétan megköveteli. Egyébként itt minden beállítás a normális működéshez van beállítva.
Tesztelés
Ha mindent sikeresen beállítottunk és lementettünk, akkor tesztelhetjük is a Matomo (Piwik) webstatisztika működését: lépkedjünk a WordPress oldalain, majd néhány kattintás után nézzünk be a Matomo felületére:
És itt már megjelennek az első mért oldalletöltések, grafikonok, stb.
A következő oldalon folytatjuk a Drupal rendszerű weboldalak követőkódjainak beépítésével.
- Enciklopédia - Matomo (Piwik) webanalitika
- Hogyan frissítsük Matomo (korábban Piwik) webanalitikai rendszerünket a 4.x verzióra
- Matomo.org
- Matomo.org - Installation
- Enciklopédia - CMS (Tartalomkezelő rendszer)
- Mit tegyünk, ha a Matomo webanalitikai rendszerünk "AH01630: client denied by server configuration" típusú Apache hibákat generál, ami miatt a Fail2Ban letiltja az IP-címünket?
- Szerver monitorozása a Munin segítségével Debian 9 (Stretch) és Debian 10 (Buster) rendszereken
Lapozó
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
- 73 megtekintés