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

    よくある質問:Analytics API

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

    日付範囲

    特定の日のデータを取得するにはどうすればよいですか?
    両方を設定しますfromそしてtoその日付までの値。例: from=2013-05-12&to=2013-05-12。さらに、次の方法でクエリを実行できます。date寸法、他の寸法と組み合わせることができます。
    分析モジュールとAnalytics API同じ日付範囲のIDデータを教えてください。
    はい。ただし、比較的最近のデータを比較していて、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エンドポイントは現在、クエリ間で5分間キャッシュされているため、過去1時間にトラフィックがあった動画のリストの場合、5分間隔が、作業のデルタを与える最小の遅延です。
    過去の分析データの粒度はどのくらいですか?
    過去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
    A nullデータフィールドの値は、要求されたデータが処理されていないことを示します。最も可能性の高い理由は次のとおりです。
    • リクエストしたデータはごく最近のものであり、まだ処理されていません
    • リクエストしたデータは非常に古く、現在の分析システムにまだインポートされていません
    ビデオの1つの名前を変更しました-Analyticsデータに古い名前が表示されるのはなぜですか?
    新しい名前は新しい分析イベントに記録されますが、履歴データの名前は変更されません。返されるビデオ名は、表示されたときの名前になります。
    エンゲージメント値の整数が常に表示されないのはなぜですか?
    エンゲージメント番号が小数点で戻る可能性があります。その理由は、エンゲージメントが正規化されているためです。つまり、「video_percent_viewed *(video_engagement_25 / video_engagement_sum)」の比率であるため、クエリで選択した時間範囲に基づいて、正確に分割されていない場合に浮動小数点数が表示されることがあります。
    プレーヤーで結果をフィルタリングするにはどうすればよいですか?

    報告

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

    雑多

    解析レポートから従業員視聴回数を除外できますか
    これを行う簡単な方法はありません。高トラフィックの動画では従業員視聴回数は割合が小さいことが多いため、解析への影響は無視できるでしょう。ただし、これが重要だとお客様が考える低トラフィック動画では、実動プレーヤーを複写し、従業員はコピーで動画のテストや視聴を行うのが最も簡単な解決策です。次に、フィルターを使用して、実動プレーヤーだけに関するレポートを作成します。Analyticsモジュールでカスタムレポート機能を使用するか、Analytics APIを使用してください。

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