Matomo

Matomo, anciennement Piwik, est une application open source d'analyse web pour suivre les visites en ligne d'un ou plusieurs sites Web et afficher des rapports sur ces visites pour analyse. En utilisant cette destination, vous pouvez implémenter un suivi server-side en utilisant Matomo Tracking HTTP API.

Principales fonctionnalités

La destination Matomo fournit les fonctionnalités clés suivantes :

• Structure des events: notre Events reference couvre Structure des requêtes de Matomo, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

• Mappings préconstruits: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

• Hachage automatique : les informations sont automatiquement hachées en respectant les spécifications du partenaire.

• Événements et propriétés personnalisés : vous pouvez librement envoyer des événements et des propriétés personnalisés en fonction de vos besoins spécifiques.

• Prise en charge des données multi-éléments: les informations incluses dans le item array est transmis à Matomo.

Configuration de la destination

Matomo recommande d'utiliser des paramètres personnalisés au lieu des variables personnalisées car ces dernières sont obsolètes. Les données pour certains champs optionnels de Matomo ne seront pas disponibles dans votre application / couche technique, ce qui est attendu, mais vous devez fournir autant d'informations que possible.

Configuration

Settings	Description
Domaine du serveur	Obligatoire Le domaine de votre serveur tel que fourni par Matomo. (Par ex. pour https://your-matomo-domain.example/matomo.php, incluez uniquement la chaîne bleue).
Site Id	Obligatoire L'identifiant de votre site tel que fourni par Matomo. Plus de détails sont disponibles en suivant ce LINK.
Nom du cookie Visitor Id	Nom du cookie contenant quelques informations sur l'utilisateur comme l'identifiant unique du visiteur. Il commence normalement par la chaîne _pk_id. Cela a la priorité sur le champ suivant Valeur Visitor Id . Plus de détails sont disponibles en suivant ce LINK. (Par ex. valeur "4e4eb04b31f37eac.1653656637.")
Valeur Visitor Id	La valeur de l'identifiant unique du visiteur si vous devez le transmettre sans cookie.
Identifiant utilisateur	Vous pouvez transmettre votre identifiant utilisateur sélectionné pour les utilisateurs connectés. Plus de détails sont disponibles en suivant ce LINK.
Variables personnalisées Matomo	Mappez vos variables personnalisées Matomo en définissant leurs noms de champ dans Nom de la variable personnalisée et en ajoutant le nom du champ contenant la valeur dans Propriété d'événement Commanders Act ou valeur statique. Par ex. si vous saisissezsizedans Nom de la variable personnalisée et items.0.product.size dans Propriété d'événement Commanders Act ou valeur statique, vous aurez une variable personnalisée dans Matomo appeléesizeavec une valeur basée sur le contenu du champ items.0.product.size [1]. Vous avez également la possibilité de définir une valeur statique (chaîne/numérique) dans Propriété d'événement Commanders Act ou valeur statique. Plus de détails sur les variables personnalisées sont disponibles en suivant ce LINK.
Paramètres personnalisés Matomo	Mappez vos paramètres personnalisés Matomo en définissant leurs noms de champ dans Nom du paramètre personnalisé et en ajoutant le nom du champ contenant la valeur dans Propriété d'événement Commanders Act ou valeur statique. Par ex. si vous saisissezsizedans Nom du paramètre personnalisé et items.0.product.size dans Propriété d'événement Commanders Act ou valeur statique, vous aurez un paramètre personnalisé dans Matomo appelésizeavec une valeur basée sur le contenu du champ items.0.product.size [1]. Vous avez également la possibilité de définir une valeur statique (chaîne/numérique) dans Propriété d'événement Commanders Act ou valeur statique. Plus de détails sur les paramètres/dimensions personnalisés sont disponibles en suivant ce LINK.
Objectifs Matomo	Mappez vos objectifs Matomo en définissant le Commanders Act Event Name dans le champ correspondant et le Matomo Goal Id associé à celui-ci. Plus de détails sur les objectifs sont disponibles en suivant ce LINK.
Token d'autorisation	Un authorization token est requis pour envoyer des paramètres supplémentaires. En allant dans l'interface de Matomo, il est recommandé de créer un utilisateur spécifiquement pour accéder au "Tracking API", et de donner à l'utilisateur Par conséquent, vous devez déclarer une variable interne A, sur laquelle se base une variable interne B, avant la variable B. La variable B a besoin que la variable A soit déclarée en premier afin de s’exécuter sans créer d’erreurs. write permission sur le(s) site(s). Plus de détails sur les paramètres supplémentaires sont disponibles en suivant ce LINK.

[1] En utilisant des "dots" (".") vous pouvez naviguer plus profondément vers le champ spécifique dont vous souhaitez obtenir la valeur. Voir Events reference pour plus de détails sur les noms de champs standard par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a pas de limites.

Mappings de champs

Propriété Matomoe_cest définie statiquement avecca_event. Les paramètres Ecommerce sont transmis pour les purchase événements entrants.

Propriétés Commanders Act	Propriétés Matomo
Site Id	idsite
event_name	action_name e_a e_n
value	e_v revenue
page.location	url
device.user_agent	ua
Nom du cookie Visitor Id Valeur Visitor Id	_id [1]
page.referrer	urlref
Variables personnalisées Matomo	_cvars
user.id user.email user.email_md5 user.email_sha256 [custom_property]	uid [2]
search_term	search
Objectifs Matomo	idgoal [3]
id	ec_id
[[items.0.id,items.0.product.name,items.0.product.category_1,items.0.product.price,items.0.quantity],...,[items.N.id,items.N.product.name,items.N.product.category_1,items.N.product.price,items.N.quantity]]	ec_items [4]
revenue	ec_st
tax_amount	ec_tx
shipping_amount	ec_sh
Token d'autorisation	token_auth
device.ip	cip
event_timestamp	cdt

[1] Si un cookie n'est pas fourni, cette destination recherche un nom de cookie contenant la chaîne_pk_idpour en récupérer l'identifiant du visiteur. Alternativement, vous pouvez transmettre la valeur en utilisant une propriété datalayer. Voir Configuration pour plus de détails. &#xNAN;[2] Selon la sélection dans le menu déroulant (VoirIdentifiant utilisateurdansConfiguration), une propriété Commanders Act spécifique est utilisée. &#xNAN;[3] En fonction de votre configuration (VoirObjectifs Matomodans leConfiguration), un identifiant spécifique est défini dans ce champ. Avecpurchaseévénements,0est transmis comme identifiant. &#xNAN;[4] Le tableau résultant est encodé.