Analyse des appareils réseau

Le rapport Network Device Analytics vous permet de récupérer des données de performances côté achat et côté vente en fonction des appareils où les impressions ont été servies. Cela est particulièrement important pour les réseaux travaillant avec des annonceurs in-app qui traficent des créations qui encouragent l’installation d’applications et qui veulent donc confirmer que leurs créatifs ciblent des appareils compatibles avec leurs applications. Il vous aide également à répondre aux questions suivantes :

• Combien d’impressions avez-vous vues pour des modèles et des modèles d’appareils spécifiques ?
• Combien d’impressions avez-vous vues pour des types de connexion spécifiques (par exemple, Wifi/Statique ou Basé sur un opérateur) ?
• Comment certains types d’appareils fonctionnent-ils par rapport à d’autres (par exemple, tablettes et téléphones) ?
• Comment certains modèles et certains modèles d’appareils fonctionnent-ils par rapport à d’autres (par exemple, Android et Apple) ?
• Comment certains types de connexions fonctionnent-ils par rapport à d’autres (par exemple, Wifi/Statique ou Basé sur un opérateur) ?

Période et fuseau horaire

Le report_interval champ peut être défini sur l’une des valeurs suivantes :

• aujourd’hui
• yesterday
• last_2_days
• last_7_days
• last_14_days
• last_30_days
• month_to_date
• month_to_yesterday

Vous pouvez également définir les start_date champs et end_date sur une plage au cours des 30 derniers jours. Toutefois, étant donné que les données horaires ne sont pas disponibles pour ce rapport, et start_dateend_date ne peuvent pas être identiques et doivent être mis en forme comme "YYYY-MM-DD" au lieu de "YYYY-MM-DD HH:MM:SS". Le timezone champ dans la requête JSON peut être défini uniquement "UTC"sur , mais ce n’est pas nécessaire, car le fuseau horaire est défini par défaut "UTC" sur s’il n’est pas spécifié.

Période de conservation des données

Les données de ce rapport sont conservées pendant 428 jours.

Dimensions

Mesures

Exemple

Create une demande de rapport au format JSON

Le fichier JSON doit inclure le report_type"network_device_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. Dans cet exemple, nous voulons voir des données de performances sur les impressions américaines pour l’annonceur 1459 pour chacun des 14 derniers jours. Plus précisément, pour chaque combinaison de marque d’appareil, modèle d’appareil, type de connexion et type d’impression, nous voulons le nombre d’impressions, le nombre de clics, l’argent total dépensé, l’argent dépensé par 1 000 impressions, l’argent que nous a versé l’annonceur et le bénéfice total (argent gagné - argent dépensé).

$ cat network_device_analytics

{
    "report": {
        "report_type": "network_device_analytics",
        "filters": [
            {
                "advertiser_id": 1459
            },
            {
                "geo_country": "US"
            }
        ],
        "columns": [
            "day",
            "connection_type",
            "imp_type",
            "imps",
            "clicks",
            "cost",
            "cpm",
            "booked_revenue",
            "profit"
        ],
        "report_interval": "last_14_days",
        "format": "csv",
    }
}

POST la demande au service de création de rapports

POST la requête JSON pour récupérer un ID de rapport.

$ curl -b cookies -c cookies -X POST -d @network_device_analytics 'https://api.appnexus.com/report'
{
   "response":{
      "status":"OK",
      "report_id":"097f59fc3ab7d02c5d60db42081d9b69"
   }
}

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=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2013-02-01 12:19:53",
            "json_request": "{\"report\":{\"report_type\":\"network_device_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"device_make_id\",\"device_model_id\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}

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=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2013-02-01 12:19:53",
            "json_request": "{\"report\":{\"report_type\":\"network_device_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"device_make_id\",\"device_model_id\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "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 -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/network_device_analytics.csv

Voir aussi

• Service de rapports
• Bonnes pratiques relatives aux API
• Sémantique d’API