Analyse réseau

Le rapport Analyse réseau peut être utilisé pour afficher les données côté achat et vente pour un membre du réseau :

• Impressions directes des annonceurs (achetées sur les éditeurs directs et l’inventaire en temps réel)
• Éditeurs directs (vendus par des annonceurs directs et d’autres acheteurs de plateforme)

Pour explorer les analyses plus précises d’un annonceur ou d’un éditeur spécifique, consultez les rapports Network Advertiser Analytics et Network Publisher Analytics .

Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou l’exemple ci-dessous.

Période

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

• current_hour
• last_hour
• aujourd’hui
• yesterday
• last_48_hours
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday
• last_2_days
• 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. Pour plus d’informations, consultez Dates et heures dans les rapports dans la documentation de l’interface utilisateur.

Intervalles de temps, y compris les dates se produisant il y a plus de 45 jours

Si vous créez des rapports d’analyse réseau avec la report_interval valeur ou "quarter_to_date" (où la date de fin est supérieure à "lifetime" 45 jours à partir d’aujourd’hui), votre rapport (quelles que soient les métriques incluses) est ajouté à une file d’attente spéciale pour "resource-intensive" les rapports. Par conséquent, le rapport peut prendre plus de temps que d’habitude. En outre, ces rapports gourmands en ressources peuvent, en raison de la quantité de données demandées, échouer avant d’être terminés. Si votre rapport ne se termine pas, vous recevrez une notification. Si votre demande de rapport échoue ou est supprimée, vous pouvez :

• réexécutez le rapport ultérieurement.
• utiliser un type de rapport autre que network_analytics.
• modifiez la façon dont vous structurez vos rapports (si possible) afin qu’ils n’incluent pas de dates supérieures à 45 jours.

Si vous demandez fréquemment des rapports d’analyse réseau via l’API qui incluent des dates de plus de 45 jours, vous devrez peut-être envisager de mettre en cache les données et d’utiliser des flux de création de rapports en bloc ou des flux de données au niveau du journal (LLD).

Dimensions

Mesures

Métriques de définition visualisables personnalisées

Exemple

Create une demande de rapport au format JSON

Le fichier JSON doit inclure le report_type"network_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.

{code}$ cat network_analytics

{
    "report":
    {
        "report_type":"network_analytics",
        "columns":[
            "hour",
            "seller_member_name",
            "buyer_member_name",
            "advertiser_name",
            "publisher_name",
            "imps",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}
{code}

POST la demande au service de création de rapports

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

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).

{code}$ curl -b cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"network_analytics\",\"columns\":[\"hour\",\"seller_member_name\",
            \"buyer_member_name\",\"advertiser_name\",\"publisher_name\",\"imps\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"],
            \"report_interval\":\"last_48_hours\"}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}
{code}

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.

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