Comment mettre en place un tracking server-side ?

Cette FAQ vous donne quelques lignes directrices, mais si vous avez un projet d'implémentation server-side, n'hésitez pas à contacter l'équipe Support.

Qu'est-ce que le server-side ?

Le marquage server-side consiste à collecter les données générées par un internaute lors de sa visite sur un site web, en les faisant d'abord transiter par un serveur web (ou un autre type de serveur), avant de les transmettre au serveur de destination. Ce mode de collecte vise à exécuter le minimum de tâches possible dans le navigateur.

Le client-side, lui, s'appuie sur les navigateurs et le déclenchement de tags, transmettant ainsi les informations directement depuis le navigateur de l'utilisateur (serveur web) vers le serveur de marquage.

Pourquoi implémenter un marquage server-side ? Ou pas ?

Avantages 👍	Inconvénients 👎
Amélioration des performances du site web : les tags déclenchés impactent les performances du site et augmentent le temps de chargement.	Vous devez gérer votre propre serveur.
Meilleur contrôle de la sécurité des données.	Plus complexe à mettre en place, vous ne bénéficiez plus des méthodes par défaut du SDK Piano.
Un moyen de contourner les adblockers (amélioration de la fiabilité et du volume).	Vous devez reconstruire vos hits (crafted hit) via l'API de Collecte (tagless).
Possibilité d'enrichir les données pendant la collecte.	Vous devez mettre en place des méthodes pour identifier les visiteurs et gérer les cookies d'identification.
Meilleure capacité à poser des cookies sur la plupart des navigateurs lorsque les requêtes passent par votre propre domaine/serveur.	Aucune information native collectée par défaut.
	La logique de privacy est à reconstruire.

Implémentation server-side avec Piano Analytics

Il est possible d'implémenter le tracking server-side avec Piano Analytics. La collecte de données server-side peut être gérée via un TMS comme Tagcommander, GTM, TEALIUM ou directement sur votre site web.

On peut distinguer plusieurs scénarios pour le tracking server-side. Certains clients ont tendance à utiliser le SDK Piano avec le tracking server-side ; cette pratique n'est pas recommandée lorsque l'objectif est de contourner les adblockers, car la librairie SDK est toujours chargée et transmet les données via son propre serveur avant de les transférer vers le serveur Piano (comportement similaire au CDDC). Le tracking sera toujours bloqué par les adblockers à cause de la librairie CDN.

Cependant, certaines approches hybrides existent sur le marché (par exemple, collecter les événements dans le navigateur et router la requête via votre propre serveur). Si vous combinez tracking client-side et server-side, assurez-vous que les événements ne sont pas dupliqués : si une même action utilisateur déclenche à la fois un hit client-side et un hit server-side, les chiffres seront surestimés. Rediriger un seul hit via votre propre serveur est différent de déclencher deux hits distincts — évitez d'implémenter les deux pour une même action, sauf si vous avez une stratégie de déduplication claire.

Patterns courants de routage server-side (vue d'ensemble)

Selon votre infrastructure et vos contraintes, le tracking server-side est généralement implémenté en routant les requêtes via votre propre domaine/serveur avant de les transmettre à Piano. Les approches incluent :

Reverse proxy / routage via CDN (souvent le plus efficace en termes de fiabilité) : les requêtes sont routées via votre propre infrastructure, ce qui peut faciliter le dépôt de cookies et réduire le blocage, car les requêtes apparaissent comme first-party pour le navigateur.
CNAME / délégation de domaine : même objectif (apparence first-party), mais peut être plus limité selon la configuration et les contraintes de gouvernance.

La configuration exacte dépend de votre infrastructure. Si vous utilisez les fonctionnalités server-side de Commanders Act/Tag Commander, consultez Commanders Act pour des recommandations d'intégration spécifiques à leur produit server-side.

Étapes d'implémentation server-side

Voici les étapes à suivre pour implémenter le tracking server-side :

Configurer un serveur de collecte interne.
Collecter les données avec vos propres méthodes.
Envoyer les données collectées à votre serveur.
Implémenter le tracking avec l’API de Collecte
Transférer les données vers notre serveur.

Logique du tracking server-side

Pour contourner les adblockers, il est important d'envoyer les données au format brut vers le serveur du client ; les données ne doivent pas prendre le format d'événements Analytics. Vous devrez ensuite les traduire dans un langage compréhensible par notre serveur en utilisant des requêtes POST HTTPS de notre Collection API.

Lorsque vous réalisez une implémentation server-side, vous ne pourrez pas vérifier les hits dans le navigateur (onglet réseau de l'outil d'inspection). Vous devrez passer par notre outil Stream Inspector.

Server-side et privacy

L'implémentation du server-side ne change en rien les précautions à prendre pour respecter les restrictions RGPD et CNIL. Que les informations soient transmises depuis un navigateur ou un serveur, le consentement de l'utilisateur doit être obtenu.

Les obligations des éditeurs de sites restent les mêmes, à savoir :

Informer l'utilisateur explicitement de la collecte de données
Obtenir un consentement explicite
Proposer un opt-out

Il est à noter que, nos méthodes n'étant plus valables dans ce contexte server-side, vous devrez reconstruire la logique de privacy et configurer vos propres méthodes afin d'envoyer une propriété donnée dans un mode spécifique (gérer le strictement nécessaire pour le mode exempt par exemple).

Le RGPD interdit le transfert de données hors d'Europe sans consentement. Pour les clients souhaitant bénéficier de l'exemption dans le cadre du tracking server-side avec un serveur situé hors d'Europe, ils doivent vérifier la faisabilité de l'implémentation.

Server-side et source

Vous devez transmettre l'URL précédente du premier accès afin de bénéficier de l'analyse des sources. Pour les sources marketing, le tracking reste le même. Vous devez tracker les campagnes avec les paramètres at_ ou utm_.