Note d application. Comment obtenir un export des statistiques et des informations de tracking de mes campagnes? Version 1.1.5

Transcription

1 Note d application Comment obtenir un export des statistiques et des informations de tracking de mes campagnes? Version 1.1.5

2 Introduction Objet Reactivpub, plateforme d affiliation basée sur la technologie R-Adserver développée par la société R, permet de mettre en relation des affiliés (ou diffuseurs : sites internet souhaitant rentabiliser leur espace publicitaire), et des sites annonceurs souhaitant vendre ou promouvoir leurs produits. Reactivpub met à disposition de tous ses membres annonceurs ou affiliés un moyen simple, sous forme d une URL, leur permettant de récupérer les statistiques de leurs campagnes sous forme d un fichier CSV. Ce document explique comment appeler cette URL et décrit le contenu du fichier CSV obtenu. A qui s adresse ce document? Ce document est destiné à tous les membres du réseau Reactivpub et des plateformes de diffusion basées sur la technologie R-Adserver. Avertissements Malgré tout le soin apporté à sa vérification, ce document peut comporter certaines erreurs. Nous vous invitons à nous transmettre toute remarque ou commentaire à l adresse production@r-advertising.com Les informations contenues dans ce document sont susceptibles d être modifiées sans préavis. de tracking de mes campagnes v

3 Principe Généralités Lorsqu une campagne est diffusée sur notre réseau, le trafic généré et les principales actions relatives à cette campagne sont conservés en base de données. Vous pouvez extraire très simplement ces informations sous forme d un fichier CSV (fichier que vous pourrez ensuite exploiter dans Excel par exemple) : - En accédant au formulaire d export des statistiques et des informations de tracking accessible depuis votre interface d administration (rubrique «Mes liens». Ce formulaire vous permet de générer immédiatement l export souhaité, ou de fabriquer l URL d appel du webservice d export des statistiques permettant de générer l export (cette URL pourra ensuite être invoquée à la demande dans n importe quelle application). - en construisant vous-même manuellement l URL d appel du webservice d export des statistiques, URL qui pourra ensuite être invoquée à la demande dans n importe quelle application. La suite de ce document explique comment fabriquer manuellement l URL d appel du webservice d export des statistiques. Webservice d export des statistiques L URL vous permettant de récupérer l export de vos campagnes est de la forme : Ou from=..&to=..&login=..&pwd=..&lg=.. from=..&to=..&id=..&lg=.. Dans cette URL : - Les paramètres et leur valeur sont toujours passés dans l URL séparés par «&» (convention d appel http/get) - les 4 paramètres «from», «to», «login /password» ou «id» sont obligatoires. - Le paramètre «lg» permet de spécifier la langue dans laquelle les intitulés de colonnes seront formulés (français par défaut). Le rôle et les valeurs attendues pour ces paramètres sont décrits dans le tableau suivant. de tracking de mes campagnes v

4 Paramètre de l URL from to id login pwd lg Rôle, valeurs possibles Obligatoire Date de début de la période sur laquelle porte l export (format US : YYYY-MM-DD) Obligatoire Date de fin de la période sur laquelle porte l export (format US : YYYY-MM-DD) Obligatoire (sauf si les paramètres «login» et «password» sont présents) Valeur (token) permettant de vous identifier (remplace, s il est présent, les champs «login» et «password»). La valeur de ce paramètre ne peut être récupérée que depuis le formulaire d export des statistiques et des informations de tracking accessible dans votre interface d administration (rubrique «Mes liens»). Obligatoire (sauf si le paramètre «id» est présent) Votre identifiant vous permettant de vous connecter sur la plateforme. Usage du paramètre déconseillé, conservé pour compatibilité avec les précédentes versions. Obligatoire (sauf si le paramètre «id» est présent) Votre mot de passe vous permettant de vous connecter sur la plateforme. Usage du paramètre déconseillé, conservé pour compatibilité avec les précédentes versions. Langue utilisée pour les intitulés de colonnes dans l export généré : - «fr» : français (par défaut) - «en» : anglais - «es» : espagnol - «br» : portugais brésilien Description des paramètres Exemple : L appel dans un navigateur de l URL suivante : Ou from= &to= &login=jdoe&pwd=secret from= &to= &id=a5684fec77 permet de télécharger l export statistique de toutes les campagnes et de tous les sites du membre ayant l identifiant «jdoe» et le mot de passe «secret», pour le trafic généré entre le 1 ier et le 31 janvier Les intitulés des colonnes dans l export seront en français. Le format du fichier obtenu est différent selon que vous êtes un affilié diffuseur ou un annonceur. Ce format est décrit dans les paragraphes suivants. D autres paramètres peuvent être ajoutés à l URL pour vous permettre de filtrer les résultats obtenus, comme par exemple obtenir uniquement l export d une campagne donnée. Reportez-vous à la section correspondante dans ce document. de tracking de mes campagnes v

5 Attention : - vous devez respecter la casse (majuscule/minuscule) dans l URL et notamment dans les noms et les valeurs des paramètres - Notez que votre identifiant et votre de mot de passe apparaissent clairement dans l URL (paramètres «login» et «pwd»), ce qui pourrait représenter un risque pour la confidentialité de vos données. Nous vous déconseillons vivement de conserver l url complète dans un fichier informatique ou dans vos marques-pages. Nous vous conseillons plutôt de renseigner les paramètres «login» et «pwd» manuellement à chaque fois que vous appelez l URL d export statistique ou d utiliser l URL générée depuis le formulaire d export des statistiques et des informations de tracking accessible dans votre interface d administration. de tracking de mes campagnes v

6 Paramètres facultatifs L URL d export des statistiques accepte, en plus des 4 paramètres obligatoires, un certain nombre de paramètres facultatifs destinés à vous permettre d affiner le résultat obtenu. Ces paramètres sont décrits dans le tableau suivant. Paramètre de l URL site campaign separator delimiter revenues costs Rôle, valeurs possibles Identifiant numérique du site dont vous souhaitez obtenir les statistiques. Par défaut, tous les sites ayant diffusés pendant la période sélectionnée seront présents dans l export CSV. Si vous ne connaissez pas l identifiant de site, demandez à votre gestionnaire de compte. Ex : &site=12 Identifiant numérique de la campagne dont vous souhaitez obtenir les statistiques. Par défaut, toutes les campagnes ayant été diffusées pendant la période sélectionnée seront présentes dans l export CSV. Si vous ne connaissez pas l identifiant de la campagne, demandez à votre gestionnaire de compte. Ex : &campaign=123 Séparateur de colonne à utiliser dans l export CSV généré (par défaut : point-virgule) Ex : &separator=x Délimiteur (caractère) encadrant chaque champ dans le rapport CSV généré (par défaut : aucun). Ex : &delimiter=x Valable pour les affiliés (diffuseurs) uniquement. Permet d exporter les actions ayant engendré des gains nuls. La valeur de ce paramètre peut uniquement être «all». Ex : pour une campagne rémunérée au lead uniquement, l export ne fera pas apparaitre les clics car ceux -ci n ont engendré aucun gain. Pour que l export fasse apparaitre les clics, il faut spécifier dans l URL «&revenues=all» Valable pour les annonceurs uniquement. Permet d exporter les actions ayant engendré des coûts nuls. La valeur de ce paramètre peut uniquement être «all». Ex : pour une campagne rémunérée au lead uniquement, l export ne fera pas apparaitre les clics car ceux -ci n ont engendré aucun gain. Pour que l export fasse apparaitre les clics, il faut spécifier dans l URL «&costs=all» filter Permet de filtrer les actions à exporter selon leur type : - «filter=leadsonly» : permet d exporter uniquement les actions de type lead (actions généralement soumises à validation de l annonceur) - «filter=salesonly» : permet d exporter uniquement les actions de typevente fixe et vente % (actions généralement soumises à validation de l annonceur) - «filter=leadssalesonly» : permet d exporter uniquement les actions de type lead, vente fixe et vente % (actions généralement soumises à validation de l annonceur) state Permet de filtrer les actions à exporter selon leur état : - «state=validated» : actions validées - «state=rejected» : actions refusées - «state=pending» : actions en attente de validation de l annonceur (toutes) - «state=pendingcertified» (annonceur uniquement) : actions certifiées en attente de validation annonceur - «state=pendinguncertified» (annonceur uniquement) : actions non-certifiées en attente de validation annonceur de tracking de mes campagnes v

7 track trackaff keyword origin bill Valable pour les annonceurs uniquement. Permet de filtrer les actions à exporter selon une chaine de caractère contenue dans le paramètre «track=» Valable pour les affiliés (diffuseurs) uniquement. Permet de filtrer les actions à exporter selon une chaine de caractère contenue dans le paramètre «trackaff=» Valable pour les affiliés (diffuseurs) uniquement. Permet de filtrer les actions à exporter selon une chaine de caractère contenue dans les mots clés tapés dans les moteurs de recherche à l origine de l action Valable pour les affiliés (diffuseurs) uniquement. Permet de filtrer les actions à exporter selon leur provenance (valeur du champ «referer»). Valable pour les affiliés (diffuseurs) uniquement. Permet de filtrer les actions à exporter selon leur état de facturation * : - «bill=yes» : seules les actions facturées seront exportées - «bill=no» : seules les actions qui n ont pas encore été facturées seront exportées - «bill=n _de_facture» : seules les actions qui ont été facturées sur la facture n _de_facture seront exportées - Paramètre absent ou non-renseigné : toutes les actions seront exportées, quelque soit leur état de facturation * Pour chaque affilié, Reactivpub génère automatiquement chaque mois une facture des gains acquis au cours du mois passé. Cette facture est établie à partir des différentes actions réalisées par l affilié sur la période. Description des paramètres facultatifs Reportez-vous au chapitre «Exemples» dans ce document pour une description de différents scénarios d appel et des résultats obtenus. de tracking de mes campagnes v

8 Fichier CSV obtenu Fichier CSV obtenu pour un affilié (diffuseur ou éditeur) Le fichier CSV généré comporte toujours : - le nom des champs/colonne sur la première ligne (dans la langue choisie) - puis une ligne par action Le format du fichier CSV obtenu est le même quelques soient les paramètres spécifiés lors de l appel à l URL d export des statistiques. Ce format est décrit dans le tableau ci-dessous. Champ/colonne Identifiant Nom campagne Id campagne Nom site Url site Date heure action Date heure validation/refus action Signification Identifiant numérique de l action Nom de la campagne Identifiant numérique de la campagne Nom du site ayant réalisé l action URL du site ayant réalisé l action Date et heure à laquelle l action a eut lieue Ex : si l action est une vente, il s agit de la date/heure de réalisation de la vente Date et heure de validation ou de refus de l action. Ex : si l action est une vente, il s agit de la date/heure à laquelle la vente a été validée ou refusée Etat Etat de l action : - «validée» : l action a été acceptée par l annonceur, et les gains correspondant à cette action sont attribués - «refusé» : l action a été refusée par l annonceur, et aucun gain n est attribué pour cette action - «en attente/à valider» : l action n a pas encore été validée par l annonceur, et pour l instant aucun gain n est attribué pour cette action. Nombre d'action(s) Gains unitaires Gains totaux Trackaff Prix Contrôle Type Nombre d actions identiques Gain unitaire généré par l action Gain total généré par toutes les actions de la ligne (Nombre d action(s) x Gains unitaires) Valeur du paramètre «trackaff» (paramètre de tracking affilié disponible dans les tags) passé en paramètre du tag ayant engendré l action. Montant de l action Type d action générée : Clic, Double Clic, Cout par mille, Lead, Clic Sortant, Vente Fixe, Vente % Type de l'action d'origine (inconnu, post-view de tracking de mes campagnes v

9 ou post-clic) Nature/Age Groupe de tracking Provenance Mots-clés Url cible Url source Facture Date/heure de l action d origine Valeur du paramètre «group» (paramètre pouvant servir de regroupement statistique) passé en paramètre du tag ayant engendré l action URL de provenance de l action (referer). Il peut s agir par exemple de l URL cliquée depuis un moteur de recherche. Si l action a été engendrée à partir d un clic dans un moteur de recherche, contient la liste des mots clés tapés dans le moteur de recherche (mots clés à l origine de la transformation) URL de la page de destination du clic à l origine de l action (en général, URL d une page du site annonceur) URL de la page qui contenait le lien cliqué à l origine de l action (en général, URL d une page du site affilié) Numéro de la facture rattachée à cette action (défini si cette action a déjà été facturée, sinon vide) Description du format du fichier CSV généré pour un affilié de tracking de mes campagnes v

10 Fichier CSV obtenu pour un annonceur Le fichier CSV généré comporte toujours : - les noms des champs sur la première ligne, - puis une ligne par action Le format du fichier CSV obtenu est le même quelques soient les paramètres spécifiés lors de l appel à l URL d export des statistiques. Ce format est décrit dans le tableau ci-dessous. Champ/colonne Identifiant Nom campagne Id campagne Nom site Url site Date heure action Date heure validation/refus action Signification Identifiant numérique de l action Nom de la campagne Identifiant numérique de la campagne Nom du site ayant réalisé l action URL du site ayant réalisé l action Date et heure à laquelle l action a eut lieue Date et heure de validation ou de refus de l action. (ex : si l action est une vente, il s agit de la date/heure à laquelle la vente a été validée ou refusée) Etat Etat de l action : - «accepté» : l action a été acceptée, les gains correspondant cette action sont attribués à l affilié concerné - «refusé» : l action a été refusée, aucun gain ne sera versé à l affilié concerné - «en attente/à valider (certifiée)» : l action n a pas encore été validée par l annonceur, et pour l instant aucun gain n est attribué à l affilié concerné. Son origine est certifiée. - «en attente/à valider (non certifiée)» : l action n a pas encore été validée par l annonceur, et pour l instant aucun gain n est attribué à l affilié concerné. Son origine n est pas certifiée. Nombre d'action(s) Coûts unitaires Coûts totaux Track Prix Type Type de rémunération Id transaction Nombre d actions identiques Coût unitaire de l action Coût total des actions de la ligne (Nombre d action(s) x Coûts unitaires) Valeur du paramètre «track» (paramètre de tracking annonceur disponible dans les tags) passé en paramètre du tag ayant engendré l action. Montant de l action générée Type d action générée : Clic, Double Clic, Cout par mille, Lead, Clic Sortant, Vente Fixe, Vente % Type de rémunération (généralement pour les actions de type vente) Identifiant unique de la transaction (actions type vente) Description du format du fichier CSV généré pour un annonceur de tracking de mes campagnes v

11 Exemples Exemple n 1 Export CSV des statistiques (en anglais) de tous les sites de l affilié John Doe du 15/01/2008 au 24/04/2008, avec toutes les actions, même les nonrémunérées : URL : from= &to= &login=jdoe&pwd=secret &lg=en&gains=all Id;Campaign Name;Campaign Id;Site Name;Action Date; validation/refusal action date;status;number of action(s); Revenue per unit;total revenue;trackaff;price;category;type; Nature/Age;Tracking Group;From;Keywords;Target url;source url;bill ;Games;371;My first site;01/01/ :32;04/01/ :31; validated;1;0.50;0.5;;;lead;;;home;;; ;Games;371;My first site;03/01/ :45; 13/01/ :40;pending / to validate;1;0.50;0.5;;;lead;;;landing; best price; ;Games;373;My first site;04/01/ :22; 01/02/ :12;;1;;;;;Clic;Post-Clic;12/12/ :06;HOME;;; ;Games;121;My first site;13/01/ :29;11/02/ :22; ;1;;;;;Clic;;;LANDING; games; ;Games;371;My first site;09/01/ :22; 19/01/ :21;pending / to validate;1;0.50;0.5;;;lead;post-clic; 24/03/ :01;LANDING;;; ;Winter;371;My second site;01/02/ :23;23/02/ :20; refused;1;12.00;12;;;lead;;;landing;;; de tracking de mes campagnes v

12 Exemple n 2 Export CSV des statistiques (en espagnol) de l annonceur Richard Roe du 15/01/2008 au 24/04/2008, séparateur : URL : from= &to= &login=rroe&pwd=secret&lg=es&separator= Identificator;Nombre de campaña;id de campaña;nombre del sitio; Url del sitio;fecha y hora de la acción; Fecha y hora de validación/negativa de la acción;estado; cantidad de acción(s);costos unitarios;total de los gastos;track; Precio;Categoría;Categoría de compensación ;Games;371;Affiliate website one; 08/01/ :58;08/01/ :58;pendiente / por validar (certificado); 1;8.00;8;customer1@onewebsite.com;;Venta Fija;VOLSEC ;Games;371;Affiliate website one; 02:20;02/03/ :20; pendiente / por validar (certificado);1;8.00;8; customer2@onewebsite.com;;venta Fija;VOLSEC ;Games;371;Affiliate website one; 12:32;02/02/ :32; pendiente / por validar (certificado);1;18.00;18; customer3@onewebsite.com;;venta Fija;SEJOUR ;Games;371;Affiliate website two; 22:45;18/03/ :45; pendiente / por validar (certificado);1;18.00;18; customer4@onewebsite.com;;venta Fija;SEJOUR de tracking de mes campagnes v