Règles générales d'implémentation

Règles générales d'implémentation

Ces règles s'appliquent à tous les marqueurs collector, quel que soit le type de tag implémenté.


Typage des variables

Toutes les valeurs — textuelles et numériques — doivent être entre guillemets ou apostrophes. Les valeurs true et false sont interdites.
EA_push([
  'param1', 'valeur1',
  'amount', '23.00'
]);

Pour indiquer qu'une valeur est nulle ou non applicable, utilisez "-" et non "0". Une valeur vide est également acceptée si le paramètre ne doit pas être pris en compte.


Syntaxe du tableau de paramètres

  • Les paramètres sont passés en paires clé / valeur — le nombre total d'éléments dans le tableau doit toujours être pair.
  • Il n'est pas possible de passer une liste de valeurs pour un seul paramètre : déclarez autant de paramètres que de valeurs.
  • La syntaxe doit respecter le JavaScript standard.
/* ERREUR — virgule en fin de liste */
EA_push([ 'clef1', 'valeur1', 'clef2', 'valeur2', ]);

/* ERREUR — virgule en début de liste */
EA_push([ ,'clef1', 'valeur1', 'clef2', 'valeur2' ]);

/* ERREUR — virgule manquante entre clef2 et valeur2 */
EA_push([ 'clef1', 'valeur1', 'clef2' 'valeur2' ]);

/* ERREUR — double virgule */
EA_push([ 'clef1', 'valeur1', 'clef2',, 'valeur2' ]);

/* VALIDE */
EA_push([ 'clef1', 'valeur1', 'clef2', 'valeur2' ]);



Règles de valorisation

Valeurs numériques

  • Séparateur décimal : point (pas de virgule) — "20.45" et non "20,45"
  • Montants en valeur nominale, pas en centimes — "1002" et non "1 002"
  • Toujours en TTC, jamais en HT
EA_push([ 'amount', '20.45' ]);


Valeurs textuelles

  • Pas de codes HTML (ex : > est interdit)
  • Caractères accentués à remplacer : é è ê ë → e / à â → a / ù ü û → u / ô → o / ï î → i / ç → c
  • Espaces remplacés par _
  • Autres caractères spéciaux remplacés par -
  • Tout en minuscules


Contexte d'appel

Le marqueur collector doit toujours être positionné à l'intérieur de la balise <body>, sans quoi il ne sera pas exécuté.


Balise noscript et format image / iframe

La balise <noscript> fournit un contenu de remplacement pour les navigateurs qui ne peuvent pas — ou ne veulent pas — exécuter du JavaScript.
  • Si le script s'exécute correctement, la balise <noscript> est ignorée.
  • Si le JavaScript est désactivé, la balise <noscript> prend le relais et permet de comptabiliser normalement les hits et conversions.

Paramètres obligatoires

Paramètre
Rôle
&url=
URL de la page courante (au minimum le nom de domaine). Si la valeur ne correspond pas au domaine, aucune donnée ne sera comptabilisée.
&rf=
Référent de la page courante — permet de remonter et catégoriser le trafic naturel.
Cachebuster
Valeur aléatoire à insérer dans l'URI pour éviter la mise en cache : //domain.client.tld/collector/-/VALEUR_ALEATOIRE.html

Personnalisation

Vous pouvez ajouter autant de paramètres que souhaité via des paires clé-valeur dans l'URL de l'iframe ou de l'image :
&cle1=valeur1&cle2=valeur2&cle3=valeur3

Certains paramètres natifs JavaScript ont un nom différent dans le format noscript / iframe / image :
Format JS standard
Format iframe / image
path
urlp
scartcumul
sccumul
currency
cur
prdref
prdrX
prdname
prdnX
prdquantity
prdqX
prdamount
prdaX
prdparam
prdpXkY et prdpXdY
isearchengine
eise
isearchkey
eiskX
isearchdata
eisdX
actionref
actr
error
pgerr