アナリティクスの統合
動画を取得および再生するために Brightcove プレーヤーを使用し、SDK catalog
に含まれている場合、分析データは自動的に収集され、Video Cloud Analytics モジュールに表示されます。
オーバーライドする場合BrightcoveVideoView
クラスを作成するか、Brightcoveプレーヤーとカタログを使用しない場合は、アカウントIDをVideo CloudAnalyticsに送信する必要があります。
プロパティのカスタマイズ
Brightcove Mobile SDK for Androidのバージョン4.2.7以降、アカウントID、宛先URI、およびソースURIのカスタム値をアプリからBrightcoveAnalyticsに送信できます。
アカウント ID は必須ですが、Brightcoveプレーヤーとを使用するときに自動的に設定されますcatalog
。
必要に応じて、宛先およびソース URI を設定できます。デフォルト値は、アプリケーションパッケージ名に基づきます。
これらのプロパティはAndroidで設定できますMainActivity
クラスファイル:
brightcoveVideoView = (SeamlessVideoView) findViewById(R.id.brightcove_video_view);
Analytics analytics = brightcoveVideoView.getAnalytics();
analytics.setAccount("your accountID");
analytics.setDestination("valid URI");
analytics.setSource("valid URI");
アカウント
account
プロパティを使用して、Brightcoveアナリティクスでアカウント ID の値を設定します。このプロパティは、accountId
動画のメタデータに値がない場合にのみ役立ちます(たとえば、アプリで、accountId
プロパティを含む Video Cloud 動画と Video Cloud 以外の動画が混在している場合、accountId
プロパティは含まれません)。
たとえば、accountIdプロパティを次のように設定できます。
brightcoveVideoView.getAnalytics().setAccount("your accountId");
アカウントプロパティを設定すると、このプロパティの値は、accountId
まだプロパティを持っていないあなたのビデオのいずれかに使用されます。このプロパティで最も有用な値は、独自のアカウント ID です。Brightcove Catalog サービスを通じて取得されない動画については、現在 Brightcove Analytics が詳細レポートをサポートしていないため、これらの動画は Analytics モジュールで [ その他/サードパーティ ] として報告されます。
Video Cloud 動画の場合、accountId
動画のメタデータ値は変更されないため、このアカウントのオーバーライドを設定してもレポートには影響しません。このアカウント値を設定しても、その値を上書きすることはできません。
配信先
destination
プロパティを使用して、イベントが発生した場所の値を設定します。destination プロパティの値は、次の例のように、適切な URI 形式である必要があります。
bcsdk://com.mhogben.source
宛先プロパティのデフォルト値はbcsdk://
アプリ名、パッケージ名の順に続きます。
たとえば、Android SDK HLSサンプルアプリでは、宛先の値は次のようになります。
bcsdk://HLSSampleApp/com.brightcove.player.samples.hls.basic
をインスタンス化するアプリ内のどの画面でも、この宛先オーバーライドを個別の値に設定して、brightcoveVideoView
アプリ自体のビデオ視聴をより良く追跡できます。
ソース
source
このプロパティを使用して、エンドユーザーを宛先 URI に送信した URI を設定します。宛先値と同様に、source プロパティの値は、次の例のように適切な URI 形式である必要があります。
bcsdk://com.mhogben.source
sourceプロパティのデフォルト値はnullです。値がnullの場合、ソースプロパティはAnalyticsサーバーに送信されません。
たとえば、sourceプロパティを次のように設定できます。
brightcoveVideoView.getAnalytics().setSource("bcsdk://com.brightcove.HLSPlayerSampleAppSource");
注:宛先フィールドとソースフィールドで使用する URI 構造の詳細については、 URI スキームの Wikipedia ページを参照してください。このURLエンコーダのようなツールを使用して、文字を UTF-8 エンコーディング形式に変換することができます。
分析を見る
Video Cloud Analytics モジュールでは、アカウントレベルまたは詳細レベル(ビデオ別など)で指標データを表示できます。方法については、次のドキュメントを参照してください。
注:Brightcove Analytics では、設定した送信先とソースの値が、すべてのレポートですべて小文字の文字列値に変換されます。