API éditeur : GET reports aggregated by advertiser

Proposez-vous un appel d’API pour extraire le rapport de performance par annonceur ?

GET rapports agrégés par annonceur

Le rapport sur les performances des annonceurs regroupe les transactions, les clics et les impressions pour tous les annonceurs avec lesquels un éditeur travaille.
 

Qui peut l’utiliser

Éditeurs.
 

Comment l’appeler

https://api.awin.com/publishers/45628/reports/advertiser?startDate=2017-01-01&endDate=2017-03-17&region=GB&timezone=UTC
Ajoutez le paramètre 'accessToken' pour fournir votre clé d’accès comme décrit dans Comment puis-je générer ma clé d'accès à l'API éditeur ?
 

Paramètre	Format	Obligatoire/optionnel
startDate	aaaa-MM-dd	obligatoire
endDate	aaaa-MM-dd	obligatoire
dateType	transaction validation	facultatif (revient à « transaction » s’il n’est pas défini)
region	actuellement pris en charge :  AT  AU  BE  BR (programmes brésiliens fonctionnant en BRL)  BU (programmes brésiliens fonctionnant en USD)  CA  CH  DE  DK  ES  FI  FR  GB  IE  IT  NL  NO  PL  SE  US	obligatoire
timezone	America/Sao_Paulo  Australia/Sydney  Europe/Berlin  Europe/Dublin  Europe/Helsinki  Europe/London  Europe/Paris  Canada/Central  Canada/Eastern  Canada/Mountain  Canada/Pacific  US/Central  US/Eastern  US/Mountain  US/Pacific  UTC	obligatoire

 

À quoi ressemble la réponse

[
  {
    "advertiserId": 1001,
    "advertiserName": "Example Advertiser",
    "publisherId": 45628,
    "publisherName": "Example Publisher",
    "region": "GB",
    "currency": "GBP",
    "impressions": 0,
    "clicks": 0,
    "creativeId": 12345,
    "creativeName": "Example creative static 360x600",
    "tagName": "christmas",
    "pendingNo": 0,
    "pendingValue": 0,
    "pendingComm": 0,
    "confirmedNo": 0,
    "confirmedValue": 0,
    "confirmedComm": 0,
    "bonusNo": 1,
    "bonusValue": 0,
    "bonusComm": 2500,
    "totalNo": 1,
    "totalValue": 0,
    "totalComm": 2500,
    "declinedNo": 0,
    "declinedValue": 0,
    "declinedComm": 0
  },
 
(...)

 

Quels champs de données fournissons-nous ?

Nom du champ	Description
advertiserId
advertiserName
publisherId
publisherName
region
currency	Code ISO
impressions	nombre d’impressions
clicks	nombre de clics
creativeId	id de la création
creativeName	nom de la création
tagName	nom de la balise de la création, utilisée par l’annonceur pour regrouper les créations
pendingNo	nombre de transactions en attente
pendingValue	valeur des transactions en attente
pendingComm	commissions des transactions en attente
confirmedNo	nombre de transactions confirmées
confirmedValue	valeur des transactions confirmées
confirmedComm	commission des transactions confirmées
bonusNo	nombre de transactions de bonus
bonusValue	valeur des transactions de bonus
bonusComm	commission des transactions bonus
totalNo	nombre total de transactions
totalValue	valeur de toutes les transactions
totalComm	commission de toutes les transactions
declinedNo	nombre de transactions refusées
declinedValue	valeur des transactions refusées
declinedComm	commission des transactions refusées