アナリティクスの統合
動画の取得と再生に、SDK に含まれる Brightcove プレーヤーと catalog を使用する場合、分析データは自動的に収集され、Video Cloud Analytics モジュールに表示されます。
BrightcoveVideoView クラスをオーバーライドする場合、または Brightcove プレーヤーとカタログを使用しない場合は、Video Cloud Analytics にアカウント ID を送信する必要があります。
プロパティのカスタマイズ
Brightcove Mobile SDK for Android バージョン 8.2.3 以降、次のカスタム値をアプリから Brightcove Analytics に送信できます。
- プレーヤー ID
- プレーヤー名
- アプリケーション ID
- 宛先 URI
- ソース URI
必要に応じて、プレーヤー、プレーヤー名、アプリケーション、宛先 URI、ソース URI を設定できます。デフォルト値はアプリケーションのパッケージ名に基づきます。
これらのプロパティは、Android の MainActivity クラスで設定できます。
brightcoveVideoView = (BrightcoveExoPlayerVideoView) findViewById(R.id.brightcove_video_view);
Analytics analytics = brightcoveVideoView.getAnalytics();
analytics.setDestination("valid URI");
analytics.setSource("valid URI");
analytics.setApplication("My Application Name");
analytics.setPlayerName("My Player Name");
analytics.setPlayerID("My-player-id");
アカウント
Brightcove Analytics でアカウント ID の値を設定するには、Video.Fields.PUBLISHER_ID プロパティを使用します。このプロパティは、動画のメタデータに accountID 値がない場合にのみ役立ちます。たとえば、アプリで accountID プロパティを含む Video Cloud 動画と、accountID プロパティを含まない Video Cloud 以外の動画を混在させる場合です。
たとえば、Native SDK for Android でリモート動画オブジェクトを作成するときに、アカウント ID 値を設定できます。
Video video = Video.createVideo("http://url.to.content/master.m3u8", DeliveryType.HLS);
video.getProperties().put(Video.Fields.PUBLISHER_ID, "your accountID");
Video.Fields.PUBLISHER_ID プロパティを設定すると、その値はこのリモート動画にのみ使用され、併用する Video Cloud 動画のレポートには影響しません。このプロパティの最も有用な値はアカウント ID です。Brightcove Catalog サービスを通じて取得されない動画は、Brightcove Analytics が詳細レポートをサポートしていないため、Analytics モジュールで その他/サードパーティ として報告されます。
宛先
destination プロパティを使用して、イベントの発生元の場所を設定します。destination プロパティの値は、次の例のように適切な URI 形式である必要があります。
bcsdk://com.mhogben.source
destination プロパティのデフォルト値は 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 の場合、source プロパティは Analytics サーバーに送信されません。
たとえば、source プロパティは次のように設定できます。
brightcoveVideoView.getAnalytics().setSource("bcsdk://com.brightcove.HLSPlayerSampleAppSource");
注: 宛先フィールドとソースフィールドで使用する URI 構造の詳細については、URI スキームの Wikipedia ページを参照してください。この URL エンコーダのようなツールを使用して、文字を UTF-8 エンコーディング形式に変換できます。
プレーヤー ID
player プロパティを使用して、プレーヤーの ID を設定します。
プレーヤー名
player_name プロパティを使用して、プレーヤーの名前を設定します。これは Studio のプレーヤー一覧に表示される名前と同じです。
アプリケーション ID
application フィールドは単独のフィールドではなく、プレーヤーの使用状況を識別するカスタム文字列です。
分析を見る
Video Cloud Analytics モジュールでは、アカウントレベルまたは動画別などの詳細レベルで指標データを表示できます。詳細については、次のドキュメントを参照してください。