Interface d'accès temps-réel aux données user-centric
Un article de Eulerian Support.
Contexte
Vous souhaitez fournir à votre système d'information les données qu'EUreca collecte, ceci afin d'améliorer vos taux de transformation et optimiser la consultation de votre site.
Spécifications de l'API
Liste des variables
| Variable | Signification |
|---|---|
| {ope} | Récupére le nom de la campagne média utilisée pour arriver sur le site. |
| {publisher} | Si le canal est de type epub, mailing, affiliation, partenariat, shopbbot, le nom du support lié à la campagne courante est fourni.
Si le canal est de type moteur de recherche ou branding le nom du moteur est fourni. Si le canal est de type référant le nom de domaine du site référant est fourni. Si le canal est de type lien sponsorisé, les valeurs suivantes pourront être retournées :
Si le canal est de type réseau interne cette variable sera vide. |
| {media} | Récupére le type de canal utilisé pour arriver sur le site (lien vers la déf des canaux). |
| {slkeyword} | Récupére le mot-clé qui a été acheté. |
| {keyword} | Récupére l'expression recherchée par l'internaute et qui a entrainé un clic en moteur de recherche ou sur un mot-clé acheté (sponsoredlink). |
| {publisherurl} | Récupére l'url du site du support comme spécifié dans sa création. |
| {location} | Récupére le nom de l'emplacement spécifié lors du trafficking d'une campagne e-pub. |
| {email} | Récupére l'adresse email passée en paramètre du clic ou du view d'un mailing ou d'une newsletter. |
| {creative} | Récupére le nom de la bannière spécifiée lors du trafficking d'une campagne d'e-pub ou d'affiliation. |
| {date} | Récupére la date de la réalisation du clic ou de l'impression (epoch time). |
| {via} | Récupére le type de l'accés 'via'. Les valeurs possibles sont: view, click, revisit. |
Liste des paramétres
| Variable | Signification |
|---|---|
| hlevel | Spécifie le niveau d'historique demandé:
|
Opérateurs conditionnels applicables aux variables
La notion d'opérateur conditionnel est supportée pour les modèles {publisher} et {ope} en ajoutant le type du canal utilisé séparé par un deux-point :.
Si le canal de la campagne utilisé ne correspond pas à la condition spécifiée alors le modèle sera vide.
Les conditions suivantes sont supportées :
- {XXX:affiliation} : campagnes de type affiliation.
- {XXX:advertising} : campagnes de type e-pub.
- {XXX:mailing} : campagnes de type mailing / newsletter.
- {XXX:partner} : campagnes de type partenariat.
- {XXX:sponsoredlink} : liens sponsorisés.
- {XXX:internal} : trafic provenant du réseau interne.
- {XXX:branding} : trafic gratuit généré par votre marque.
- {XXX:searchengine} : trafic gratuit provenant d'un moteur.
- {XXX:referer} : trafic gratuit provenant de referer.
- {XXX:natural} : trafic naturel.
Accèder aux données
Selon le contexte où vous souhaitez récupérer les données, EUreca propose différents moyens pour récupérer les données qui vous intéressent.
Trafic d'entrée
Vous pouvez remplir les modèles en rajoutant les variables que vous souhaitez récupérer à la suite de l'url de tracking.
Exemple
Pour une campagne d'affiliation ayant pour nom Campagne Affi 1 sur le support Plateforme Affi 1 et qui, suite au clic, arrive sur l'url http://www.eulerian.com.
http://et.eulerian.net/click/<IDENTIFIANT_SITE>/?mymedia={media}&myope={ope}&mypublisher={publisher}
Redirige vers:
http://www.eulerian.com?mymedia=affilation&myope=Campagne Affi 1&mypublisher=Campagne Affi 1
En mode multi-niveaux d'historique:
http://et.eulerian.net/click/<IDENTIFIANT_SITE>/?hlevel=0,1&mymedia={media}&myope={ope}&mypublisher={publisher}
Redirige vers:
http://www.eulerian.com?mymedia=affilation|sponsoredlink&myope=Campagne Affi 1|&mypublisher=Campagne Affi 1|google
Au sein de votre site via l'API Javascript
Syntaxe
<!-- Appel EUreca -->
<script type="text/javascript" src="http://et.eulerian.net/info/<IDENTIFIANT_SITE>/?mymedia={media}&myope={ope}&mypublisher={publisher}"></script>
<script type="text/javascript">
/*<![CDATA[ Affiche les données */
alert('Media utilisé : '+mymedia+'\n Campagne utilisée : '+myope+'\n Support utilisé : '+mypublisher);
/*]]>*/
</script>
Paramètres:
- <IDENTIFIANT_SITE>, obligatoire : identifiant EUreca de votre site.
- liste des paramètres que vous souhaitez récupérer.
Important : le nom des variables Javascript qui stockeront la valeur retournée par EUreca correspond au nom respectif du paramètre.
En mode multi-niveaux d'historique, les variables initialisées contiendront un tableau de valeurs.
Exemple
Pour le site ayant pour identifiant eulerian.support, l'internaute étant arrivé sur le site via la campagne d'affiliation Campagne Affi 23 diffusée par la plateforme Plateforme Affi 1.
<script type="text/javascript" src="http://et.eulerian.net/info/eulerian.support/?mymedia={media}&myope={ope}&mypublisher={publisher}"></script>
<script type="text/javascript">
/*<![CDATA[ Affiche les données */
alert('Media utilisé : '+mymedia+'\n Campagne utilisée : '+myope+'\n Support utilisé : '+mypublisher);
/*]]>*/
</script>
La variable Javscript qui contiendra la valeur du media sera mymedia, la variable Javascript qui contiendra le nom de la campagne sera myope, et ainsi de suite.
Le résultat affiché dans la boîte d'alerte Javascript sera :
Media utilisé : affiliation Campagne utilisée : Campagne Affi 23 Support utilisé : Plateforme Affi 1
Trafic de sortie
Vous pouvez remplir les modèles en rajoutant les variables que vous souhaitez récupérer sur l'url de clic de sortie.
Exemple
Pour une campagne d'affiliation ayant pour nom Campagne Affi 1 sur le support Plateforme Affi 1 et qui, suite au clic de sortie, effectue une redirection sur l'url http://www.eulerian.com.
Le modèle :
http://et.eulerian.net/clickout/<IDENTIFIANT_SITE>/?mymedia={media}&myope={ope}&mypublisher={publisher}&eurl=http://www.eulerian.com
va rediriger vers :
http://www.eulerian.com?mymedia=affilation&myope=Campagne Affi 1&mypublisher=Campagne Affi 1
Pour plus d'informations sur la gestion des modèles dans le trafic de sortie, veuillez consulter l'article Trafic de sortie : gestion des variables dynamiques.
