Analyse de l’opérateur réseau

Le rapport Network Carrier Analytics vous permet de récupérer des données de performances côté achat et côté vente en fonction des opérateurs pour les appareils. Cela est particulièrement utile pour analyser la façon dont les opérateurs affectent les performances des campagnes et le paiement des annonceurs. En outre, dans les cas où les annonceurs configurent des pages d’accueil spécifiques pour chaque opérateur, ce rapport vous aide à identifier les opérateurs sur lesquels les campagnes ont été exécutées.

Pour obtenir des instructions sur la demande et la récupération de ce rapport, consultez l’exemple ci-dessous.

Période

Le report_interval champ peut être défini sur l’une des valeurs suivantes (dans le fuseau horaire UTC) :

• aujourd’hui
• yesterday
• last_2_days
• last_7_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 14 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

La période de conservation des données pour le rapport est de 46 jours.

Dimensions

Mesures

Exemple

Create une demande de rapport au format JSON

Le fichier JSON doit inclure le report_type de "network_carrier_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, excel, ou 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 comment les campagnes fonctionnent sur les téléphones mobiles et les tablettes sur trois opérateurs spécifiques. Plus précisément, pour chaque combinaison d’opérateur et de type d’appareil, 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_carrier_analytics

{
    "report": {
        "report_type": "network_carrier_analytics",
        "filters": [
            {
                "carrier_id": [
                    345,
                    567,
                    837
                ]
            },
            {
                "device_type": [
                    "mobile phones",
                    "tablets"
                ]
            }
        ],
        "columns": [
            "day",
            "carrier_id",
            "device_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_carrier_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_carrier_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"carrier_id\",\"device_make\",\"device_model\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=097f59fc3ab7d02c5d60db42081d9b69"
      },
      "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=097f59fc3ab7d02c5d60db42081d9b69' > /tmp/network_carrier_analytics.csv

Voir aussi

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