Bidder Bid Error report API

Bidder Bid Error Report は、Xandr プラットフォームでログに記録されたエラーの 1% をランダムに選択することで、拒否された需要に関する分析情報を得るのに役立ちます。 エラー数に 100 が乗算され、1% のサンプリングが考慮されています。

このレポートを使用して、オークション エラーが発生し、支出がブロックされるバイサイド設定と販売側設定のトラブルシューティングを行います。 目標は、将来的にエラーを排除するのに役立ちます。 所有者に関する情報、原因、推奨される解決方法については、「 入札エラー コード」を参照してください。

レポートを取得する手順については、 レポート サービス または以下の 例を 参照してください。

時間枠

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

• last_hour
• last_24_hours
• yesterday
• last_2_days
• last_7_days
• last_30_days

カスタム時間枠のレポートを実行するには、レポート要求の フィールド start_date と end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。

Dimensions

指標

例

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

JSON ファイルには、取得する report_typebidder_bid_error_report、 columns 、および (ディメンションとメトリック) report_interval が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、、) を定義し、monthdayデータを返す形式 (csv、、excelまたはhtml) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。

$ cat bidder_bid_error
{
        "report":
        {
                "report_type":"bidder_bid_error_report",
                "columns":[
                        "hour",
                        "seller_member_name",
                        "error_count"
                ],
                "report_interval":"last_24_hours",
                "format":"csv"
        }
}

POST レポート サービスへの要求

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

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

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

$ curl -b cookies -c cookies 'https://api.adnxs.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"bidder_bid_error_report\",\"columns\":[\"hour\",
            \"seller_member\",\"error_count\",
            \"report_interval\":\"last_48_hours\"}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}

GET レポート ダウンロード サービスからのレポート データ

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

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