初始化和配置視頻分析

您可以配置播放器以跟蹤和分析視頻使用。

在激活視頻跟蹤（視頻心跳）之前，請確保您有以下幾點：

  • 用於Android的TVSDK
  • 配置/初始化資訊 — 有關特定視頻跟蹤帳戶資訊，請與Adobe代表聯繫：
ADBMobileConfig.json

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

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

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

帳戶名 也稱為報告套件ID(RSID)。
Marketing Cloud組織ID 實例化訪問者元件所需的字串值。
發佈者 這是發佈者ID，由客戶的Adobe代表提供給客戶。

提示：此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. 初始化和配置視頻心跳跟蹤元資料。

    重要

    您可以停止視頻分析模組中流，並根據需要重新初始化它。 在重新初始化模組之前，請確保視頻分析元資料也更新為正確的內容元資料。 要重新建立元資料，請重複子步驟1和2。

    1. 建立視頻分析元資料的實例。

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

      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;
}

    2. 將視頻分析元資料添加到全局元資料實例。

      準備好後，在媒體資源或媒體播放器項目上設定全局元資料實例：

      ((MetadataNode)resourceMetadata).setNode(
      DefaultMetadataKeys.VIDEO_ANALYTICS_METADATA_KEY.getValue(), vaMetadata);

    3. 初始化視頻分析跟蹤器。

      建立媒體播放器實例後，必須建立視頻分析跟蹤器實例並提供對媒體播放器實例的引用。

      秘訣

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

      VideoAnalyticsProvider videoAnalyticsProvider =
  new VideoAnalyticsProvider(appContext);

// Attach the TVSDK media player instance
videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);

    4. 銷毀視頻分析跟蹤器。

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

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

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

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

      秘訣

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

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

本頁內容