サポート問い合わせ先| システムステータス
ページコンテンツ

    よくある質問:Analytics API

    以下は、Analytics APIに関してよく寄せられる質問です。Video Cloud Studio Analyticsモジュールに関する一般的な質問のいくつかに対する回答については、よくある質問:Analytics モジュールを参照してください。

    日付範囲

    特定の日のデータを取得するにはどうすればよいですか?
    fromto の両方の値をその日付に設定します。例: from=2013-05-12&to=2013-05-12 のようにします。さらに、dateディメンション、でクエリを実行し、他のディメンションと組み合わせることもできます。
    Analytics モジュールと Analytics APIは、同じ日付範囲について同じデータを提供してくれますか?
    はい。しかし、比較的最近のデータを比較し、StudioとAPIから異なる時期にデータを取得した場合は、異なるかもしれません:
    1. データが3日未満の場合。3日未満の分析データは暫定的なものであり、いつでも変更される可能性があります。
    2. 同じ期間のデータは、32 日未満の時と、32 日が経過した後に再度確認されます。 32 日後、データは別の「履歴」リポジトリに移動され、その時点で一部のデータ、特に詳細なエンゲージメント データは破棄されます。これは、計算が粒度の低いデータに基づいて行われるため、エンゲージメント スコアなどの計算フィールドがわずかに変化する可能性があることを意味します。

    データ粒度

    最近のAnalyticsデータの粒度はどのくらいですか?
    直近の32日間(当日を含む)については、 Analytics API は1時間ごとのバケットに保存するため、1時間ごとの粒度を報告します。ただし、現在の時間はまだ埋められているため、現在の時間に該当するデータを要求すると、APIが1時間よりも粒度が細いように見えることがあります。

    例は次のとおりです。

    1. 3時間前の9:15と9:20のデータを要求した場合、同じ時間バケットに含まれていれば、同じ値が得られるかもしれませんが、ただし、分析データは暫定的なものであり、調整されるまで変更される可能性があるため、異なる値になる可能性があります。
    2. 10分前のデータを要求し、5分待ってからもう一度要求すると、同じバケット内であっても、そのバケットはまだ更新されているため、異なる値を取得する可能性があります。
    分析データの更新間隔はどのくらいですか?
    現在、/dataエンドポイントは、クエリの間に3~4時間キャッシュされるため、直近1時間のトラフィックがある動画のリストでは、3~4時間の間隔が、作業するための差分を与える遅れとなります。
    過去の分析データの粒度はどのくらいですか?
    直近の32日よりも前の日付については、 Analytics API は、1日の値を報告します。つまり、from=1368334306919&to=1378446336919(2013年5月12日日曜日04:51:46GMTから2013年9月6日金曜日05:45:36GMTまで)をリクエストした場合 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はどういう意味ですか?
    データフィールドのnull値は、要求されたデータが処理されていないことを示します。最も可能性の高い理由は次のとおりです。
    • リクエストされたデータはごく最近のものであり、まだ処理されていない場合。
    • リクエストされたデータは非常に古いもので、現在の分析システムにまだインポートされていない場合。
    動画の名前を変更したのですが、Analyticsデータに古い名前が表示されるのはなぜですか?
    新しい名前は新しい分析イベントに記録されますが、履歴データの名前は変更されません。返されるビデオ名は、表示された時の名前になります。
    エンゲージメント値に、いつも整数が表示されないのはなぜですか?
    エンゲージメントの数値に小数点が付くことがあります。これは、エンゲージメントが正規化され、「video_percent_viewed * (video_engagement_25 / video_engagement_sum)」の比率になるためです。そのため、クエリで選択した時間範囲によっては、正確に割り切れない浮動小数点数が表示されることがあります。
    プレーヤー別に結果を絞り込むにはどうすればよいですか?

    レポート

    プレーヤーが使用した帯域幅をみると、0 GBと表示されるのはなぜですか?
    過去にBrightcoveはプレーヤーごとに帯域幅を報告していたため、プレーヤーごとに分類したいお客様は、帯域幅コストを配分する手段としてこれらのメトリックを使用できました。しかし、よりマニフェスト主導の配信(現在はHLS、将来はDASH)に移行するにつれて、セグメント化された動画の性質上、プレーヤーごとの帯域幅の追跡が正確ではなくなります。そのため、利用状況レポートにおいて、プレーヤーの帯域幅は重要視されなくなります。したがって、今後は、パフォーマンスレポートでプレーヤーが表示した秒数を使用して、プレーヤーごとにコストを割り当てることをお勧めします。

    その他

    分析レポートから従業員視聴回数を除外することはできますか?
    これを行う簡単な方法はありませんし、トラフィックの多い動画では、従業員の視聴はおそらくごく一部で、アナリティクスへの影響はごくわずかと考えられます。しかし、トラフィックの少ない動画でこれを行うことが重要だと思われる場合、最も簡単な解決策は、本番用プレーヤーを複製し、従業員にそのコピーで動画をテスト/視聴させることです。その後、フィルタを使用して、Analytics モジュールのカスタム レポート機能または Analytics API を使用して、プロダクション プレーヤのみに関するレポートを作成できます。

    ページの最終更新日22 Sep 2021