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

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

データの 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 ファイルには、"data_usage_analytics_for_data_providers"のreport_typeと、取得するcolumns (ディメンションとメトリック) とreport_intervalが含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (月、日、時間) を定義し、データを返す形式 (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で指定したファイル形式のファイル拡張子を使用してください。