FAQ： Analytics API

以下は、 Analytics API。いくつかの一般的な質問に対する回答 Video Cloud Studio Analyticsモジュール、参照 FAQ：Analyticsモジュール.

期間

どのようにしてすべての時間にデータを返すのですか？ レポート?

設定する from=alltime 要求に含まれます。また、 to=nowしかし、これは必要ではない。 now デフォルト値です。注意： alltime ありません Studio上ではサポートされていません。 〜のために働く 巻き上げる - 代わりに、 from 過去に十分な日まで

特定の日のデータを取得するにはどうすればよいですか？

両方を設定する from と to その日付までの値。例えば： from=2013-05-12&to=2013-05-12。さらに、あなたは問い合わせることができます。 date 寸法他の寸法と組み合わせることができます。

Analyticsモジュールと Analytics API 同じ期間の理想的なデータを教えてください。

はい。ただし、比較的最近のデータを比較している場合や、StudioとAPIからデータを取得する時間が異なる場合は、内容が異なる場合があります。

データは3日前です。 3日以内の分析データは暫定的なものであり、いつでも変更される可能性があります。
同じ期間のデータが32日数未満であった場合、および32日数が経過した後に再度調べられます。 32日後、データは別の「履歴」リポジトリに移動され、その時点で一部のデータ、特に詳細なエンゲージメントデータは破棄されます。つまり、エンゲージメントスコアなどの計算フィールドは、細かいデータで計算されるため、わずかに変わる可能性があります。

データの細分性

最近のAnalyticsデータの粒度は？

最近の32日（当日を含む）の場合、 Analytics API 値をXNUMX時間ごとのバケットに保存するため、XNUMX時間単位でレポートします。ただし、現在の時間はまだ埋められているため、現在の時間に該当するデータを要求すると、APIはXNUMX時間よりも細かく見えるようになります。

例として：

3：9と15：9について、数時間前の20からのデータを要求した場合、それらが同じ時間バケットに含まれていれば、同じ値を取得する可能性があります。ただし、すべての分析データは暫定的なものであり、調整されるまで変更される可能性があるため、これらは異なる場合があります。
10分前にデータを要求してから5分待ってからもう一度尋ねると、そのバケットがまだ更新されているため、同じバケット内にあっても別の値を取得することがあります。

アナリティクスデータの更新間隔はどのくらいですか？

/ dataエンドポイントは現在、クエリーの間に5分キャッシュされています。そのため、最近1時間にトラフィックが発生した動画のリストでは、5分間隔がデルタの処理に必要な最小の遅延です。

過去のアナリティクスデータの粒度は？

最後の32日より前の日付の場合、 Analytics API 一日の値を報告します。これは、要求された from=1368334306919&to=1378446336919 （Sun、12 May 2013 04：51：46 GMTから金曜日、06 Sep 2013 05：45：36 GMT）、あなたが要求した場合と同じ結果を得るでしょう from=2013-05-12&to=2013-09-06

アイテムとフィールド

1つ以上の動画のある期間に開始されたストリームの数を確認するにはどうすればよいでしょうか？

ちょうど video_view メトリック - ストリームの開始と常に同じです。このメトリックはすべてのレポートで確認できます。要約には、クエリされた期間のすべての動画のストリーム開始が表示されます。アカウントのすべての動画のストリーム開始を確認するには、このリクエストを実行します。

    https://analytics.api.brightcove.com/v1/data?accounts={account_ids}&dimensions=video&limit=all&offset=0&fields=all

どのようにすべてのアイテムを返すのですか？ レポート?

をセットする limit 以下のためのパラメータ レポート に等しい all.

どのデータ fields デフォルトでアイテムのために返されますか？

デフォルトでは、 video_view 要求された次元に対応するフィールド（例： destination_domain）が返されます。追加フィールドを取得するには、 fields=field_name1,field_name2 選択したフィールドを返します。

フィールド値が null?

A null データフィールドの値は、要求されたデータが処理されていないことを示します。最も可能性の高い理由は次のとおりです。

リクエストしたデータは最近のもので、まだ処理されていません
リクエストしたデータは非常に古いもので、現在の分析システムにまだインポートされていません

動画の名前を変更しました。なぜ、アナリティクスのデータに古い名前が表示されるのですか？

新しい名前は新しいアナリティクスイベントで記録されますが、履歴データの名前は変更されません。返される動画名は見たときの名前になります。

なぜ私はエンゲージメント値の整数を常に見ないのですか？

エンゲージメント番号を小数点で返すことは可能です。これは、エンゲージメントが正規化されているため、「video_percent_viewed *（video_engagement_25 / video_engagement_sum）」の比率であるため、クエリで選択された時間範囲に基づいて、正確に分割されない場合に浮動小数点数が表示される可能性があります。

結果をフィルタリングする方法 player?

レポート作成

が使用する帯域幅を確認すると、なぜ0 GBと表示されるのですか？ player?: 過去にブライトコーブは帯域幅を player、それで物事を分解したい顧客のために player 帯域幅コストを割り当てる手段としてこれらのメトリックを使用できます。ただし、よりマニフェスト主導の配信（現在のHLSおよび将来のDASH）に進むにつれて、セグメント化されたビデオの性質により、追跡帯域幅は次のようになります。 player 不正確。したがって、次のようにして帯域幅を廃止します。 player 使用率レポートのディメンション。したがって、今後は、秒数を使用することをお勧めします player パフォーマンスレポートでコストを割り当てる player.

その他

アナリティクスレポートから従業員の見解を除外することはできますか？: これを行う簡単な方法はありません。トラフィックの多いビデオの場合、従業員の視聴率は非常に小さいため、分析への影響はごくわずかです。ただし、これを行うことが重要であると思われるトラフィックの少ない動画の場合、最も簡単な解決策は制作物を複製することです player（s）コピーのビデオを従業員にテスト/表示させる。フィルターを使用して、プロダクションに関するレポートを作成できます player（s）のみ、Analyticsモジュールのカスタムレポート機能または Analytics API.