Digital Platform API - データ使用状況レポート

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

このレポートのデータは 60 日間保持されます。 time_granularityデータの は ですhourly。 レポートを取得する手順については、 レポート サービス または以下の 例 を参照してください。

時間枠

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

• 今日
• yesterday
• last_7_days
• last_30_days
• month_to_date
• quarter_to_date
• last_month
• 有効 期間

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

Dimensions

指標

例

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

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

$ cat buyer_data_usage_analytics

{"report":
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["geo_country"],
        "columns": ["imps","campaign_id","geo_country"],
        "report_type": "buyer_data_usage_analytics"
    }
}

POSTReport Service への要求

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

$ curl -b cookies -c cookies -X post -d @seller_brand_review "https://api.appnexus.com/report"

{
   "response":{
      "status":"OK",
      "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
   }
}

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

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

$ curl -b cookies -c cookies 'https://api.appnexus.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"
    }
}

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

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

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=c445bca183a3d338dc1c5b85a3d484f5' > /tmp/buyer_data_usage_analytics.csv