アナリティクスの統合
SDK に含まれる Brightcove プレーヤーと catalog を使用して動画を取得および再生する場合、アナリティクスデータは自動的に収集され、Video Cloud Analytics モジュールに表示されます。
Video Cloud のアカウントメタデータを含まない独自の BCOVVideo オブジェクトを作成する場合は、アカウント ID を Video Cloud Analytics に送信する必要があります。
プロパティのカスタマイズ
iOS 版 Brightcove Mobile SDK のバージョン 6.12.4 以降、次のカスタム値をアプリから Brightcove Analytics に送信できます。
- プレーヤー ID
- プレーヤー名
- アプリケーション ID
- 配信先 URI
- ソース URI
必要に応じて、配信先 URI とソース URI を設定できます。配信先のデフォルト値は、アプリのバンドル識別子の先頭に bcsdk:// を付けたものです。ソースのデフォルト値は nil で、アナリティクスのリクエストには含まれません。
ViewControllerこれらのプロパティは実装ファイルで設定できます。これは通常、作成を呼び出した後に行われますPlaybackController。
id<BCOVPlaybackController> controller =
[[BCOVPlayerSDKManager sharedManager] createPlaybackController];
controller.analytics.destination = @"myapp://com.mycompany.homescreen";
controller.analytics.source = @"myapp://com.mycompany.menu";
controller.analytics.player = @"My-player-id";
controller.analytics.playerName = @"My-player-name";
controller.analytics.applicationId = @"My Application Name";
アカウント
1 本の動画にアカウント ID を設定する例を次に示します。
BCOVVideo *video = [BCOVVideo videoWithHLSSourceURL:[NSURL URLWithString:@"https://url.to.content/master.m3u8"]];
video = [video update:^(BCOVMutableVideo * _Nonnull mutableVideo) {
NSMutableDictionary *updatedProperties = mutableVideo.properties.mutableCopy;
updatedProperties[BCOVVideo.PropertyKeyAccountId] = @"your accountID";
mutableVideo.properties = updatedProperties;
}];
配信先
destinationプロパティを使用して、イベントが発生した場所の値を設定します。destination プロパティの値は、次の例のように、適切な URI 形式である必要があります。
bcsdk://com.mhogben.source
destination プロパティのデフォルト値は、アプリの Info.plist ファイルに記載されているアプリのバンドル識別子の先頭に bcsdk:// を付けたものです。
たとえば、iOS サンプルアプリでは、デフォルトの配信先は bcsdk://com.brightcove.sampleAppMainScreen.Destination になり、次のように上書きできます。
controller.analytics.destination =
@"myapp://com.mycompany.homescreen.destination";
をインスタンス化するアプリ内のどの画面でも、この宛先オーバーライドを個別の値に設定して、BCOVPlaybackControllerアプリ自体のビデオ視聴をより良く追跡できます。
ソース
source プロパティを使用して、エンドユーザーを配信先 URI に送信した URI を設定します。配信先の値と同様に、source プロパティの値は、次の例のように適切な URI 形式である必要があります。
bcsdk://com.mhogben.source
ソースプロパティのデフォルト値は nil です。値が nil の場合、ソースプロパティは Analytics サーバーに送信されません。
sourceプロパティを設定する方法の例を次に示します。
controller.analytics.source =
@"myapp://com.mycompany.homescreen.destination.source";
プレーヤー ID
player プロパティを使用して、プレーヤーの ID を設定します。
プレーヤー名
playerName プロパティを使用して、プレーヤー名を設定します。これは Studio のプレーヤー一覧に表示される名前と同じです。
アプリケーション ID
applicationId フィールドは、プレーヤーの使用状況を識別するためのカスタム文字列です。
分析の表示
Video Cloud Analytics モジュールでは、アカウントレベルまたは詳細レベル（ビデオ別など）で指標データを表示できます。方法については、次のドキュメントを参照してください。