Analyse de l’annonceur réseau

Le rapport Network Advertiser Analytics est utilisé pour afficher les données de performances d’un annonceur spécifique qui sont plus détaillées que les données fournies dans le rapport Network Analytics . Ce rapport est disponible uniquement pour les utilisateurs réseau. Les utilisateurs de l’annonceur peuvent utiliser le rapport Advertiser Analytics .

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

Période

Le report_interval champ dans la requête JSON peut être défini sur l’une des valeurs suivantes :

• current_hour
• last_hour
• aujourd’hui
• yesterday
• last_48_hours
• last_2_days
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday
• quarter_to_date
• last_month
• Vie

Période de conservation des données

La plupart des données de ce rapport sont conservées de manière permanente (exceptions indiquées ci-dessous). Après:

• 100 jours, vous ne pouvez plus générer de rapports sur les données horaires. Toutefois, des intervalles quotidiens, mensuels et cumulés sont toujours disponibles.
• 14 mois, vous n’êtes plus en mesure de rendre compte des individus :
  • Créatifs
  • Placements
  • Marques

Dans certains cas, les rapports d’analyse peuvent afficher une livraison qui ne correspond pas aux statistiques affichées ailleurs dans Investir ou Monétiser pour un annonceur ou un éditeur donné. Cela est dû à la façon dont les données de rapports Analytics datant de plus de 100 jours et 14 mois sont agrégées. Les données des rapports de facturation sont conservées indéfiniment sous forme non agrégée.

Dimensions

Certaines dimensions ont des attributs. Les attributs de dimension sont un élément plus granulaire des données relatives à la dimension parente. Si une dimension a des attributs, le nom de ses attributs s’affiche en dessous à l’aide de la syntaxe suivante : dimension_name.attribute_name.

Mesures

Exemple

Create une demande de rapport JSON

Le fichier JSON doit inclure le report_type de "network_advertiser_analytics", ainsi que les colonnes (dimensions et métriques) et report_interval que vous souhaitez récupérer. Vous pouvez également filtrer des dimensions spécifiques, définir la granularité (year, month, day) et spécifier le format dans lequel les données doivent être retournées (csv, excelou html). Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports.

$ cat network_advertiser_analytics

{"report":
    {
        "report_type":"network_advertiser_analytics",
        "columns":[
            "hour",
            "seller_member_id",
            "campaign_id",
            "imps",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

POST la demande adressée au service de rapports

Vous POST la demande JSON et récupérez un ID de rapport.

$ curl -b cookies -X post -d @network_advertiser_analytics "https://api.appnexus.com/report?advertiser_id=690"

{
  "response":{
   "status":"OK",
   "report_id":"09b6979a6a4c3805bdac8921378d3622"
  }
}

GETle rapport status à partir du service de rapports

Effectuez un GET appel avec l’ID de rapport pour récupérer les status du rapport. Continuez à effectuer cet appel jusqu’à ce que soit execution_status"ready". Utilisez ensuite le service de téléchargement de rapports pour enregistrer les données de création de rapports dans un fichier (décrit à l’étape suivante).

$ curl -b cookies 'https://api.appnexus.com/report?id=09b6979a6a4c3805bdac8921378d3622'

{
  "response":{
   "status":"OK",
   "report":{
     "name":null,
     "created_on":"2010-05-25 19:15:48",
     "json_request":"{\"report\":{\"report_type\":\"network_advertiser_analytics\",\"columns\":
     [\"hour\",\"seller_member_id\",\"campaign_id\",\"imps\",\"clicks\",\"total_convs\",
     \"ctr\",\"convs_rate\"],\"row_per\":[\"hour\",\"seller_member_id\",\"campaign_id\"],
     \"report_interval\":\"last_48_hours\",\"filters\":[{\"advertiser_id\":\"690\"}]}}",
     "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
   },
   "execution_status":"ready"
  }
}

GET les données de rapport du service de téléchargement de rapports

Pour télécharger les données du rapport dans un fichier, effectuez un autre GET appel avec l’ID de rapport, mais cette fois au service de téléchargement de rapports . Vous trouverez le service et l’ID de rapport dans le url champ de la réponse précédente GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du "format" que vous avez spécifié dans votre initial POST.

$ curl -b cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/network_advertiser_analytics.csv

Rubrique connexe

Service de rapports