Matomo Analytics

Art. no. 216207851

Johdanto

Matomo (entinen Piwik) on avoimen lähdekoodin analytiikkatyökalu, joka tarjoaa kattavaa tietoa verkkosivustojen ja sovellusten käytöstä. Se kerää ja tallentaa tietoja ja tarjoaa web-käyttöliittymän reaaliaikaisten tietojen tarkasteluun ja raporttien luomiseen. Lisätietoja on osoitteessa https://matomo.org.

Tätä integraatiota voidaan käyttää monin eri tavoin:

tilata Matomo Cloud -palvelun, joka sisältää hostingin ja tuen.
asenna Matomo omalle palvelimellesi, jotta voit hallita tietoja täysin.
rakentaa oman päätepisteen, joka jäsentää tapahtumatiedot, jolloin voit tallentaa ja hallita tietoja juuri haluamallasi tavalla.

Toteutuksen yksityiskohdat

Prenly Reader -asiakkaat lähettävät tilastotietoja Matomo-palvelimen tracking api -päätepisteeseen Matomo tracking api:n virallisen dokumentaation mukaisesti käyttäen:

virallista Matomon virallista JavaScript SDK:ta Prenly-verkkolukijasta.
avoimen lähdekoodin SDK:ta Android och iOS: lle Prenlyn natiivisovelluslukijasta. Tämä edellyttää, että SDK:t lisätään natiivisovelluksen ohjelmakoodiin, mikä tarkoittaa, että uudet sovellusversiot on käännettävä ja julkaistava ennen kuin integrointi alkaa toimia.

Nykyinen toteutus tukee tapahtumien vientiä, mutta ei "sivunäkymiä", koska Prenly Reader ei perustu perinteiseen sivupohjaiseen navigointiin.

Prenly ei tue Matomo Tag Manageria, koska se on ensisijaisesti web-ympäristöihin tarkoitettu ratkaisu, eikä sitä siksi voida suoraan soveltaa Prenlyn natiiviohjelmiin.

Asennus

Matomo-palvelimen perustaminen

Matomo-palvelimen käyttäminen

Matomon normaali käyttöönotto edellyttää, että avoimen lähdekoodin Matomo-palvelinohjelmisto asennetaan paikallisesti tai ulkoisesti isännöidyn palvelun kautta, jota tarjoaa matomo.org tai muut yritykset. Palvelinohjelmisto tarjoaa api:n, joka kerää tilastotietoja, ja verkkotyökalun, jonka avulla voit tarkastella ja analysoida tietoja.

Verkkotyökalussa sinun on:

luoda "sivusto", joka vastaa Prenly-sovellusta, mikä johtaa "sivuston ID:hen".
lisätä manuaalisesti "mukautettuja ulottuvuuksia" (metatietoja eri tapahtumia varten), jotka Prenly lähettää.

Kun teknisesti käsitellään metatietoja / mukautettuja ulottuvuuksia Matomossa, jokaiseen ulottuvuuteen viitataan tavallisena kokonaislukuna, koska se tallennetaan Matomon tietokantaan.

Kun mukautettuja ulottuvuuksia lisätään verkkotyökalun kautta, ne luodaan numerojärjestyksessä (1, 2, 3, ...). Koska Prenly lähettää ulottuvuudet alla olevan luettelon mukaisesti, on tärkeää luoda mukautetut ulottuvuudet oikeassa järjestyksessä.

Mukautetun seurantapisteen toteuttaminen

Tutustumalla Matomo tracking api:n määrittelyyn on mahdollista toteuttaa oma api-päätepiste, joka kerää Prenly Reader -sovellusten lähettämät mittatiedot.

Tämä on hyödyllistä, jos haluat tallentaa metriikkatiedot omaan järjestelmääsi ja/tai omassa formaatissasi. Matomo tracking api on yksinkertainen, joten tällaisen päätepisteen pitäisi olla melko helppo toteuttaa.

Huomaa seuraavat asiat:

Päätepisteitä saa olla vain yksi, ja sen on vastattava sekä GET- (yksittäinen tapahtuma) että POST- (tapahtumien erä) menetelmiin, kuten dokumentissa on kuvattu.
Päätepisteen URL-osoitteen on päätyttävä osoitteeseen /matomo.php. Tämä johtuu siitä, että Prenlyn käyttämillä avoimen lähdekoodin asiakkailla on tämä rajoitus.
Prenlyn lähettämät mukautetut mitat nimetään alla olevan luettelon mukaisesti.

Määritä integrointi PWS:ssä

Seuraavat konfigurointiparametrit määritetään Prenly Workspacessa.

Sivuston tunnus

Matomo-palvelimessa määritetty sivuston ID kokonaislukuna.

Esim: 5

Seuranta-api-URL

URL-osoite, johon seurantatiedot lähetetään, päätteeksi matomo.php.

Esimerkki: https: //my.site.com/matomo.php

Tietojen muuntaminen

Yleistä

Teknisten rajoitusten vuoksi kaikki ominaisuudet lähetetään Matomoon merkkijonoina.

Tapahtumaominaisuudet, jotka ovat boolean-arvoja, lähetetään muodossa "0", joka tarkoittaa "false" (väärin) ja "1", joka tarkoittaa "true" (totta).

Tapahtuman ominaisuudet

Matomossa käytetään mukautettuja ulottuvuuksia tapahtumakohtaisten ominaisuuksien esittämiseen. Matomo-palvelinohjelmistossa järjestelmänvalvojan on määritettävä nämä mukautetut ulottuvuudet Matomo-palvelimen verkkokäyttöliittymässä. Valitettavasti Matomo ei tarjoa tapaa nimetä tai tunnistaa näitä ulottuvuuksia, vaan ne saavat numeron, joka edustaa niiden tunnusta Matomo-palvelimen tietokannassa.

Prenly lähettää mukautetut mitat alla olevan taulukon mukaisesti. Jotta ID:t vastaisivat alla olevaa taulukkoa, sinun on lisättävä mukautetut mitat oikeassa järjestyksessä.

Toimintoulottuvuuden id	Pyyntöparametrin nimi	Prenly-tapahtuman attribuutti
1	ulottuvuus1	application_slug
2	ulottuvuus2	title_slug
3	ulottuvuus3	title_uid
4	dimension4	publication_slug
5	dimension5	publication_uid
6	dimension6	publication_date
7	ulottuvuus7	sivunumero
8	ulottuvuus8	part_slug
9	dimension9	artikkeli_slug
10	dimension10	article_uid
11	dimension11	artikkeli_nimi
12	dimension12	artikkeli_ulkoinen_id
13	dimension13	section_slug
14	dimension14	external_url (vanhentunut)
14	dimension14	destination_url
15	dimension15	push_notifications_enabled
16	dimension16	push_notification_uid
17	dimension17	push_notification_sent_at
18	ulottuvuus18	message_title
19	ulottuvuus19	message_body
20	dimension20	asiakas_numero
21	ulottuvuus21	consent_analytical (jos tiedossa - lähetetään muodossa `"0"` tai `"1"`)
22	ulottuvuus22	consent_functional (jos tiedossa - lähetetään muodossa `"0"` tai `"1"`).
23	ulottuvuus23	consent_marketing (jos tiedossa - lähetetään muodossa `"0"` tai `"1"`).
24	ulottuvuus24	bannerin_tyyppi
25	dimension25	external_link_id
26	dimension26	suostumus_palvelut
27	ulottuvuus27	kanava_nimike
28	ulottuvuus28	channel_slug
29	dimension29	episode_title
30	dimension30	episode_entity_id
31	dimension31	publish_date
32	ulottuvuus32	playback_position
33	dimension33	audio_url
34	dimension34	audio_duration
35	dimension35	played_duration
36	dimension36	audio_entity_id
37	dimension37	audio_title
38	dimension38	limited_access

Kontekstitiedot

Kontekstitiedot lähetetään parametreina, kuten Matomon seuranta-apissa on dokumentoitu.

Avoimen lähdekoodin SDK:t, joita käytetään Prenly Reader -sovelluksissa, toteuttavat tietojen seurannan hieman eri tavalla. Tämä erilaisuus johtaa siihen, että kunkin asiakastyypin Matomo-palvelimelle lähettämät tiedot vaihtelevat.

Nämä parametrit vahvistetaan lähetettäväksi kaikilta alustoilta (web, Android, iOS):

Parametri	Tarkoitus	Tiedot
rec	Tallennetaanko tapahtuma	Asetetaan aina arvoksi true (lähetetään arvona `"1"` ).
siteid	Seurantapalvelimen sivuston ID	Kuten Prenly Workspacessa on määritetty
e_c	Tapahtuman luokka	Asetetaan aina arvoksi `"prenly-event".`
e_a	Tapahtuman toiminto	Asetetaan aina arvoksi `"vuorovaikutus"`.
e_n	Tapahtuman nimi	Tapahtuman nimi, esimerkiksi `"article_open"`.
res	Näytön resoluutio	Esimerkiksi `"1280x1024"`
uid	Yksilöllinen käyttäjätunnus tarvittaessa	`Käyttäjätietojen` kontekstuaalisista tiedoista saatu `user_id-arvo`.

Muiden parametrien lähettämistä ei voida taata.

Huomaa, että emme erityisesti ohita käyttäjäagenttia "ui"-parametrin avulla. Silti jotkut alustat saattavat lähettää sen, mutta siihen ei pidä luottaa. Sen sijaan sinun on tarkistettava User-Agent HTTP-otsake, jotta voit määrittää käyttäjäagentin ja alustan.