デジタル プラットフォーム API - 購入者の入札エラー レポート

買い手の入札エラー レポートは、オークション エラーの原因となり、支出をブロックするバイサイドおよびセルサイドの設定のトラブルシューティングに役立ちます。 目標は、将来エラーを排除できるようにすることです。 各エラーの所有者、原因、推奨される解決策に関する情報は、「 入札エラー コード」にあります。 購入者の入札エラー レポートは、Xandr プラットフォームに記録されたエラーの 5% をランダムに選択したセットを通じて、拒否された需要に関する分析情報を得るのに役立ちます。 エラー数に 20 が乗算され、5% のサンプリングが考慮されます。

レポートを取得する手順については、「 Report Service 」または次の 例 を参照してください。

時間枠

JSON 要求の report_interval フィールドは、次のいずれかに設定できます。

• カスタム
• last_hour
• 今日
• last_24_hours
• yesterday
• last_2_days
• last_7_days
• last_30_days

データ保持期間

このレポートのデータは 33 日間保持されます。

Dimensions

指標

例

JSON 形式のレポート要求を作成する

JSON ファイルには、取得する report_type"buyer_bid_error_report"だけでなく、 columns (寸法とメトリック) と report_interval も含まれている必要があります。 また、特定のディメンションでフィルター処理したり、粒度 (年、月、日) を定義したり、データを返す形式 (csv、excel、html) を指定したりすることもできます。 JSON ファイルに含めることができるフィールドの詳細については、「 Report Service」を参照してください。

$ 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 レポート サービスへの要求

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

GET レポート サービスからのレポートの状態

レポート ID を使用して GET 呼び出しを行い、レポートの状態を取得します。 execution_statusが"ready"されるまで、このGET呼び出しを続けます。 次に、次の手順で説明するように、 report-download サービスを使用してレポート データをファイルに保存します。

$ 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 レポート ダウンロード サービスからのレポート データ

レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行います。今回は レポート ダウンロード サービスに対して呼び出します。 サービスとレポート ID は、前のGET応答の url フィールドにあります。 保存するファイルを特定する際は、最初のPOSTで指定した"format"のファイル拡張子を使用してください。

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