Format JSON Standard

Format JSON Standard



Ce document décrit le format JSON standard utilisé par Eulerian pour transmettre des données à des solutions de Business Intelligence.
Ce modèle est utilisé lorsqu’un connecteur de type BI est mis en place. Il permet d’envoyer les données sous une forme structurée, granulaire et exploitable par les outils externes.
Le format JSON standard contient notamment :
  • le type d’événement transmis ;
  • les informations utilisateur et device ;
  • les informations de navigation ;
  • les données marketing et d’attribution ;
  • les produits associés à l’événement ;
  • les paramètres personnalisés ;
  • les audiences et segments associés.
InfoCe modèle est amené à évoluer. De nouvelles clés peuvent être ajoutées dans le temps, mais les clés existantes et leur structure ne seront pas modifiées.


Objectif du format JSON standard

Le format décrit ci-dessous correspond au modèle standard d’envoi de données vers les solutions BI capables d’intégrer la donnée Eulerian dans sa forme la plus granulaire.
Chaque événement envoyé contient une structure JSON composée de champs communs et, selon le contexte, de champs spécifiques à la navigation, à la conversion ou aux produits.


Type d’appel

La clé type indique le type d’appel envoyé.
La liste des valeurs possibles est fixe.
Valeur
Description
click
Tous les clics sur des liens trackés Eulerian, par exemple clic, dynclick, etc.
view
Toutes les impressions trackées Eulerian, par exemple view, dynview, etc.
hit
Trafic site-centric. Correspond à toute page autre qu’une page order, estimate ou scart.
visit
Comme hit, mais indique qu’il s’agit de la première page d’une nouvelle visite.
order
Page de confirmation de commande.
estimate
Page de confirmation de devis.
scart
Page de panier commencé.


Description des champs envoyés

Les champs disponibles peuvent varier selon le type d’appel.
Certains champs sont présents dans tous les contextes, tandis que d’autres sont spécifiques aux événements site-centric ou aux conversions.


Champs communs

Ces champs peuvent être présents sur l’ensemble des types d’appels.
Champ
Type
Description
Exemple
type
STRING
Type d’appel envoyé.
click
epoch
TIMESTAMP
Date de l’événement au format epoch.
1450102413
eulerianid
INTEGER
Identifiant interne Eulerian.
489780172675333
euleriandeviceid
INTEGER
Identifiant du device.
998455384754733
uid
STRING
Identifiant unique de l’utilisateur.
123456
devicetype
STRING
Type d’appareil utilisé.
desktop
useragent
STRING
User agent de l’utilisateur.
Chrome
geo
STRING
Géolocalisation.
france
ip
STRING
Adresse IP.
80.150.10.3
profile
STRING
Profil de l’utilisateur.
looker, shopper, buyer
fullurl
STRING
URL complète associée à l’événement.
https://www.example.com/page


Champs liés au canal et à l’attribution

Ces champs décrivent le contexte marketing ou d’acquisition associé à l’événement.
Champ
Type
Description
Exemple
channel_c
STRING
Abréviation du levier.
ad
channel_publisher
STRING
Nom du support.
support
channel_ope
STRING
Nom de la campagne.
campagne-brand-fil-rouge
channel_creatxt
STRING
Nom de la bannière ou de la création.
150316-fr-brand
channel_loctxt
STRING
Nom de l’emplacement.
support-160x600
channel_referer
STRING
Domaine du référant de la première page vue.
https://example.com
channel_rfdom
STRING
Domaine référant ad-centric.
https://example.com
channel_rfdomuri
STRING
URI référante ad-centric.
/page
channel_seng
STRING
Moteur de recherche SEO.
Bing
channel_sengkw
STRING
Mot-clé SEO.
marque
channel_sikey
STRING
Segment entrant.
segmentation
channel_sival
STRING
Sous-segment entrant.
chaud
channel_slaccount
STRING
Nom du compte SEA.
Branding
channel_slcamp
STRING
Campagne SEM.
Marque-Bing
channel_sladgroup
STRING
Groupe de mots-clés.
marque
channel_slkw
STRING
Mot-clé SEM.
parfum voiture neuve


Champs site-centric

Ces champs sont principalement disponibles pour les appels de type hit, visit, order, scart ou estimate.
Champ
Type
Contexte
Description
Exemple
path
STRING
hit, visit, order, scart, estimate
Nom de page.
Shop/Step1
pagegroup
STRING
hit, visit, order, scart, estimate
Groupe de pages.
pageBasket


Produits

Les produits sont envoyés dans le champ product.
Ce champ contient une liste d’objets, chaque objet correspondant à un produit associé à l’événement.
Champ
Type
Contexte
Description
Exemple
product
ARRAY of OBJECTS
hit, visit, order, scart, estimate
Liste des produits.
[{"ref":"45835","price":"0","quantity":"1"}]
product.ref
STRING
hit, visit, order, scart, estimate
Référence produit.
4077075
product.price
FLOAT
hit, visit, order, scart, estimate
Prix du produit.
12.5
product.quantity
FLOAT
hit, visit, order, scart, estimate
Quantité du produit.
1

Exemple

"product": [
  {
    "ref": "1246310",
    "price": "",
    "quantity": "1"
  },
  {
    "ref": "1363092",
    "price": "",
    "quantity": "1"
  }
]



Paramètres personnalisés

Les paramètres personnalisés sont envoyés dans le champ customp.
Ce champ contient une liste d’objets avec une clé k et une valeur v.
Champ
Type
Contexte
Description
Exemple
customp
ARRAY of OBJECTS
hit, visit, order, scart, estimate
Liste des paramètres personnalisés.
[{"k":"age","v":"25-30"}]
customp.k
STRING
hit, visit, order, scart, estimate
Nom du paramètre personnalisé.
code-promo
customp.v
STRING
hit, visit, order, scart, estimate
Valeur du paramètre personnalisé.
123456

Exemple

"customp": [
  {
    "k": "email",
    "v": ""
  },
  {
    "k": "age",
    "v": "25-30"
  },
  {
    "k": "size",
    "v": "M"
  }
]



Audiences et segments

Les audiences et segments associés à l’utilisateur sont envoyés dans le champ cluster.
Ce champ est un objet contenant une liste de paires clé / valeur.
Champ
Type
Description
Exemple
cluster
OBJECT
Liste des audiences et de leurs segments respectifs.
{"audience":"segment"}

Exemple

"cluster": {
  "Actif newsletter": "Actif -30 jours",
  "Premium": "Client Premium +1 an"
}



Champs liés aux conversions

Ces champs sont disponibles principalement dans le cadre des appels de type order ou estimate.
Champ
Type
Contexte
Description
Exemple
amount
FLOAT
order, estimate
Montant de la conversion.
100
ref
STRING
order, estimate
Référence de conversion.
28923018
estimatetype
STRING
order, estimate
Type de devis.
option
orderpayment
STRING
order
Type de paiement.
CB
ordertype
STRING
order
Type de vente ou valeur liée au paramètre type de la conversion.
ancien_client
currency
STRING
order
Devise.
EUR


Exemples JSON

Les exemples ci-dessous illustrent les principaux types d’appels pouvant être envoyés dans le format JSON standard.


Exemple — click

{
  "devicetype": "Tablet",
  "wskey": "client-fr",
  "type": "click",
  "epoch": "1476762585",
  "eulerianid": "6742614185137654637",
  "euleriandeviceid": "98724774666436377383",
  "uid": "41771080",
  "useragent": "Mozilla/5.0 (iPad; CPU OS 9_3_5 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Mobile/13G36",
  "geo": "FRA8",
  "ip": "78.118.234.156",
  "profile": "Shopper",
  "channel_c": "ml",
  "channel_t": "c",
  "channel_publisher": "client-fr",
  "channel_ope": "NL-FR-CLIENTS-PREMIUM-161018",
  "channel_seng": "",
  "channel_sengkw": "",
  "channel_rfdom": "",
  "channel_rfdomuri": "",
  "channel_loctxt": "",
  "channel_creatxt": "",
  "channel_slkw": "",
  "channel_sikey": "category",
  "channel_sival": "premium",
  "channel_slcamp": "",
  "channel_sladgroup": "",
  "fullurl": "http://eulerian.client.fr/dynclick/client-fr/?eml-publisher=client-fr&eml-name=NL-FR-CLIENTS-PREMIUM-161018&eseg-name=category&eseg-item=premium&uid=41771080&eurl=http%3A%2F%2Fwww.client.fr%2Fofferpremium",
  "cluster": {
    "Actif newsletter": "Actif -30 jours",
    "Premium": "Client Premium +1 an"
  }
}



Exemple — view

{
  "devicetype": "Desktop",
  "wskey": "client-fr",
  "type": "view",
  "epoch": "1476741805",
  "eulerianid": "2764143871266801030",
  "euleriandeviceid": "2764143871266801030",
  "uid": "",
  "useragent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.143 Safari/537.36",
  "geo": "FR",
  "ip": "80.236.101.164",
  "profile": "",
  "channel_c": "ad",
  "channel_t": "v",
  "channel_publisher": "tradelab",
  "channel_ope": "TLAB_PROSPECTING_PROFILING",
  "channel_seng": "",
  "channel_sengkw": "",
  "channel_rfdom": "",
  "channel_rfdomuri": "",
  "channel_loctxt": "tradelab-domain_name",
  "channel_creatxt": "Generic",
  "channel_slkw": "",
  "channel_sikey": "",
  "channel_sival": "",
  "channel_slcamp": "",
  "channel_sladgroup": "",
  "fullurl": "https://eulerian.client.fr/dynview/photobox-fr/pix.gif?ead-publisher=tradelab&ead-name=TLAB_PROSPECTING_PROFILING&ead-location=domain_name&ead-creative=Generic&ead-creativetype=1x1&ea-rnd=205363586",
  "cluster": {
    "A-B_Retargeting": "Cible A",
    "prospects": "nouveau prospect"
  }
}



Exemple — hit

{
  "devicetype": "SmartPhone",
  "type": "hit",
  "epoch": "1476741661",
  "eulerianid": "13494950543979816964",
  "euleriandeviceid": "2537865102402279348",
  "uid": "5360955",
  "useragent": "Mozilla/5.0 (iPhone; CPU iPhone OS 7_1_2 like Mac OS X) AppleWebKit/537.51.2 (KHTML, like Gecko) Version/7.0 Mobile/11D257 Safari/9537.53",
  "geo": "FR",
  "ip": "80.12.55.41",
  "profile": "visitor",
  "fullurl": "https://eulerian.client.com/col1/-/1678601783?urlp=%2FHome&pagegroup=Home&age=25-30&size=M&prdr2=669130&prdr0=1246310&prdr1=1363092&ss=320x480&sd=32&fra=0&url=https%3A%2F%2Fwww.oscaro.com%2F",
  "path": "/Home",
  "pagegroup": "Home",
  "channel_c": "br",
  "channel_publisher": "",
  "channel_ope": "BRANDING",
  "channel_seng": "Google",
  "channel_sengkw": "client-notprovided",
  "channel_rfdom": "",
  "channel_rfdomuri": "",
  "channel_loctxt": "",
  "channel_creatxt": "",
  "channel_slkw": "",
  "channel_sikey": "",
  "channel_sival": "",
  "channel_slcamp": "",
  "channel_sladgroup": "",
  "currency": "EUR",
  "product": [
    {
      "ref": "1246310",
      "price": "",
      "quantity": "1"
    },
    {
      "ref": "1363092",
      "price": "",
      "quantity": "1"
    },
    {
      "ref": "669130",
      "price": "",
      "quantity": "1"
    }
  ],
  "customp": [
    {
      "k": "email",
      "v": ""
    },
    {
      "k": "age",
      "v": "25-30"
    },
    {
      "k": "size",
      "v": "M"
    },
    {
      "k": "segment",
      "v": ""
    }
  ],
  "cluster": {
    "A-B_Retargeting": "B",
    "prospects": "nouveau prospect"
  }
}



Exemple — vente order

{
  "devicetype": "Desktop",
  "type": "order",
  "epoch": "1476755706",
  "eulerianid": "12116298850026246700",
  "euleriandeviceid": "3664146731612841153",
  "uid": "6263105",
  "useragent": "Mozilla/5.0 (Windows NT 6.0; rv:49.0) Gecko/20100101 Firefox/49.0",
  "geo": "FR",
  "ip": "90.18.238.84",
  "profile": "registered",
  "fullurl": "https://eulerian.client.com/col1/-/475487784?amount=320.74&frais_de_port=4.99&urlp=%2FStep5%2FConfirmTransaction&payment=CB&profile=registered&ref=33788526&eemail=aff37b68b83d0c1refref5a77aa477efe&uid=6263105&pagegroup=confirmation&prdr0=177292&prda0=36.63&prdq0=2&prdr1=1856824&prda1=141.36&prdq1=1&prdr2=3857469&prda2=8.21&prdq2=2&ss=1280x800&sd=24&fra=0&fl=23.0%20r0&url=https%3A%2F%2Feulerian.client.com%2FStep5%2FConfirmTransaction",
  "path": "/Step5/ConfirmTransaction",
  "pagegroup": "",
  "channel_c": "ad",
  "channel_publisher": "leboncoin",
  "channel_ope": "cpm-display",
  "channel_seng": "",
  "channel_sengkw": "",
  "channel_rfdom": "www.leboncoin.fr",
  "channel_rfdomuri": "",
  "channel_loctxt": "leboncoin-vignette-produit",
  "channel_creatxt": "vignette-generique",
  "channel_slkw": "",
  "channel_sikey": "",
  "channel_sival": "",
  "channel_slcamp": "",
  "channel_sladgroup": "",
  "currency": "EUR",
  "product": [
    {
      "ref": "177292",
      "price": "36.63",
      "quantity": "2"
    },
    {
      "ref": "1856824",
      "price": "141.36",
      "quantity": "1"
    },
    {
      "ref": "3857469",
      "price": "8.21",
      "quantity": "2"
    }
  ],
  "ref": "33788526",
  "amount": "320.74",
  "ordertype": "Marketplace",
  "orderpayment": "CB",
  "customp": [
    {
      "k": "age",
      "v": "18-25"
    },
    {
      "k": "size",
      "v": "M"
    },
    {
      "k": "segment",
      "v": "Nouveau client"
    }
  ],
  "cluster": {
    "clients-actifs": "Nouveau client -1 mois",
    "Test_Retargeting": "B"
  }
}



Points à retenir

Le format JSON standard permet de transmettre les données Eulerian dans un modèle structuré et exploitable par les solutions BI.
Les éléments principaux à retenir sont les suivants :
  • la clé type permet d’identifier la nature de l’événement envoyé ;
  • les champs communs décrivent l’utilisateur, le device, l’URL et le contexte général ;
  • les champs marketing décrivent le levier, la campagne, le support ou le référant ;
  • les champs product, customp et cluster permettent de transmettre des informations détaillées sur les produits, les paramètres personnalisés et les audiences ;
  • les champs de conversion, comme amount, ref, ordertype ou orderpayment, sont principalement disponibles pour les événements de type order ou estimate.
Ce format peut évoluer avec l’ajout de nouvelles clés, tout en conservant la structure des clés déjà existantes.