您可以設定您的播放器來追蹤和分析視訊的使用情形。
在啟用視訊追蹤(視訊心率)之前,請確定您有下列項目:
ADBMobileConfig.json | 重要: 此JSON設定檔案名稱必須保留 ADBMobileConfig.json 。 無法更改此配置檔案的名稱和路徑。 此檔案的路徑必須是 <source root>/assets 。 |
AppMeasurement追蹤伺服器端點 | Adobe Analytics(前身為SiteCatalyst)後端收集端點的URL。 |
Video Analytics追蹤伺服器端點 | video analytics後端收集端點的URL。 這是所有視訊心率追蹤呼叫的傳送位置。 提示: 訪客追蹤伺服器的URL與分析追蹤伺服器的URL相同。 如需實作訪客ID服務的相關資訊,請參閱實作ID服務。 |
帳戶名稱 | 也稱為報表套裝ID(RSID)。 |
Marketing Cloud組織ID | 具現化Visitor元件所需的字串值。 |
發佈者 | 這是發佈者ID,由客戶代表提供給Adobe。 提示: 此ID不只是具有品牌/電視名稱的字串。 |
若要在播放器中設定視訊追蹤:
確認ADBMobileConfig.json
資源檔案中的載入時間選項正確。
{
"version" : "1.1",
"analytics" : {
"rsids" : "adobedevelopment",
"server" : "10.131.129.149:3000",
"charset" : "UTF-8",
"ssl" : false,
"offlineEnabled" : false,
"lifecycleTimeout" : 5,
"batchLimit" : 50,
"privacyDefault" : "optedin",
"poi" : []
},
"marketingCloud": {
"org": "ADOBE PROVIDED VALUE"
},
"target" : {
"clientCode" : "",
"timeout" : 5
},
"audienceManager" : {
"server" : ""
}
}
此JSON格式的設定檔案是與TVSDK搭配為資源。 您的播放器只會在載入時讀取這些值,而且當您的應用程式執行時,這些值會維持不變。
要配置載入時間選項:
確認ADBMobileConfig.json
檔案包含Adobe提供的適當值。
確認此檔案位於assets
資料夾中。
此資料夾必須位於應用程式源樹的根目錄中。
編譯並構建您的應用程式。
部署並運行捆綁的應用程式。
如需這些AppMeasurement設定的詳細資訊,請參閱在Adobe Analytics中測量視訊。
初始化並設定視訊心率追蹤中繼資料。
您可以停止視訊分析模組中繼,並視需要重新初始化。 重新初始化模組之前,請確定視訊分析中繼資料也更新為正確的內容中繼資料。 要重新建立元資料,請重複子步驟1和2。
建立Video Analytics中繼資料的例項。
此例項包含啟用視訊心率追蹤所需的所有設定資訊。 例如:
private VideoAnalyticsMetadata getVideoAnalyticsTrackingMetadata() {
VideoAnalyticsMetadata vaMetadata = new VideoAnalyticsMetadata();
vaMetadata.setTrackingServer("example.com");
vaMetadata.setPublisher("sample-publisher");
vaMetadata.setChannel("test-channel");
vaMetadata.setVideoName("myvideo");
vaMetadata.setVideoId("myvideoid");
vaMetadata.setPlayerName("PSDK Player");
vaMetadata.setUseSSL(false);
vaMetadata.debugLogging = true; // Set to NO for production deployment.
vaMetadata.quietMode = false; // Set to NO for production deployment.
vaMetadata.setEnableChapterTracking(true);
// use this API to override the default asset length -1 for live streams
vaMetadata.setAssetDuration(SAMPLE_ASSET_DURATION);
return vaMetadata;
}
將Video Analytics中繼資料新增至全域中繼資料例項。
準備好後,請在媒體資源或媒體播放器項目上設定全域中繼資料例項:
((MetadataNode)resourceMetadata).setNode(
DefaultMetadataKeys.VIDEO_ANALYTICS_METADATA_KEY.getValue(), vaMetadata);
初始化Video Analytics追蹤器。
建立媒體播放器例項後,您必須建立Video Analytics追蹤器例項,並提供媒體播放器例項的參考。
請務必為每個內容播放工作階段建立新的追蹤器例項,並在您分離媒體播放器例項後移除先前的參考。
VideoAnalyticsProvider videoAnalyticsProvider =
new VideoAnalyticsProvider(appContext);
// Attach the TVSDK media player instance
videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);
銷毀Video Analytics追蹤器。
開始新內容播放工作階段之前,請銷毀視訊追蹤器的先前例項。 收到內容完成事件(或通知)後,請等待幾分鐘再銷毀視訊追蹤器例項。 若立即銷毀例項,可能會干擾Video Analytics追蹤器傳送視訊完成Ping的功能。
if (_videoAnalyticsProvider) {
_videoAnalyticsProvider.detachMediaPlayer();
_videoAnalyticsProvider = null;
}
手動將即時/線性資料流標示為完成。
如果您的一個即時資料流上有各種集數,可以使用complete API手動將集數標示為已完成。 這會結束目前視訊集數的視訊追蹤工作階段,而您可以開始下一集的新追蹤工作階段。
此API為選用API,不是VOD視訊追蹤所需的API。
if (_videoAnalyticsProvider) {
_videoAnalyticsProvider.trackVideoComplete();
}