Bidder - インベントリの可用性レポート

インベントリ可用性レポートでは、プラットフォームで利用可能なインベントリの種類に関する分析情報が提供されます。 これらのレポートは、要求によってのみ使用できます。 Microsoft Advertising カスタマー サポート ポータルを使用してください。 インプレッションの可用性データベースの構造により、レポートのディメンションは以下に示すものに制限されます。 以下の点にもご注意ください。

• Microsoft のデータベースには、30 日分の履歴インベントリ可用性データが含まれています。 したがって、レポートはこの期間に制限されます。
• モバイルインプレッションには、追加のレポート制限が適用される場合があります。 詳細については、Xandr の担当者にお問い合わせください。

期限

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

データ保持期間

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

Dimensions

指標

例

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

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

$ cat platform_inventory_availability

{
    "report": {
        "columns": [
            "day",
            "seller_member_name",
            "audit_type",
            "size",
            "device_type",
            "operating_system_family",
            "geo_country",
            "imps"
        ],
        "format": "csv",
        "report_interval": "today",
        "report_type": "platform_inventory_availability"
    }
}

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

$ curl -b cookies -X POST -d @platform_inventory_availability 'https://api.appnexus.com/report'

{
   "response":{
      "status":"OK",
      "report_id":"6b177543a9411ffa67b09bdf5e76cac1"
   }
}

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

$ curl -b cookies 'https://api.appnexus.com/report?id=6b177543a9411ffa67b09bdf5e76cac1'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2020-08-25 13:03:37",
         "json_request":"{\"report\":{\"report_type\":\"platform_inventory_availability\",\"columns\":[\"day\",\"seller_member_name\",\"audit_type\",\"imps\",\"size\",\"device_type\,\"operating_system_family\,\"geo_country\"],\"report_interval\":\"today\",\"format\":\"csv\",\"grouping\":{\"additional_grouping_sets\":[],\"unselected_implicit_groupings\":[],\"additional_groups_on_bottom\":true},\"timezone\":\"UTC\",\"filters\":[{\"device_type\":\"123456\"}],\"reporting_decimal_type\":\"decimal\",\"use_cache\":true},\"extraction_version\":\"refactored\",\"end_date\":1598400000,\"start_date\":1598313600,\"user_id\":\"987654\"}",
         "url": "report-download?id=6b177543a9411ffa67b09bdf5e76cac1"
      },
      "execution_status":"ready"
   }
}

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

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

$ curl -b cookies 'https://api.appnexus.com/report-download?id=6b177543a9411ffa67b09bdf5e76cac1' > /tmp/platform_inventory_availability.csv