初始化和配置視頻分析

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

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

• iOSTVSDK
• 配置/初始化資訊 — 有關特定視頻跟蹤帳戶資訊，請與Adobe代表聯繫：

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

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. 確認此檔案位於 AdobeMobile 的子菜單。

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

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

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

      有關這些AppMeasurement設定的詳細資訊，請參見 Adobe Analytics視頻測量。

2. 初始化和配置視頻心跳跟蹤元資料。

   重要

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

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

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

      - (PTVideoAnalyticsTrackingMetadata *)getVideoAnalyticsTrackingMetadata
      {
          PTVideoAnalyticsTrackingMetadata *vaTrackingMetadata =
            [[[PTVideoAnalyticsTrackingMetadata alloc]
                 initWithTrackingServer:@"example.com"
                 publisher:@"sample-publisher"] autorelease];
      
          // Set these to NO for production deployment.
          vaTrackingMetadata.debugLogging = YES;
          vaTrackingMetadata.quietMode = NO;
      
          vaTrackingMetadata.channel = @"test-channel";
          vaTrackingMetadata.videoName = @"myvideo";
          vaTrackingMetadata.videoId = @"myvideoid";
          vaTrackingMetadata.playerName = @"PSDK Player";
          vaTrackingMetadata.enableChapterTracking = YES;
          vaTrackingMetadata.useSSL = NO;
          // use this API to override the default asset length -1 for live streams
          vaTrackingMetadata.assetDuration = SAMPLE_ASSET_DURATION;
      
      }
      

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

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

      - (PTMetadata *)createMetadata
      {
          PTMetadata *metadata = [[[PTMetadata alloc] init] autorelease];
      
          [metadata setMetadata:[self getVideoAnalyticsTrackingMetadata]
            forKey:PTVideoAnalyticsTrackingMetadataKey];
      
          return metadata;
      }
      
      PTMetadata *metadata = [self createMetadata];
      
      PTMediaPlayerItem *item =
        [[[PTMediaPlayerItem alloc] initWithUrl:[[[NSURL alloc]
          initWithString:@"media-url"] autorelease]
          mediaId:@"media-id" metadata:metadata] autorelease];
      

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

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

      秘訣

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

      self.videoAnalyticsTracker =
        [[[PTVideoAnalyticsTracker alloc] initWithMediaPlayer:self.player] autorelease];
      

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

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

      self.videoAnalyticsTracker = nil;
      

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

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

      秘訣

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

      if (self.videoAnalyticsTracker)
      {
         [self.videoAnalyticsTracker trackVideoComplete];
      }
      

Business.Adobe.com 資源