API De plateforme numérique - Rapport d’erreur d’offre de l’acheteur

Le rapport d’erreurs d’enchère de l’acheteur vous aide à résoudre les problèmes liés aux paramètres côté achat et côté vente qui entraînent des erreurs d’enchères, bloquant ainsi les dépenses. L’objectif est de vous aider à éliminer l’erreur à l’avenir. Vous trouverez des informations sur le propriétaire, la cause et la résolution recommandée pour chaque erreur dans Codes d’erreur d’enchère. Le rapport d’erreurs d’enchères de l’acheteur vous permet d’obtenir des informations sur la demande rejetée par le biais d’un ensemble aléatoire de 5 % des erreurs enregistrées sur la plateforme Xandr. Le nombre d’erreurs a été multiplié par 100 pour tenir compte de l’échantillonnage de 5 %.

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 dans la requête JSON peut être défini sur l’une des valeurs suivantes :

• Personnalisé
• last_hour
• aujourd’hui
• last_24_hours
• yesterday
• last_2_days
• last_7_days
• last_30_days

Période de conservation des données

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

Dimensions

Mesures

Exemple

Create la demande de rapport au format JSON

Le fichier JSON doit inclure le report_type"buyer_bid_error_report", ainsi que le columns (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é (année, mois, jour) 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_bid_error_report

{
    "report":
    {
        "report_type":"buyer_bid_error_report",
        "columns":[
            "hour",
            "bidder",
            "buyer_member",
            "error_count"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

POST la demande au service de création de rapports

$ curl -b cookies -c cookies -X POST -d @buyer_bid_error_report '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". Ensuite, utilisez le report-download service 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":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"buyer_bid_error_report\",\"columns\":[\"hour\",\"bidder\",
            \"buyer_member\",\"error_count\",
            \"report_interval\":\"last_48_hours\"}}",
         "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/buyer_bid_error_report.csv