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

    iOS用ネイティブSDKからBrightcoveAnalyticsを送信する

    このトピックでは、iOS用のBrightcove SDKを使用して、モバイルアプリからBrightcoveAnalyticsのプロパティを設定する方法を学習します。

    アナリティクスの統合

    動画を取得および再生するために 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 モジュールでは、アカウントレベルまたは詳細レベル(ビデオ別など)で指標データを表示できます。方法については、次のドキュメントを参照してください。


    ページの最終更新日04 Oct 2021