データ プロバイダーのデータ使用状況レポート

このレポートは、第三者 (ユーザー セグメント プロバイダーなど) から提供されるデータの使用状況、そのデータ使用状況のコスト、対象ユーザーにそのデータが使用されたキャンペーンに関する詳細を提供します。

データの time_granularity は hourlyです。

時間枠

JSON 要求の report_interval フィールドは、次のいずれかに設定する必要があります。

• today
• yesterday
• last_7_days
• last_30_days
• month_to_date
• quarter_to_date
• last_month
• lifetime

Dimensions

指標

例

手順 1: JSON レポート要求を作成します。

JSON ファイルには、取得するcolumns (サイズとメトリック) とreport_intervalだけでなく、"data_usage_analytics_for_data_providers"のreport_typeを含める必要があります。 また、特定のディメンションでフィルター処理したり、粒度 (月、日、時間) を定義したり、データを返す形式 (csv、excel、html) を指定したりすることもできます。

$ cat data_usage_analytics
        {"report":
                {
                        "format": "csv",
                        "report_interval": "yesterday",
                        "row_per": ["geo_country"],
                        "columns": ["imps","campaign_id","geo_country"],
                        "report_type": "data_usage_analytics_for_data_providers"
                }
         }

JSON ファイルに含めることができるフィールドの詳細については、「 レポート サービス」を参照してください。

手順 2:POSTレポート サービスへの要求。

POST レポート ID を取得するための JSON 要求。

$ curl -b cookies -c cookies -X POST -d @data_usage_analytics "https://api.adnxs.com/report?member_id=MEMBER_ID"
         {
            "response":{
               "status":"OK",
               "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
            }
         }                 

手順 3:GET レポート サービスからのレポートの状態。

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

$ curl -b cookies -c cookies 'https://api.adnxs.com/report?id=c445bca183a3d338dc1c5b85a3d484f5'
         {
            "response": {
                "status": "OK",
                "report": {
                    "name": null,
                    "created_on": "2014-11-19 22:33:31",
                    "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"geo_country\"],\"columns\":[\"imps\",\"campaign_id\",\"geo_country\"],\"report_type\":\"buyer_data_usage_analytics\",\"filters\":[{\"buyer_member_id\":\"958\"}]}}",
                    "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
                },
                "execution_status": "ready"
            }
         }           

手順 4:GET レポート ダウンロード サービスからのレポート データ。

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