Digital Platform API - 販売者入札エラー レポート

販売者入札エラー レポートは、AppNexus プラットフォームでログに記録されたエラーの 5% のランダムに選択されたセットを通じて、拒否された需要に関する分析情報を得るのに役立ちます。 エラー数に 100 を乗算して、5% のサンプリングを考慮しました。

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

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

期限

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

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

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

データ保持期間

このレポートのデータ保持期間は 403 日です。

Dimensions

指標

例

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

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

$ cat seller_bid_error

{
    "report":
    {
        "report_type":"seller_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 @seller_bid_error 'https://api.appnexus.com/report'
{
   "response":{
      "status":"OK",
      "report_id":"097f59fc3ab7d02c5d60db42081d9b69"
   }
}

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

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

$ 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\":\"seller_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/advertiser_analytics.csv