Digital Platform API - キュレーター分析レポート

キュレーター分析レポートは、キュレーションされたマーケットプレース内で需要から供給に資金がどのように流れているかについて、キュレーターに洞察を提供します。

レポートを取得する手順については、 レポート サービス または以下の 例 を参照してください。

時間枠

JSON 要求のフィールドは report_interval 、次のいずれかに設定できます。

• last_hour
• 今日
• yesterday
• month_to_date
• last_month
• 有効 期間

データ保持期間

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

45 日前より前に発生した日付を含む時間範囲

を に"lifetime"設定して report_interval Curator Analytics レポートを作成すると、レポートは (含まれているメトリックに関係なく) "リソース集中型" レポートの特別なキューに追加されます。 その結果、レポートの完了に通常より時間がかかる場合があります。 さらに、これらのリソースを集中的に使用するレポートは、要求されるデータの量が原因で、完了する前に失敗する可能性があります。 レポートの完了に失敗した場合は、通知を受け取ります。 レポート要求が失敗した場合、または削除された場合は、次のことができます。

• 後でレポートを再実行します。
• 以外 curator_analyticsのレポートの種類を使用します。
• レポートの構成方法 (可能な場合) を変更して、45 日前より前の日付を含めないようにします。

Dimensions

指標

例

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

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

$ cat curator_analytics

{
    "report": {
        "columns": [
            "hour",
            "buyer_member_name",
            "curated_deal",
            "imps",
            "curator_revenue",
            "curator_margin"
        ],
        "format": "csv",
        "report_interval": "today",
        "report_type": "curator_analytics"
    }
}

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

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

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

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

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

$ 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\":\"curator_analytics\",\"columns\":[\"hour\",\"buyer_member_name\",\"curated_deal\",\"imps\",\"curator_revenue\",\"curator_margin\"],\"report_interval\":\"today\",\"format\":\"csv\",\"grouping\":{\"additional_grouping_sets\":[],\"unselected_implicit_groupings\":[],\"additional_groups_on_bottom\":true},\"timezone\":\"UTC\",\"filters\":[{\"member_id\":\"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 の呼び出しを行いますが、今回は report-download サービスに対して呼び出します。 サービスとレポート ID は、前GETの応答のフィールドにありますurl。 保存するファイルを識別する場合は、最初POSTの で指定した の"format"ファイル拡張子を使用してください。

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