Hogyan telepítsük a Matomo (korábban Piwik) webanalitikai szoftvert Apache rendszerű szerverünkre (3. oldal)

botond küldte be 2019. 09. 01., v - 16:03 időpontban

Tartalom

 

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"):

WordPress admin - Matomo plugin keresése

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:

WordPress admin - Telepített bővítmények

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

WordPress admin - WP-Piwik Beállítások - Csatlakozás a matomo-hoz

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:

Matomo - Beállítások - API

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:

WordPress admin - WP-Piwik Beállítások - Sikeres csatlakozás

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:

WordPress admin - WP-Piwik Beállítások - Statisztikák megjelenítése (1. kép)

WordPress admin - WP-Piwik Beállítások - Statisztikák megjelenítése (2. kép)

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

WordPress admin - WP-Piwik Beállítások - Követés engedélyezése (1. kép)

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

WordPress admin - WP-Piwik Beállítások - Követés engedélyezése (2. kép)

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

WordPress admin - WP-Piwik Beállítások - Követés engedélyezése (3. kép)

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

WordPress admin - WP-Piwik Beállítások - Követés engedélyezése (4. kép)

  • 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:

Matomo - Új oldal tesztelése

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

 

 

Lapozó

Ez a leírás több oldalból áll: