初始化和配置視頻分析

您可以配置播放器以跟蹤和分析視頻使用。
在激活視頻跟蹤（視頻心跳）之前，請確保您有以下幾點：

  • 用於Android的TVSDK 2.5。

  • 配置/初始化資訊

    請聯繫您的Adobe代表，瞭解您的特定視頻跟蹤帳戶資訊：

ADBMobileConfig.json

重要提示：此JSON配置檔案名必須保留 ADBMobileConfig.json 。 無法更改此配置檔案的名稱和路徑。 此檔案的路徑必須為 <source root="">/assets 。

AppMeasurement跟蹤伺服器終結點 Adobe Analytics(以前為SiteCatalyst)後端集合終結點的URL。
視頻分析跟蹤伺服器終結點 視頻分析後端集合終結點的URL。 這是發送所有視頻心跳跟蹤呼叫的地方。

提示：訪問者跟蹤伺服器的URL與分析跟蹤伺服器的URL相同。 有關實施訪問者ID服務的資訊，請參見 實施ID服務 。

帳戶名 也稱為報告套件ID(RSID)。
Marketing Cloud組織ID 實例化訪問者元件所需的字串值。

要在播放器中配置視頻跟蹤，請執行以下操作：

  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. 建立視頻分析元資料的實例。

      此實例包含啟用視頻心跳跟蹤所需的所有配置資訊。 例如：

      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. 初始化視頻分析提供程式。

      建立媒體播放器實例後，必須建立視頻分析提供程式實例並向其提供應用程式上下文。

      秘訣

      始終為每個內容播放會話建立新的提供程式實例，並在分離媒體播放器實例後刪除以前的引用。

      VideoAnalyticsProvider videoAnalyticsProvider = new VideoAnalyticsProvider(appContext);

    3. 在 videoAnalyticsProvider 實例。

      videoAnalyticsProvider.setVideoAnalyticsMetadata(vaMetadata);

    4. 將媒體播放器實例連接到 videoAnalyticsProvider 實例：

      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);

    5. 銷毀視頻分析提供程式。

      在開始新的內容播放會話之前，請銷毀視頻提供程式的先前實例。 收到內容完成事件（或通知）後，請等待幾分鐘，然後銷毀視頻分析提供程式實例。 立即銷毀實例可能會干擾視頻分析提供程式發送「視頻完整」ping的能力。

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

    6. 手動將Live/Linear流標籤為完成。

      如果您在一個即時流上有各種集數，則可以使用完整的API手動將集數標籤為完整。 這將結束當前視頻集的視頻跟蹤會話，並且您可以為下一集啟動新的跟蹤會話。

      秘訣

      此API是可選的，不適用於VOD視頻跟蹤。

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

本頁內容