Paramètres natifs du collector web

Paramètres natifs du collector web

Les paramètres natifs permettent de transmettre au collector Eulerian les données liées aux pages, actions, produits, paniers, devis, commandes et recherches internes. Les noms, formats et valeurs attendues doivent être respectés.

Actions et conversions secondaires

Paramètre
Alias no-script
Description
Exemple
actionname
actn[0-n]
Identifiant de l’action. Ne pas utiliser de guillemets, apostrophe, astérisque, dollar, arobase, esperluette, tilde, accent grave, point d’interrogation, point d’exclamation ou accent circonflexe.
actionname=my_action_name
actionlabel
actl[0-n]
Labels permettant de classer l’action. Jusqu’à 5 valeurs séparées par des virgules. Leur ordre détermine le label renseigné.
actionlabel=newslettersubscribe,pagebottom,bold
actionmode
actm[0-n]
Mode de l’action : in ou out. Si le paramètre est absent, l’action est considérée comme OneShot.
actionmode=in
actionpfinite
actp[0-n]f[0-n]
Indique si un paramètre d’action possède un nombre fini de valeurs. Valeur booléenne, égale à 1 par défaut.
actionpfinite=1
actionpname
actp[0-n]n[0-n]
Nom d’un paramètre associé à l’action. Une action peut contenir plusieurs paramètres.
actionpname=my_new_param
actionpvalue
actp[0-n]v[0-n]
Valeur du paramètre déclaré avec actionpname.
actionpvalue=param_value
actionref
actr[0-n]
Référence unique de la conversion secondaire. Elle permet de dédupliquer l’action en cas de nouvel appel, par exemple après un rafraîchissement de page.
actionref=CRV134567
La valeur de actionref doit être unique. À défaut de référence métier, elle peut être construite à partir d’un identifiant client et d’un timestamp.

Commandes et devis

Paramètre
Alias no-script
Description
Exemple
ref
ref
Référence unique de la commande ou du devis. Obligatoire sur les pages de confirmation. Un second appel utilisant la même référence est ignoré.
ref=C12345678
amount
amount
Montant total TTC de la conversion. Utiliser le montant nominal, sans séparateur de milliers, avec un point pour les décimales.
amount=45.90
currency
cur
Devise correspondant au montant transmis. Eulerian convertit ensuite ce montant vers la devise cible configurée dans l’interface.
currency=GBP
estimate
estimate
Identifie la conversion comme un devis et non comme une vente. Obligatoire sur une page de devis. Valeur fixe : 1.
estimate=1
margin
margin
Montant de la marge réalisée sur la commande, avec au maximum deux décimales.
margin=12.34
newcustomer
nc
Indique si la conversion concerne un nouveau client : 1 pour un nouveau client, 0 dans les autres cas.
newcustomer=1
payment
payment
Moyen de paiement utilisé. Paramètre facultatif, exploitable comme filtre dans les rapports.
payment=CB
status
status
Statut de la commande : VALID, PENDING ou INVALID. Sans valeur, le statut par défaut est PENDING.
status=INVALID
type
type
Catégorie libre de la vente ou du devis. La valeur est N/A si le paramètre est absent.
type=marketplace
Les métriques de ventes réelles et de chiffre d’affaires réel prennent en compte les commandes PENDING et VALID, mais pas les commandes INVALID.
L’utilisation de status doit être validée avec l’interlocuteur Eulerian en charge du compte.

Devises

Les valeurs utilisées pour currency correspondent aux codes de devises, par exemple :
AUD
BRL
CAD
CHF
EUR
USD
XOF
GBP
JPY
RUB


Panier

Paramètre
Alias no-script
Description
Exemple
scart
scart
Identifie la page comme une page panier et comptabilise un panier commencé. Valeur obligatoire et fixe : 1.
scart=1
scartcumul
sccumul
Définit la méthode de mise à jour du panier : 1 pour le mode cumulé, 0 pour le mode non cumulé. La valeur par défaut est 1.
scartcumul=0
scartdur
ttl
Modifie la durée de vie du panier, fixée à 30 minutes par défaut. La valeur doit être exprimée en minutes (m) ou en jours (d).
scartdur=50m

Modes de mise à jour du panier

Mode cumulé — scartcumul=1
Chaque appel ajoute ou retire des produits du panier existant.
Mode non cumulé — scartcumul=0
Chaque appel contient l’intégralité du panier. Un produit absent du nouvel appel est considéré comme retiré.

Produits

Paramètre
Alias no-script
Description
Exemple
prdref
prdrX
Référence du produit consulté ou présent dans une liste, un panier, un devis ou une commande.
prdref=produit1
prdamount
prdaX
Montant unitaire du produit. Il ne doit pas contenir le montant total calculé pour plusieurs unités.
prdamount=29.90
prdquantity
prdqX
Nombre d’unités de la référence produit concernée.
prdquantity=3
prdname
prdnX
Nom lisible associé à une référence produit.
prdname=nom_du_produit
prdparam-*
prdpXkX / prdpXdX
Catégorie ou attribut associé à une référence produit, par exemple l’univers, la taille ou la catégorie.
prdparam-univers=femme
prdgroup
prdgX
Groupe anonyme associé à une référence produit. Une référence ne peut appartenir qu’à un seul groupe.
prdgroup=A

Référentiel produit

Le même référentiel doit être utilisé dans les marqueurs produit, panier, devis et commande, ainsi que dans les données transmises aux partenaires.
Sur une fiche produit, prdref ne doit être transmis qu’une seule fois. Plusieurs références dans le même appel font considérer la page comme une liste de produits.

Blocs produit

Dans un panier, un devis ou une commande, chaque référence doit être associée à sa propre quantité et à son propre montant unitaire.
Exemple no-script :
prdr0=produit1
prda0=29.90
prdq0=3

prdr1=produit2
prda1=10.00
prdq1=1


Données produit rétroactives

Les associations transmises avec prdname et prdparam-* sont appliquées aux occurrences historiques de la référence produit.
Une nouvelle valeur remplace la précédente et modifie donc l’affichage des périodes antérieures. Ces paramètres ne doivent pas recevoir des valeurs différentes selon le type de page.

Moteur de recherche interne

Paramètre
Alias no-script
Description
Exemple
isearchengine
eise
Nom du moteur de recherche interne. Il doit avoir été déclaré dans l’interface.
isearchengine=moteur_interne
isearchkey
eiskX
Nom d’un paramètre de recherche préalablement déclaré.
isearchkey=categorie
isearchdata
eisdX
Valeur associée au paramètre isearchkey.
isearchdata=veste
isearchresults
eiskX=results et eisdX=<nombre>
Nombre de résultats retournés par la recherche. Paramètre facultatif.
isearchresults=15
Les paramètres isearchkey et isearchdata doivent être transmis par paire.
Exemple no-script :
eise=moteur_interne
eisk0=categorie
eisd0=veste
eisk1=matiere
eisd1=cuir
eisk2=results
eisd2=15


Pages et navigation

Paramètre
Alias no-script
Description
Exemple
path
urlp
Remplace le nom de page normalement extrait de l’URL. Les niveaux de l’arborescence sont séparés par /.
path=/vetements/veste/collection-hiver
pagegroup
pagegroup
Associe la page à un groupe de pages. Cette valeur prend le pas sur les règles de regroupement configurées.
pagegroup=categorie_femme
pagelabel
pglbl
Ajoute jusqu’à 5 labels à la page. Les valeurs sont séparées par des virgules et leur ordre est significatif.
pagelabel=label1,label2,label3
error
Voir le point d’attention
Identifie la page comme une page d’erreur et permet de stocker son URL pour le rapport des pages en erreur.
error=1
from
from
Force l’affectation du trafic à un site Eulerian précis, notamment lorsque plusieurs sites partagent le même domaine.
from=siteclient2
path est notamment utile lorsque :
  • plusieurs pages ne peuvent pas être distinguées par leur URL ;
  • le contenu dépend de paramètres CGI qui ne sont pas intégrés au nom de page ;
  • un nouvel appel collector est déclenché sur la même page.
Point à confirmer — Paramètre d’erreur
Le paramètre JavaScript est nommé error. Les indications no-script disponibles mentionnent à la fois err et l’exemple pgerr=1. Le nom no-script attendu doit être vérifié avant implémentation.

Profils, propriétés et identification

Paramètre
Alias no-script
Description
Exemple
profile
profile
Déclenche un changement vers un profil préalablement déclaré dans l’interface.
profile=nouveau_client
propertyname
epronX
Nom d’une propriété site-centric préalablement déclarée.
propertyname=genre
propertyvalue
eprovX
Valeur associée à la propriété. Plusieurs valeurs peuvent être envoyées dans un même appel.
propertyvalue=film_d_horreur
uid
uid
Identifiant client stable utilisé pour consolider l’historique de navigation entre plusieurs appareils.
uid=65772
email
eemail
Adresse email pouvant être utilisée par certains flux, connecteurs ou requêtes API. Si elle est transmise pendant la session, elle est disponible dans les données de ventes, devis et paniers.
email=mail@site.com
Le uid :
  • doit identifier un seul utilisateur ;
  • doit rester identique pour un même utilisateur ;
  • ne doit pas être un identifiant de session ou une valeur temporaire ;
  • peut être transmis lorsque l’utilisateur est authentifié.

Contrôle du collector

Paramètre
Description
Valeur
enoepm
Désactive Eulerian Privacy Manager pour l’appel collector concerné.
1
enoetm
Désactive Eulerian Tag Manager pour l’appel collector concerné.
1
enotrack
Désactive toute la collecte site-centric de l’appel, y compris les pages vues, visites, paniers, devis et ventes. Les tags tiers du TMS continuent à être appelés.
1
enopagedt
Désactive la comptabilisation du trafic site-centric de l’appel, notamment les pages vues et les visites. Les tags tiers du TMS continuent à être appelés.
1
etagid
Identifiant ajouté automatiquement lorsqu’un tag est créé depuis l’interface de gestion des tags site-centric. Il permet d’utiliser les fenêtres de recette.
Généré automatiquement
onload
Fonction JavaScript exécutée après le retour de l’appel collector.
function(){ console.log("Eulerian collector is done"); }

Forcer un levier d’acquisition

Le paramètre eope force l’ajout d’un levier d’acquisition dans l’historique de navigation.
Il doit contenir un code de tracking chiffré récupéré depuis un lien de tracking Eulerian.
eope=<CODE_DE_TRACKING>

Cette fonctionnalité doit être utilisée uniquement sur recommandation de l’interlocuteur Eulerian en charge du compte.

Ajouter un segment entrant

Les paramètres suivants peuvent compléter eope :
Paramètre
Description
eseg-name
Nom du segment entrant, par exemple id_affilie.
eseg-item
Valeur du segment, par exemple 123456789.
Ils doivent être placés après eope :
[
"eope", "CODE_DE_TRACKING",
"eseg-name", "id_affilie",
"eseg-item", "123456789"
]