Guide d'implémentation générique du plan de marquage web server-side Eulerian

1. Introduction Eulerian Measurement Protocol permet d’envoyer des données analytiques directement depuis votre conteneur Server-Side (sGTM, sTealium) vers Eulerian Analytics (voir ﻿ ⁠⁠Quels sont les avantages d'une implémentation en Server-Side ?⁠ ).
Attention : Avant de passer au marquage server-side, assurez-vous que vous n’avez pas besoin des fonctionnalités client-side (synchronisation d'identité, heatmap, etc.), car les appels serveur ne permettent pas l'exécution de scripts côté client.
﻿
2. Configuration du protocole de mesure2.1 Structure des requêtesLes données sont envoyées par des requêtes HTTP POST ou GET au serveur de tracking Eulerian.
Le format d’URL est le suivant :
https://TRACKING_HOSTNAME/TYPE/WEBSITE_NAME/
Exemple pour un site nommé demo-site avec un serveur de tracking dem.eulerian.net :
https://dem.eulerian.net/collector/demo-site/
Recommandé : Utiliser POST (permet d’envoyer plus de données).
Alternative : Utiliser GET si POST n'est pas possible. 
Exemple de requête POSTUser-Agent: Mozilla/5.0
POST https://dem.eulerian.net/collector/demo-site/
Body: key1=val1&key2=val2
Exemple de requête GETGET /collector/demo-site?key1=val1&key2=val2 HTTP/1.1
Host: dem.eulerian.net
User-Agent: Mozilla/5.0
Si vous utilisez une bibliothèque personnalisée pouvant être identifiée comme un robot (comme cURL ou wget), l'appel ne sera pas enregistré. Fournissez donc un user-agent spécifique ou un user-agent standard pour remplacer celui par défaut de votre bibliothèque cliente, afin que l'appel puisse être effectué. (ex. : Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:71.0) Gecko/20100101 Firefox/71.0)
2.2 Codes de réponse2xx : Requête reçue avec succès.
Autre : Vérifier et corriger l’erreur avant de réessayer.
﻿
3. Données à envoyerLes données envoyées à Eulerian doivent être UTF-8 et URL encodées sous forme de paires clé-valeur (param1=val1&param2=val2).
Par exemple, pour envoyer la clé urlp avec la valeur /my page €, il faut d'abord s'assurer qu'elle est encodée en UTF-8, puis en URL, ce qui donne :
urlp=%2Fmy%20page%20%E2%82%AC
3.1 Identification des utilisateursEulerian Analytics permet au client d'utiliser plusieurs types d'identifiants pour maintenir l'identité sur la plateforme et garantir l'agrégation des données à la bonne identité.
Par conséquent, il est nécessaire de fournir des paramètres d'identité spécifiques dans chaque hit afin de maintenir l'identité utilisateur tout au long de la navigation courante (et des navigations à venir).
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Device ID
euidl
Identifiant anonyme de l'utilisateur
n/a
Oui
d213be2e-053f-4bfb-9c32-1bd6efb5687e
Customer ID
uid
Identifiant client connu
n/a
Non
customer123
3.2 Paramètres de ReplayCes paramètres permettent d’écraser certaines valeurs par défaut afin d’insérer les données du client plutôt que celles du serveur.
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Horodatage du hit
ereplay-time
Horodatage (timestamp Unix) auquel le hit a été enregistré.
L’heure actuelle du serveur de collecte des données.
Oui
1599210524
IP du client
ereplay-ip
Adresse IP du client ayant généré le hit. Si non fourni, cela affectera la résolution géographique.
L’adresse IP du serveur générant le hit.
Oui
12.236.2.65
User-Agent du client
ereplay-ua
User-Agent du client ayant généré le hit. Si non fourni, cela impactera la résolution et le filtrage des appareils.
n/a
Non, à condition que le paramètre ereplay-mdevicetype soit renseigné
Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:71.0) Gecko/20100101 Firefox/71.0
Type de device du client
ereplay-mdevicetype
Si ereplay-ua ne peut pas être fourni, il est possible d’indiquer manuellement le type d’appareil afin d’assurer un bon filtrage des appareils.
n/a
Non, à condition que le paramètre ereplay-ua soit renseigné
Desktop, Phone, Tablet, Tv, AppNativeAndroidphone, AppNativeIOSphone, AppNativeAndroidtablet, AppNativeIOStablet
3.3 Gestion du consentementLes paramètres de consentement doivent être présent pour 100% des appels envoyés vers Eulerian.
Ces paramètres permettent d’implémenter la gestion du consentement via l’API du Measurement Protocol.
Assurez-vous que le gestionnaire de consentement sélectionné et configuré pour le site cible est le bon.
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Désactiver la gestion du consentement
enoepm
Si défini à 1, la gestion du consentement est désactivée et toutes les données sont collectées.
n/a
Non
1
Consentement TCFv2
gdpr_consent
Permet d’envoyer la chaîne TCFv2 complète telle que définie dans le cadre du TCF.
n/a
Oui sauf si paramètre pmcat est présent
CPjTJ1aPjTJ1aOhAAAENCZCgAAAAAAAAAAAADOwAQDOgAAAA.YAAAAAAAAAA
Catégories interdites
pmcat
Permet de spécifier les catégories désactivées pour l'utilisateur. Il s’agit des mêmes ID que ceux définis dans l’interface utilisateur.
n/a
Oui sauf si paramètre gdpr_consent est présent
89-5-3
Autoriser toutes les catégories
pmcat=-
Permet d’autoriser toutes les catégories disponibles pour l’utilisateur. La valeur doit être définie sur -.
n/a
Non
-
4. Implémentation du plan de marquage4.1 Suivi générique pour toutes les pagesCes paramètres peuvent être fournis dans toutes les requêtes envoyées à Eulerian.
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
URL de la page
url
Utilisé pour envoyer l’URL complète (document location) de la page où se trouve le contenu.
n/a
Oui
https://www.eulerian.com/page/to/awesome/content
Nom de la page
urlp
Permet de définir un nom de page spécifique lorsque l’URL n’est pas assez descriptive ou qu’elle nécessite un nettoyage.
n/a
Non
/page/to/awesome/content
Groupe de pages
pagegroup
Permet d’attribuer un groupe de pages spécifique. Peut être configuré directement depuis la plateforme Eulerian sur la base des noms de page?
n/a
Non
FAQ
Label de la page
pglbl
Vous disposez de 5 labels pour chaque page. Les labels sont envoyés dans une chaine de caractères et sont séparés par une virgule. (pglbl=sport,football,madrid). L'ordre des labels est important car il indique quel id de pagelabel sera renseigné. Cet ordre doit être maintenu sur toutes les pages du site.
n/a
Non
content, faq, attribution, meta
Tous les paramètres de suivi des sections 4.2, 4.3, 4.4 et 4.5 doivent être intégrés au sein du même appel, en complément des paramètres de suivi génériques.
﻿
4.2 Suivi des sources de trafic pour l'attributionLes sources de trafic doivent être fournies via les paramètres ajoutés sur la page de destination.
Cette page de destination intégrale (incluant les paramètres de tracking publicitaire doit être refournie au paramètre url.
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Tous les paramètres de campagnes
param1
param2
...
Paramètres de tracking publicitaires Eulerian, Google Analytics, autres.
n/a
Oui
http://maboutique.com/?param1=abc&param2=xyz...
Référent
rf
URL source (SEO)
n/a
Oui
https://www.bing.com/query?kw=eulerian
﻿
﻿
4.3 Suivi des conversionsCes paramètres sont nécessaires pour suivre les conversions. Eulerian prend en charge les types de transactions suivants :
order : Lorsqu’une vente est réalisée.
estimate : Lorsqu’un devis, une estimation ou une demande de lead est généré(e).
scart : Lorsqu’un panier d’achat est créé.
﻿﻿⚠ Les appels sont mutuellement exclusifs : une requête ne peut pas contenir scart=1&estimate=1&order=1.
Il faut s’assurer qu’un seul de ces paramètres est défini à 1 par requête.
Paramètres des conversions
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
ID de la transaction
ref
Identifiant unique de la transaction.
None
Oui (order ou estimate)
518fbb68-707e-4baa-ab46-de3499786751
Montant de la transaction
amount
Revenu total associé à la transaction, incluant frais de livraison et taxes.
0
Oui (order ou estimate)
321.32
Commande
order
Doit être défini à 1 pour indiquer une transaction de vente. Exclusif aux paramètres estimate et scart.
0
Oui (order)
1
Devis
estimate
Doit être défini à 1 pour indiquer une estimation / devis. Exclusif aux paramètres order et scart.
0
Oui (estimate)
1
Récapitulatif panier d’achat
scart
Doit être défini à 1 pour indiquer la création d’un récapitulatif panier. Exclusif aux paramètres order et estimate.
Oui (scart)
1
Récapitulatif panier d’achat
sccumul
Doit être défini à 0 pour indiquer la création d’un récapitulatif panier. 
Oui (scart)
0
Statut de la conversion
status
Indique le statut de la transaction.
PENDING
Oui (order ou estimate)
VALID / PENDING / INVALID
Type de commande / estimation
type
Description du type de commande ou estimation. Exclusif aux paramètres order et estimate.
None
Non
code-promo
Mode de paiement
payment
Méthode de paiement utilisée pour la commande.
None
Non
Paypal
Marge
margin
Valeur de la marge pour la commande ou l’estimation. Exclusif aux paramètres order et estimate.
None
Non
29.00
Produits
Voir 4.4
Voir 4.4
Voir 4.4
Voir 4.4
Voir 4.4
Bonnes pratiques﻿﻿ S'assurer qu'une seule valeur entre order, estimate et scart est définie à 1﻿﻿﻿ Vérifier que l'ID transactionnel (ref) est unique pour chaque commande﻿﻿﻿ Inclure le mode de paiement si pertinent (payment)
﻿﻿ Inclure les boucles de produits
﻿
4.4 Suivi des produitsUn appel sans paramètres de conversion et qui contient une seule référence produit sera identifié comme une page produit.
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Nom du produit
prdn<productIndex>
Nom du produit lorsque la page actuelle est une page produit.
n/a
Oui
my-blue-shoes
Référence du produit (SKU)
prdr<productIndex>
Référence SKU du produit lorsque la page actuelle est une page produit.
n/a
Oui
123456
Groupe du produit
prdg<productIndex>
Paramètre natif pour les groupements de produits. Permet de définir un taux de marge par Groupe de produit
n/a
Non
﻿
shoes
Prix du produit
prda<productIndex>
Prix du produit. Utilisé uniquement pour les appels scart, estimate et order. Obligatoire si prdr<productIndex> est fourni.
n/a
Oui
199.00
Quantité du produit
prdq<productIndex>
Quantité du produit. Utilisé uniquement pour les appels scart, estimate et order. Obligatoire si prdr<productIndex> est fourni.
n/a
Oui
2
Clé d'un paramètre produit personnalisé
prdp<productIndex>k<productParamIndex>
Clé d’un paramètre personnalisé pour le produit, par exemple une catégorie.
n/a
Non
marque
Valeur d'un paramètre produit personnalisé
prdp<productIndex>d<productParamIndex>
Valeur du paramètre personnalisé pour le produit dans la catégorie spécifiée.
n/a
Non
jordan
﻿
4.5 Suivi avancé des parcours de navigation
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Subkey2
custom_param
Principale clé de segmentation du trafic
n/a
Non
audience intentionnelle
audience consultative
﻿
4.5 Suivi des requêtes du moteur de recherche interne
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Nom du moteur de recherche interne
eise
Nom du moteur de recherche interne
n/a
Oui
mon moteur interne
Nombre de résultats
eisr
Valeur numérique pour le nombre de résultat de la requête courante
n/a
Non
13
Clé du paramètre de recherche #x
eisk<index>
Clé du paramètre de recherche #x
n/a
Oui
arrivee
Valeur du paramètre de recherche #x
eisd<index>
Valeur du paramètre de recherche #x
n/a
Oui
bordeaux
﻿
4.6 Suivi avancé :Dimensions Personnalisées (Dimension Explorer) & Segments UtilisateursPour chaque page vue vous pouvez ajouter des paramètres personnalisés en respectant le format suivant : clé=valeur
Ces paramètres personnalisées peuvent ensuite être déclarés en tant que : Dimensions Personnalisées ou Segments Utilisateurs.
﻿
4.7 Suivi des événements :Ces paramètres doivent être inclus dans toutes les requêtes d’événements.
Nom
Paramètre
Description
Valeur par défaut
Obligatoire
Exemple
Nom de l'action
actn<index>
Nom de l'action. <index> démarre à 0.
n/a
Oui
utilisateur loggué
Mode de l'action
actm<index>
Permet de construire des entonnoirs fermés. Ne pas utiliser pour un comptage d'événements simples.
n/a
Non
Entonnoir fermé : in, out
Comptage simple : néant
Label de l'action
actl<index>
Une action peut être caractérisée par un ou plusieurs labels. La position <index> détermine le label ciblé.
n/a
Non
téléchargement contenu
Référence unique de l'action
actr<index>
Permet d'enregistrer en Datamining une référence unique pour cette action et les paramètres associés.
n/a
Non
Paramètre de l'action
actp<index>n<index>
Permet de déclarer un paramètre pour l'action.
n/a
Non
brochure
Valeur de du paramètre de l'action
actp<index>v<index>
Permet de déclarer une valeur de paramètre pour  l'action.
n/a
Non
formation finance
Type de paramètre de l'action
actp<index>f<index>
Permet de déclarer ce paramètre comme ayant un nombre de valeurs finies. Nécessaire pour stocker les valeurs dans Eulerian.
1
Non
﻿