フィードステータスサービス
フィード ステータス サービスを使用すると、Network Analytics フィードを介して新しいレポート データを使用できる場合にチェックできます。 新しいデータは、次の場合に使用できるようになります。
- レポート データの新しい時間が利用可能になる
- レポート データの前の時間が更新されました。 これは、特定の時間のフィードのデータを再処理する必要がある場合に発生するまれなイベントです。
注:
- このサービスは、 Clicktrackers フィードでは使用できません。
- 統合でこのフィードを使用する方法の詳細については、「 一括レポート フィード」を参照してください。
REST API
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
GET |
https://api.appnexus.com/feed-status?type=network_analytics_feed |
Network Analytics フィードの状態を確認する |
JSON フィールド
このサービスは、オブジェクトの配列内の 2 つのフィールドのみを返します。
フィールド | 種類 | 説明 |
---|---|---|
hour |
timestamp | 関心のある状態のレポート データの日付と時間。 |
last_run |
timestamp | 1 時間分のレポート データがデータ パイプラインによって最後に更新されたとき。 これは通常、 の値より数時間後です hour 。 |
注:
タイムスタンプは UTC タイムゾーンで報告されるため、UTC 時刻を標準タイムゾーンに手動で変換する必要があります。
例
このサービスは、次に示すように、単純な GET
呼び出しで過去 30 日間の時間単位データを返します。 この情報を使用して独自のレポート システムと統合する方法については、「 一括レポート フィード」を参照してください。
$ curl -b cookies -c cookies 'https://api.appnexus.com/feed-status?type=network_analytics_feed'
{
"response": {
"status": "OK",
"num_elements": 732,
"start_element": 0,
"hours": [
{
"hour": "2013-11-20 00:00:00",
"last_run": "2013-11-20 03:10:55"
},
{
"hour": "2013-11-20 01:00:00",
"last_run": "2013-11-20 05:10:05"
},
... many, many hours of data...
{
"hour": "2013-12-20 11:00:00",
"last_run": "2013-12-20 13:55:50"
}
]
}
}