Matomo

Matomo, anciennement Piwik, est une application d'analyse web open source permettant de suivre les visites en ligne sur un ou plusieurs sites web et d'afficher des rapports sur ces visites pour analyse. En utilisant cette destination, vous pouvez implémenter un tracking 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 Matomo, ce qui signifie que vos données sont correctement mappées vers les champs attendus de manière optimisée.

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

• Hachage automatique : les informations sont automatiquement hachées conformément aux 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 selon vos besoins spécifiques.

• Support des données multi-item: les informations incluses dans le item array est transmis à Matomo.

Configuration de la destination

Matomo recommande d'utiliser des paramètres personnalisés plutôt que des variables personnalisées car ces dernières sont dépréciées. Les données pour certains champs optionnels 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	Requis Le domaine de votre serveur tel que fourni par Matomo. (Par exemple pour https://votre-domaine-matomo.example/matomo.php, incluez uniquement la chaîne bleue).
Site Id	Requis L'identifiant de votre site tel que fourni par Matomo. Plus de détails sont disponibles en suivant ceci LINK.
Nom du cookie Visitor Id	Nom du cookie contenant quelques informations sur l'utilisateur telles que 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 ceci LINK. (Par exemple valeur "4e4eb04b31f37eac.1653656637.")
Valeur Visitor Id	La valeur de l'identifiant unique du visiteur si vous devez la transmettre sans cookie.
Identifiant utilisateur	Vous pouvez transmettre l'identifiant utilisateur de votre choix pour les utilisateurs connectés. Plus de détails sont disponibles en suivant ceci 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 ceci 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 ceci 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é. Plus de détails sur les objectifs sont disponibles en suivant ceci LINK.
Token d'autorisation	Un token d'autorisation 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 à cet utilisateur seulement écriture permission sur le(s) site(s). Plus de détails sur les paramètres supplémentaires sont disponibles en suivant ceci LINK.

[1] En utilisant des "dots" (".") vous pouvez naviguer plus profondément jusqu'au 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.

Mappages de champs

Propriété Matomoe_cest défini statiquement avecca_event. Les paramètres e-commerce sont transmis pour les purchase events.

Propriétés Commanders Act	Propriétés Matomo
Site Id	idsite
event_name	action_name e_a e_n
valeurs	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 récupérer l'identifiant du visiteur à partir de celui-ci. Alternativement, vous pouvez passer la valeur en utilisant une propriété datalayer. Voir Configuration pour plus de détails. [2] Selon la sélection dans le menu déroulant (VoirIdentifiant utilisateurdansConfiguration), une propriété Commanders Act spécifique est utilisée. [3] En fonction de votre configuration (VoirObjectifs Matomodans leConfiguration), un identifiant spécifique est défini dans ce champ. Avecpurchaseevents,0est transmis comme identifiant. [4] Le tableau résultant est encodé.