初始化並設定視訊分析

您可以設定您的播放器來追蹤和分析視訊使用。
在啟動視訊追蹤(視訊心率)之前,請確定您有下列項目:

  • 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. 手動將即時/線性串流標示為完成。

      如果您在一個即時串流上有不同的集數,您可以使用完整的API手動將集數標示為完整。 這會結束目前視訊集的視訊追蹤工作階段,而您可以開始下一集的新追蹤工作階段。

      秘訣

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

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

本頁內容