Matomo-Analytik - Prenly
Einführung
Matomo (ehemals Piwik) ist ein Open-Source-Analysetool, das umfassende Einblicke in die Nutzung von Websites und Anwendungen bietet. Es sammelt und speichert Daten und bietet eine Webschnittstelle zur Anzeige von Echtzeitdaten und zur Erstellung von Berichten. Besuchen Sie https://matomo.org für weitere Informationen.
Diese Integration kann auf verschiedene Weise genutzt werden:
- Abonnieren Sie die Matomo Cloud, die Hosting und Support beinhaltet
- Installieren Sie Matomo auf Ihrem eigenen Server, um die volle Kontrolle über Ihre Daten zu haben
- Erstellen Sie Ihren eigenen Endpunkt, der die Ereignisdaten analysiert, so dass Sie die Daten genau nach Ihren Wünschen speichern und verwalten können.
Details zur Implementierung
Die Prenly Reader Clients senden statistische Daten an den Matomo Server Tracking Api Endpunkt, entsprechend der offiziellen Dokumentation der Matomo Tracking Api, unter Verwendung
- das offizielle Matomo's offizielle JavaScript SDK vom Prenly Webreader.
- die Open Source SDK:s für Android und iOS aus dem Prenly Native App Reader. Dies erfordert, dass die SDK:s zum Programmcode der nativen App hinzugefügt werden, was bedeutet, dass neue App-Versionen kompiliert und freigegeben werden müssen, bevor die Integration funktionieren kann.
Die aktuelle Implementierung unterstützt den Export von Ereignissen, nicht aber "Seitenansichten", da der Prenly Reader nicht auf die traditionelle seitenbasierte Navigation setzt.
Prenly unterstützt den Matomo Tag Manager nicht, da dieser primär eine Lösung für Webumgebungen ist und daher nicht direkt auf die nativen Clients von Prenly anwendbar ist.
Einrichtung
Einrichten eines Matomo-Servers
Verwendung eines Matomo-Servers
Die normale Matomo-Einrichtung erfordert die Installation der quelloffenen Matomo-Server-Software vor Ort oder über einen extern gehosteten Dienst, der von matomo.org oder anderen Unternehmen angeboten wird. Die Serversoftware stellt eine API zur Verfügung, die statistische Daten sammelt, sowie ein Webtool, mit dem Sie die Daten anzeigen und analysieren können.
Im Webtool müssen Sie:
- eine "Site" erstellen, die der Prenly-Anwendung entspricht, was zu einer "Site ID" führt
- manuell "benutzerdefinierte Dimensionen" (Metadaten für verschiedene Ereignisse) hinzufügen, die Prenly senden wird
Wenn es in Matomo um Metadaten und benutzerdefinierte Dimensionen geht, wird jede Dimension als einfache Ganzzahl bezeichnet, da sie in der Matomo-Datenbank gespeichert wird.
Beim Hinzufügen von benutzerdefinierten Dimensionen über das Webtool werden sie in numerischer Reihenfolge erstellt (1, 2, 3, ...). Da Prenly die Dimensionen gemäß der unten stehenden Liste sendet, ist es wichtig, die benutzerdefinierten Dimensionen in der richtigen Reihenfolge zu erstellen.
Implementieren eines benutzerdefinierten Tracking-Endpunkts
Wenn Sie die Spezifikation der Matomo-Tracking-Api studieren, ist es möglich, einen eigenen Api-Endpunkt zu implementieren, der die von den Prenly Reader-Anwendungen gesendeten metrischen Daten sammelt.
Dies ist nützlich, wenn Sie metrische Daten in Ihrem eigenen System und/oder in Ihrem eigenen Format speichern möchten. Die Matomo-Tracking-Api ist einfach, so dass ein solcher Endpunkt relativ einfach zu implementieren sein sollte.
Beachten Sie das Folgende:
- Es sollte nur einen Endpunkt geben und er muss sowohl auf die GET- (einzelnes Ereignis) als auch auf die POST-Methode (eine Reihe von Ereignissen) reagieren, wie in den Dokumenten beschrieben.
- Die URL zum Endpunkt muss mit
/matomo.phpenden. Dies ist darauf zurückzuführen, dass die von Prenly verwendeten Open-Source-Clients diese Einschränkung haben. - Die benutzerdefinierten Dimensionen, die von Prenly gesendet werden, werden entsprechend der unten stehenden Liste benannt.
Konfigurieren Sie die Integration in PWS
Die folgenden Konfigurationsparameter werden im Prenly Workspace eingerichtet.
Standort-ID
Die im Matomo-Server konfigurierte Standort-ID, als Ganzzahl.
Beispiel: 5
Tracking api URL
Die URL, an die die Tracking-Daten gesendet werden und die mit matomo.php endet.
Beispiel: https: //my.site.com/matomo.php
Transformation der Daten
Allgemein
Aufgrund von technischen Einschränkungen werden alle Eigenschaften als Strings an Matomo gesendet.
Ereignisattribute, die Boolesche Werte sind, werden als "0" für falsch und "1" für wahr gesendet.
Ereignis-Attribute
In Matomo werden benutzerdefinierte Dimensionen verwendet, um ereignisspezifische Attribute darzustellen. In der Matomo-Server-Software müssen diese benutzerdefinierten Dimensionen von einem Administrator in der Weboberfläche Ihres Matomo-Servers eingerichtet werden. Leider bietet Matomo keine Möglichkeit, diese Dimensionen zu benennen oder zu identifizieren. Stattdessen erhalten sie eine Nummer, die ihre ID in der Datenbank des Matomo-Servers darstellt.
Prenly sendet benutzerdefinierte Dimensionen entsprechend der untenstehenden Tabelle. Damit die ID:s mit der untenstehenden Tabelle übereinstimmen, sollten Sie die benutzerdefinierten Dimensionen in der richtigen Reihenfolge hinzufügen.
| Aktion Dimension id | Name des Anfrageparameters | Prenly Ereignis-Attribut |
|---|---|---|
| 1 | Dimension1 | anwendung_slug |
| 2 | Abmessung2 | Titel_Schlagwort |
| 3 | Abmessung3 | titel_uid |
| 4 | Abmessung4 | veröffentlichung_lug |
| 5 | Abmessung5 | publikation_uid |
| 6 | Abmessung6 | veröffentlichung_datum |
| 7 | Abmessung7 | seite_nummer |
| 8 | Abmessung8 | Teil_Schlagwort |
| 9 | abmessung9 | Artikel_Zeichen |
| 10 | Abmessung10 | artikel_uid |
| 11 | Abmessung11 | artikel_name |
| 12 | Abmessung12 | artikel_extern_id |
| 13 | Abmessung13 | Abschnitt_Schlagwort |
| 14 | Abmessung14 | external_url (veraltet) |
| 14 | Abmessung14 | ziel_url |
| 15 | Abmessung15 | push_notifications_enabled |
| 16 | Abmessung16 | push_notification_uid |
| 17 | Abmessung17 | push_notification_sent_at |
| 18 | Abmessung18 | nachricht_titel |
| 19 | Abmessung19 | nachricht_body |
| 20 | Abmessung20 | kunden_nummer |
| 21 | Abmessung21 | consent_analytical (falls bekannt - wird als "0" oder "1" gesendet) |
| 22 | Abmessung22 | consent_functional (falls bekannt - wird als "0" oder "1" gesendet) |
| 23 | Abmessung23 | consent_marketing (falls bekannt - wird als "0" oder "1" gesendet) |
| 24 | Abmessung24 | banner_type |
| 25 | Abmessung25 | externer_link_id |
| 26 | Abmessung26 | zustimmung_dienstleistungen |
| 27 | Abmessung27 | channel_title |
| 28 | Abmessung28 | Kanal_Schlüssel |
| 29 | Abmessung29 | episode_title |
| 30 | Abmessung30 | episode_entity_id |
| 31 | Abmessung31 | datum_veröffentlichen |
| 32 | Abmessung32 | wiedergabe_position |
| 33 | Abmessung33 | audio_url |
| 34 | Abmessung34 | audio_duration |
| 35 | abmessung35 | abgespielt_dauer |
| 36 | Abmessung36 | audio_entity_id |
| 37 | Abmessung37 | audio_title |
| 38 | Abmessung38 | begrenzter_Zugang |
Kontextbezogene Daten
Kontextdaten werden als Parameter gesendet, wie in der Tracking-Api von Matomo dokumentiert.
Das Open Source SDK, das in den Prenly Reader Anwendungen verwendet wird, implementiert die Datenverfolgung leicht unterschiedlich. Diese Vielfalt führt zu Abweichungen bei den Daten, die von jedem Client-Typ an den Matomo-Server gesendet werden.
Diese Parameter werden von allen Plattformen (Web, Android, iOS) bestätigt:
| Parameter | Zweck | Informationen |
|---|---|---|
| rec | Ob das Ereignis aufgezeichnet werden soll | Immer auf true gesetzt (wird als "1" gesendet) |
| siteid | Die Standort-ID des Tracking-Servers | Wie in Prenly Workspace konfiguriert |
| e_c | Ereignis-Kategorie | Immer auf "prenly-event" eingestellt |
| e_a | Ereignis-Aktion | Steht immer auf "Interaktion" |
| e_n | Name des Ereignisses | Der Name des Ereignisses, zum Beispiel "article_open". |
| res | Bildschirmauflösung | Zum Beispiel "1280x1024". |
| uid | Eindeutige Benutzerkennung, falls zutreffend | Der Wert user_id aus den Kontextdaten der Benutzerinformationen |
Bei anderen Parametern kann nicht garantiert werden, dass sie gesendet werden.
Beachten Sie, dass wir den User-Agent mit dem "ui"-Parameter ausdrücklich nicht außer Kraft setzen. Einige Plattformen können ihn dennoch senden, aber Sie sollten sich nicht darauf verlassen. Stattdessen müssen Sie den User-Agent HTTP-Header überprüfen, um den User-Agent und die Plattform zu bestimmen.