初始化和設定視訊分析

您可以設定您的播放器來追蹤和分析視訊的使用情形。
在啟用視訊追蹤（視訊心率）之前，請確定您有下列項目：

  • Android適用的TVSDK 3.0。

  • 配置/初始化資訊

    請連絡您的Adobe代表，以取得特定視訊追蹤帳戶資訊：

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元件所需的字串值。

若要在播放器中設定視訊追蹤：

  1. 確認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搭配為資源。 您的播放器只會在載入時讀取這些值，而且當您的應用程式執行時，這些值會維持不變。

    要配置載入時間選項：

    1. 確認ADBMobileConfig.json檔案包含適當的值(由Adobe提供)。

    2. 確認此檔案位於assets/資料夾中。

      此資料夾必須位於應用程式源樹的根目錄中。

    3. 編譯並構建您的應用程式。

    4. 部署並運行捆綁的應用程式。

      如需這些AppMeasurement設定的詳細資訊，請參閱在Adobe Analytics中測量視訊。

  2. 初始化並設定視訊心率追蹤中繼資料。

    重要

    您可以停止視訊分析模組中繼，並視需要重新初始化。 重新初始化模組之前，請確定視訊分析中繼資料也更新為正確的內容中繼資料。 要重新建立元資料，請重複下面的前兩個步驟（子步驟​a​和​b）。

    1. 建立Video Analytics中繼資料的例項。

      此例項包含啟用視訊心率追蹤所需的所有設定資訊。 例如：

      private VideoAnalyticsMetadata getVideoAnalyticsTrackingMetadata() {
    VideoAnalyticsMetadata vaMetadata = new VideoAnalyticsMetadata();

    vaMetadata.setTrackingServer("example.com");
    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.setEnableChapterTracking(true);
    // use this API to override the default asset length -1 for live streams
    vaMetadata.setAssetDuration(SAMPLE_ASSET_DURATION);

    return vaMetadata;
}

    2. 初始化Video Analytics提供者。

      建立媒體播放器例項後，您必須建立Video Analytics提供者例項，並提供應用程式內容給它。

      秘訣

      請務必為每個內容播放工作階段建立新的提供者例項，並在您分離媒體播放器例項後移除先前的參考。

      VideoAnalyticsProvider videoAnalyticsProvider = new VideoAnalyticsProvider(appContext);

    3. 在videoAnalyticsProvider例項上設定Video Analytics中繼資料。

      videoAnalyticsProvider.setVideoAnalyticsMetadata(vaMetadata);

    4. 將媒體播放器例項附加至videoAnalyticsProvider例項：

      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);

    5. 銷毀Video Analytics提供程式。

      開始新的內容播放工作階段之前，請銷毀視訊提供者的先前例項。 收到內容完成事件（或通知）後，請等待幾分鐘再銷毀視訊分析提供者例項。 若立即銷毀執行個體，可能會干擾視訊分析提供者傳送「視訊完成」Ping的能力。

      if (videoAnalyticsProvider) {
    videoAnalyticsProvider.detachMediaPlayer();
    videoAnalyticsProvider = null;
}

    6. 手動將即時/線性資料流標示為完成。

      如果您的一個即時資料流上有各種集數，可以使用complete API手動將集數標示為已完成。 這會結束目前視訊集數的視訊追蹤工作階段，而您可以開始下一集的新追蹤工作階段。

      秘訣

      此API為選用，無法用於VOD視訊追蹤。

      if (videoAnalyticsProvider) {
    videoAnalyticsProvider.trackVideoComplete();
}

本頁內容