Digital Platform API - インベントリ可用性レポート

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

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

時間枠

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

データ保持期間

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

Dimensions

指標

例

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

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

$ cat platform_inventory_avail

{
    "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_avail"
    }
}

POST Report サービスへの要求

$ curl -b cookies -X POST -d @platform_inventory_avail '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_avail\",\"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 Report Download サービスからのレポート データ

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

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