Digital Platform API - 保存されたレポート サービス

保存されたレポート サービスを使用して、保存され、いつでも取得できる新しいレポートを作成できます。 これらは、頻繁に実行されるレポートに役立ちます。 保存されたレポート サービスは、 レポート サービスのラッパーとして機能します。

保存されたレポートに関して留意すべきいくつかの事実:

• 保存されたレポートの有効期限は 6 か月後です。 6 か月後に新しい保存済みレポートを作成する必要があります。
• 保存されたレポートに 有効期間 または カスタム の日付範囲を指定することはできません。
• 保存されたレポートは、最初に作成された順序で実行されます。 たとえば、2 つの日次レポートを作成すると、最初に作成された日次レポートが毎日最初に実行されます。
• 日次レポートは毎日実行され、1 日を通してさまざまな時間に送信されます。
• 毎週のレポートは、前の 7 日間、毎週の月曜日に実行され、送信されます。
• 月次レポートは、毎月の最初の日に実行され、送信されます。

REST API

JSON フィールド

例

パブリッシャーの新しい保存済みレポートを追加する

1. レポート JSON を作成します ( 「Report Service - 手順 1」の説明に従います)。
2. POST 保存されたレポート サービスへの JSON。
3. 返される ID を格納します。

$ cat saved-report

{
   "saved-report":{
      "name":"Publisher Report Last 48 Hours",
      "report":{
         "report_type":"publisher_analytics",
         "columns":[
            "publisher_revenue",
            "imps_total",
            "imps_sold",
            "imps_default",
            "clicks",
            "ctr",
            "month",
            "day",
            "hour",
            "geo_country",
            "size",
            "placement",
            "total_convs",
            "convs_rate",
            "publisher_rpm"
         ],
         "row_per":[
            "month",
            "day",
            "hour",
            "geo_country",
            "size",
            "placement_id"
         ],
         "timezone":"EST",
         "report_interval":"last_48_hours"
      },
      "scheduling":"daily",
      "format":"excel",
      "emails":[
         "reporting@publisher.com",
         "noreply@publisher.com"
      ],
      "expires_on":"2010-10-31 0:00:00"
   }
}

$ curl -b cookies -c cookies -X post --data-binary @saved-report 'https://api.appnexus.com/saved-report?publisher_id=35'

{
   "response":{
      "status":"OK",
      "id":39
   }
}

保存したレポートを実行して取得する

1. POST を上の ID でレポート サービスに保存し、返された report_idを格納します。
2. レポート サービスへの GET でレポートの状態を report_id で確認します ( 「レポート サービス - 手順 3」で説明されています)。
3. GET report-download サービスからのレポート (レポート サービス - 手順 4 で説明されているように)。

$ curl -b cookies -c cookies -X post "https://api.appnexus.com/report?saved_report_id=39&publisher_id=35"

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

$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=fa16873114e1d5697091069e45bccec0"

{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-06-10 15:53:07",
         "json_request":"{\"report\":{\"report_type\":\"publisher_analytics\",\"columns\":[\"publisher_revenue\",\"imps_total\",
             \"imps_sold\",\"imps_default\",\"clicks\",\"ctr\",\"month\",\"day\",\"hour\",\"geo_country\",\"size\",\"placement\",
             \"total_convs\",\"convs_rate\",\"publisher_rpm\"],\"row_per\":[\"month\",\"day\",\"hour\",\"geo_country\",\"size\",
             \"placement_id\"],\"timezone\":\"EST\",\"report_interval\":\"last_48_hours\",\"filters\":[{\"publisher_id\":\"4642\"},
             {\"publisher_id\":\"4642\"}]}}",
         "data":"publisher_revenue,imps_total,imps_sold,imps_default,clicks,ctr,month,day,hour,geo_country,size,placement,total_convs,convs_rate,publisher_rpm\r\n"
      },
      "execution_status":"ready"
   }
}

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