Format JSON Standard

Ce document explicite le modèle de donnée disponible lorsqu'un connecteur de type Business Intelligence est mis en place.


A quoi correspondent les valeurs standards de notre API JSON ?


Le format décrit ci-dessous est notre modèle standard d'envoi de donnée à toutes les solutions BI capable d'intégrer notre data sous sa forme la plus granulaire.
Ce modèle est en constante évolution et de nouvelles données viendront s'ajouter à cette liste sans jamais modifier les clés existantes et leur structure.


Type d'appel

La clé type de la structure contient le type d'appel envoyé selon une liste de valeurs figée:
Champs
Type
click
Tous les clicks sur des liens trackés eulerian (clic, dynclick etc..)
view
Toutes les impressions trackées eulerian (view, dynview etc..)
hit
Trafic site-centric. Toute page autre qu'un order / estimate / scart
visit
Comme hit mais indique en plus 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 et format des valeurs envoyées


Champs
Type
Description
Contexte
Exemple
channel_c
STRING
Abbréviation levier
tous
ad
channel_creatxt
STRING
Nom de la bannière
tous
150316-fr-brand
channel_loctxt
STRING
Nom de l'emplacement
tous
support-160x600
channel_ope
STRING
Nom de la campagne
tous
campagne-brand-fil-rouge
channel_publisher
STRING
Nom du support
tous
support
channel_referer
STRING
Domaine du référant de la première page vue
tous
http..
channel_rfdom
STRING
Domaine référant ad-centric
tous
http..
channel_rfdomuri
STRING
URI référant ad-centric
tous
/page
channel_seng
STRING
Moteur de recherche SEO
tous
Bing
channel_sengkw
STRING
Mot clé SEO
tous
marque
channel_sikey
STRING
Segment entrant
tous
segmentation
channel_sival
STRING
Sous segment entrant
tous
chaud
channel_slaccount
STRING
Nom du compte SEA
tous
Branding
channel_sladgroup
STRING
Groupe de mot clé
tous
marque
channel_slcamp
STRING
Campagne SEM
tous
Marque-Bing
channel_slkw
STRING
Mot clé SEM
tous
parfum voiture neuve
devicetype
STRING
Type d'appareil
tous
desktop
epoch
TIMESTAMP
Date au format epoch
tous
1450102413
eulerianid
INTEGER
ID interne Eulerian
tous
489780172675333
euleriandeviceid
INTEGER
ID du device
tous
998455384754733
fullurl
STRING
URL complète associée
tous
http…
profile
STRING
Profil de l'utilisateur (looker/shopper/buyer/etc)
tous
looker
geo
STRING
Géolocalisation
tous
france
ip
STRING
Adresse IP
tous
80.150.10.3
uid
STRING
UID (identifiant unique de l'utilisateur)
tous
123456
useragent
STRING
User agent de l'utilisateur
tous
Chrome
cluster
OBJECT
Liste des audiences et de leurs segments respectifs
tous
{'audience':'segment', }
pagegroup
STRING
Groupe de pages
hit,visit,order,scart,estimate
pageBasket
path
STRING
Nom de page
hit,visit,order,scart,estimate
Shop/Step1
product
ARRAY of OBJECTS
Liste des produits
hit,visit,order,scart,estimate
[{'ref':'45835','price':'0',quantity:1},{...}]
product.ref
STRING
Référence produit
hit,visit,order,scart,estimate
4077075
product.price
FLOAT
Prix du produit
hit,visit,order,scart,estimate
12,5
product.quantity
FLOAT
Quantité du produit
hit,visit,order,scart,estimate
1
customp
ARRAY of OBJECTS
Liste ded paramètres personnalisés
hit,visit,order,scart,estimate
[{'k':'v'},{'age':'25-30'}]
customp.k
STRING
Nom du paramètre personnalisé
hit,visit,order,scart,estimate
code-promo
customp.v
STRING
Valeur du paramètre personnalisé
hit,visit,order,scart,estimate
123456
amount
FLOAT
Montant de la conversion
order,estimate
100
estimatetype
STRING
Type de devis
order,estimate
option
ref
STRING
Référence de conversion
order,estimate
28923018
orderpayment
STRING
Type de paiement
order
CB
ordertype
STRING
Type de vente
order
CB
ordertype
STRING
lié au paramètre 'type' de la conversion
order
ancien_client
currency
STRING
Devise
order
EUR

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",
}
}