從適用於Android的Native SDK發送Brightcove Analytics

在本主題中,您將學習如何使用適用於Android的Brightcove SDK通過移動應用程序在Brightcove Analytics中設置屬性。

分析整合

如果您使用Brightcove播放器,catalog包含在SDK中以檢索和播放視頻,分析數據將自動收集並顯示在Video Cloud Analytics模塊中。

如果您覆蓋BrightcoveVideoView類或不使用Brightcove播放器和目錄,則需要將帳戶ID發送到Video Cloud Analytics。

自定義屬性

從適用於Android的Brightcove Mobile SDK 4.2.7版本開始,您可以從應用程序將帳戶ID,目標URI和源URI的自定義值發送到Brightcove Analytics。

您的帳戶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 Analytics中設置“帳戶ID”值。僅在沒有屬性的情況下,此屬性才有用accountId影片中繼資料中的值(例如,如果您的應用程式使用混合的Video Cloud影片,其中包含accountId媒體資源和非視頻雲視頻,其中將不包含accountId屬性)。

例如,可以如下設置accountId屬性:

brightcoveVideoView.getAnalytics().setAccount("your accountId");

設置帳戶屬性後,此屬性的值將用於您尚未安裝accountId屬性。此屬性最有用的值是您自己的帳戶ID。這些視頻將在Google Analytics(分析)模塊中報告為其他/第三方因為Brightcove Analytics當前不支持未通過Brightcove目錄服務檢索的視頻的詳細報告。

對於Video Cloud視頻,設置此帳戶替換對報告沒有影響,因為視頻的accountId元數據值保持不變。設置此帳戶值不能覆蓋該值。

目的地

使用destination屬性,用於設置引發事件的位置的值。目的地屬性的值必須採用正確的URI格式,類似於以下示例:

bcsdk://com.mhogben.source

destination屬性的默認值為bcsdk://然後是應用程序名稱,然後是程序包名稱。

例如,在Android SDK HLS示例應用程序中,目標值為:

bcsdk://HLSSampleApp/com.brightcove.player.samples.hls.basic

您應用中任何實例化屏幕的屏幕brightcoveVideoView可以將此目標替代設置為不同的值,以更好地跟踪應用本身中的視頻觀看次數。

來源

使用source屬性設置將最終用戶發送到目標URI的URI。與目標值一樣,來源屬性的值必須是正確的 URI 格式,類似下列範例:

bcsdk://com.mhogben.source

source屬性的默認值為null。值為null時,源屬性不會發送到Analytics服務器。

例如,您可以如下設置source屬性:

brightcoveVideoView.getAnalytics().setSource("bcsdk://com.brightcove.HLSPlayerSampleAppSource");

注意:有關在目標字段和源字段中使用的URI結構的更多詳細信息,請參見URI方案維基百科頁面。您可以使用這樣的工具URL編碼器將字符轉換為UTF-8編碼格式。

查看分析

在視頻雲分析模塊中,您可以在帳戶級別或在詳細級別(例如通過視頻)查看指標數據。要了解如何操作,請查看以下文檔:

注意:Brightcove Analytics 會將您在所有報表中設定為全部小寫字串值的目標值和來源值轉換。