Matomo Analytics

Art. no. 216207851

Introducción

Matomo (antes Piwik) es una herramienta de análisis de código abierto que proporciona información exhaustiva sobre el uso de sitios web y aplicaciones. Recopila y almacena datos, y proporciona una interfaz web para ver datos en tiempo real y crear informes. Visite https://matomo.org para obtener más información.

Esta integración puede utilizarse de múltiples maneras:

suscríbase a Matomo Cloud, que incluye alojamiento y soporte
instale Matomo en su propio servidor para tener un control total sobre sus datos
cree su propio punto final que analice los datos de eventos, lo que le permitirá almacenar y gestionar los datos exactamente como desee

Detalles de implementación

Los clientes de Prenly Reader enviarán datos estadísticos al endpoint api de seguimiento del servidor de Matomo, de acuerdo con la documentación oficial de la api de seguimiento de Matomo, utilizando

el SDK JavaScript oficial de Matomo del lector web Prenly.
los SDK:s de código abierto para Android e iOS de los lectores de aplicaciones nativas de Prenly. Esto requiere que el SDK:s se añada al código del programa de la aplicación nativa, lo que implica que las nuevas versiones de la aplicación deben ser compiladas y liberadas antes de que la integración comience a funcionar.

La implementación actual permite exportar eventos, pero no "páginas vistas", ya que Prenly Reader no se basa en la navegación tradicional basada en páginas.

Prenly no soporta Matomo Tag Manager ya que es principalmente una solución para entornos web, y por lo tanto no es directamente aplicable a los clientes nativos de Prenly.

Configuración

Configuración de un servidor Matomo

Uso de un servidor Matomo

La configuración normal de Matomo requiere que el software de servidor Matomo de código abierto se instale en las instalaciones o a través de un servicio alojado externamente, ofrecido por matomo.org o por otras empresas. El software del servidor expondrá un api que recoge datos estadísticos, y una herramienta web que le permite ver y analizar los datos.

En la herramienta web, es necesario

crear un "sitio" que corresponda a la aplicación Prenly, lo que dará lugar a un "ID de sitio"
añadir manualmente "dimensiones personalizadas" (metadatos para varios eventos) que Prenly enviará

Cuando se trata técnicamente de metadatos/dimensiones personalizadas en Matomo, se hace referencia a cada dimensión como un número entero plano, ya que se guarda en la base de datos de Matomo.

Al añadir dimensiones personalizadas a través de la herramienta web, se crean en orden numérico (1, 2, 3, ...). Dado que Prenly enviará las dimensiones de acuerdo con la siguiente lista, es importante crear las dimensiones personalizadas en el orden correcto.

Implementación de un endpoint de seguimiento personalizado

Estudiando la especificación de la api de seguimiento de Matomo, es posible implementar su propio api endpoint que recoja los datos métricos enviados desde las aplicaciones Prenly Reader.

Esto es útil si desea almacenar los datos métricos en su propio sistema y/o en su propio formato. La api de seguimiento de Matomo es simple, por lo que un endpoint de este tipo debería ser bastante sencillo de implementar.

Tenga en cuenta lo siguiente:

Sólo debe haber un punto final, y debe responder tanto a los métodos GET (evento único) y POST (un lote de eventos) como se describe en la documentación.
La URL del punto final debe terminar con /matomo.php. Esto se debe a que los clientes de código abierto utilizados por Prenly tienen esta limitación.
Las dimensiones personalizadas enviadas por Prenly se denominarán según la lista siguiente.

Configurar la integración en PWS

Los siguientes parámetros de configuración se establecen en Prenly Workspace.

ID del sitio

El ID del sitio configurado en el servidor Matomo, como un número entero.

Ejemplo: 5

URL api de seguimiento

La URL a la que se enviarán los datos de seguimiento, terminada en matomo.php.

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

Transformación de datos

General

Debido a limitaciones técnicas, todas las propiedades se envían a Matomo como cadenas.

Los atributos de evento que son booleanos se envían como "0" para falso y "1" para verdadero.

Atributos de evento

En Matomo, las dimensiones personalizadas se utilizan para representar atributos específicos de eventos. En el software del servidor Matomo, estas dimensiones personalizadas deben ser configuradas por un administrador en la interfaz web de su servidor Matomo. Desafortunadamente, Matomo no ofrece una forma de nombrar o identificar estas dimensiones, en su lugar obtendrán un número que representa su ID en la base de datos del servidor Matomo.

Prenly enviará dimensiones personalizadas de acuerdo con la siguiente tabla. Para que los ID coincidan con la tabla de abajo, debe añadir las dimensiones personalizadas en el orden correcto.

Id de dimensión de acción	Nombre del parámetro de solicitud	Atributo de evento de Prenly
1	dimensión1	babosa_aplicación
2	dimensión2	título_slug
3	dimensión3	título_uid
4	dimensión4	publicación_slug
5	dimensión5	publicación_uid
6	dimensión6	fecha_publicacion
7	dimensión7	número_página
8	dimensión8	babosa_parte
9	dimensión9	artículo_slug
10	dimensión10	artículo_uid
11	dimensión11	nombre_artículo
12	dimensión12	id_externo_artículo
13	dimensión13	sección_slug
14	dimensión14	external_url (obsoleto)
14	dimensión14	URL_destino
15	dimensión15	push_notifications_enabled
16	dimensión16	push_notification_uid
17	dimensión17	push_notification_sent_at
18	dimensión18	título_mensaje
19	dimensión19	cuerpo_mensaje
20	dimensión20	número_cliente
21	dimensión21	consent_analytical (si se conoce - enviado como `"0"` o `"1"`)
22	dimensión22	consent_functional (si se conoce - se envía como `"0"` o `"1"`)
23	dimensión23	consent_marketing (si se conoce - se envía como `"0"` o `"1"`)
24	dimensión24	tipo_banner
25	dimensión25	external_link_id
26	dimensión26	servicios_consentimiento
27	dimensión27	título_canal
28	dimensión28	canal_slug
29	dimensión29	título_episodio
30	dimensión30	identidad_episodio
31	dimensión31	fecha_publicación
32	dimensión32	posición_reproducción
33	dimensión33	audio_url
34	dimensión34	duración_audio
35	dimensión35	duración_reproducida
36	dimensión36	audio_entity_id
37	dimensión37	audio_title
38	dimensión38	acceso_limitado

Datos contextuales

Los datos contextuales se envían como parámetros tal y como se documenta en la api de seguimiento de Matomo.

El SDK de código abierto utilizado en las aplicaciones Prenly Reader implementa el seguimiento de datos de forma ligeramente diferente. Esta diversidad conduce a variaciones en los datos enviados desde cada tipo de cliente al servidor Matomo.

Se confirma que estos parámetros se envían desde todas las plataformas (web, Android, iOS):

Parámetro	Propósito	Información
rec	Si se graba el evento	Siempre se establece en true (se envía como `"1"` )
siteid	ID del sitio del servidor de seguimiento	Según lo configurado en Prenly Workspace
e_c	Categoría del evento	Siempre se establece en `"prenly-event"`
e_a	Acción del evento	Siempre como `"interacción"`.
e_n	Nombre del evento	El nombre del evento Prenly, por ejemplo `"article_open"`
res	Resolución de pantalla	Por ejemplo `"1280x1024"`
uid	Id. único de usuario, si procede	El valor `user_id` de los datos contextuales de información del usuario

No se puede garantizar el envío de otros parámetros.

Tenga en cuenta que no anulamos específicamente el agente de usuario utilizando el parámetro "ui". Aún así, algunas plataformas pueden enviarlo, pero no debes confiar en ello. En su lugar, debe comprobar la cabecera HTTP User-Agent para poder determinar el agente de usuario y la plataforma.