アナリティクスの統合
動画を取得および再生するために Brightcove プレーヤーを使用し、SDK catalog
に含まれている場合、分析データは自動的に収集され、Video Cloud Analytics モジュールに表示されます。
BCOVVideo
クラスを上書きした場合、または Brightcove プレーヤーとを使用しない場合はcatalog
、アカウント ID を Video Cloud Analytics に送信する必要があります。
プロパティのカスタマイズ
iOS 版 Brightcove Mobile SDK のバージョン 4.1.8 以降、アカウント ID、送信先 URI、ソース URI のカスタム値をアプリから Brightcove Analytics に送信できます。
アカウント ID は必須ですが、Brightcoveプレーヤーとを使用するときに自動的に設定されますcatalog
。
必要に応じて、宛先およびソース URI を設定できます。デフォルト値は、アプリケーションパッケージ名に基づきます。
ViewController
これらのプロパティは実装ファイルで設定できます。これは通常、作成を呼び出した後に行われますPlaybackController
。
id<BCOVPlaybackController> controller =
[[BCOVPlayerSDKManager sharedManager] createPlaybackController];
controller.analytics.account = your accountId;
controller.analytics.destination = valid URI;
controller.analytics.source = valid URI;
アカウント
account
プロパティを使用して、Brightcoveアナリティクスでアカウント ID の値を設定します。このプロパティは、accountId
動画のメタデータに値がない場合にのみ役立ちます(たとえば、アプリで、accountId
プロパティを含む Video Cloud 動画と Video Cloud 以外の動画が混在している場合、accountId
プロパティは含まれません)。
controller.analytics.account = @"your accountId";
アカウントプロパティを設定すると、このプロパティの値は、accountId
まだプロパティを持っていないあなたのビデオのいずれかに使用されます。このプロパティで最も有用な値は、独自のアカウント ID です。Brightcove Catalog サービスを通じて取得されない動画については、現在 Brightcove Analytics が詳細レポートをサポートしていないため、これらの動画は Analytics モジュールで [ その他/サードパーティ ] として報告されます。
Video Cloud 動画の場合、accountId
動画のメタデータ値は変更されないため、このアカウントのオーバーライドを設定してもレポートには影響しません。このアカウント値を設定しても、その値を上書きすることはできません。
配信先
destination
プロパティを使用して、イベントが発生した場所の値を設定します。destination プロパティの値は、次の例のように、適切な URI 形式である必要があります。
bcsdk://com.mhogben.source
bcsdk://
デフォルト値のdestinationプロパティの後には、アプリの info.plistファイルに記載されているアプリのバンドル識別子が続きます。
たとえば、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";
分析の表示
Video Cloud Analytics モジュールでは、アカウントレベルまたは詳細レベル(ビデオ別など)で指標データを表示できます。方法については、次のドキュメントを参照してください。