API de plateforme numérique - Rapport d’utilisation des données

Ce rapport fournit des détails relatifs à votre utilisation des données fournies par des tiers (par exemple, des fournisseurs de segments d’utilisateurs), les coûts de cette utilisation des données et les éléments de ligne/campagnes dans lesquels ces données ont été utilisées pour cibler les utilisateurs.

Les données de ce rapport sont conservées pendant 60 jours. Le time_granularity des données est hourly. Pour obtenir des instructions sur la récupération d’un rapport, consultez le service de rapports ou l’exemple ci-dessous.

Période

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

• aujourd’hui
• yesterday
• last_7_days
• last_30_days
• month_to_date
• quarter_to_date
• last_month
• Vie

Pour exécuter un rapport pour une période personnalisée, définissez les start_date champs et end_date dans votre demande de rapport. Pour plus d’informations sur ces champs, consultez Service de rapports.

Dimensions

Mesures

Exemple

Create une demande de rapport JSON

Le fichier JSON doit inclure le report_type de "buyer_data_usage_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é (month, day, hour) et spécifier le "format" dans lequel les données doivent être retournées ("csv", "excel", ou "html"). Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports.

$ cat buyer_data_usage_analytics

{"report":
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["geo_country"],
        "columns": ["imps","campaign_id","geo_country"],
        "report_type": "buyer_data_usage_analytics"
    }
}

POST la demande adressée au service de rapports

POST demande JSON pour récupérer un ID de rapport.

$ curl -b cookies -c cookies -X post -d @seller_brand_review "https://api.appnexus.com/report"

{
   "response":{
      "status":"OK",
      "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
   }
}

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 GET appel jusqu’à ce que soit execution_status"ready". Utilisez ensuite le service de téléchargement de rapports pour enregistrer les données du rapport dans un fichier, comme décrit à l’étape suivante.

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

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-11-19 22:33:31",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"geo_country\"],\"columns\":[\"imps\",\"campaign_id\",\"geo_country\"],\"report_type\":\"buyer_data_usage_analytics\",\"filters\":[{\"buyer_member_id\":\"958\"}]}}",
            "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
        },
        "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 l’ID de service et de rapport dans le url champ de la réponse à votre appel précédent GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du format de fichier que vous avez spécifié dans votre fichier initial POST.

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