Initialize and configure video analytics

You can configure your player to track and analyze video use.
Before activating video tracking (video heartbeats), ensure that you have the following:

• TVSDK 3.0 for Android.

• Configuration / Initialization Information

  Contact your Adobe representative for your specific video-tracking account information:

To configure video tracking in your player:

1. Confirm that load-time options in the ADBMobileConfig.json resource file are correct.

   {
       "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" : ""
       }
   }
   

   This JSON-formatted configuration file is bundled as a resource with TVSDK. Your player reads these values only at load time, and the values remain constant while your application runs.

   To configure load-time options:

   1. Confirm that the ADBMobileConfig.json file contains the appropriate values (provided by Adobe).

   2. Confirm that this file is located in the assets/ folder.

      This folder must be located in the root of your application source tree.

   3. Compile and build your application.

   4. Deploy and run the bundled application.

      For more information about these AppMeasurement settings, see Measuring Video in Adobe Analytics.

2. Initialize and configure video heartbeat tracking metadata.

   IMPORTANT

   You can stop the video analytics module midstream and reinitialize it again as necessary. Before the module is reinitialized, ensure that the video analytics metadata is also updated to the correct content metadata. To recreate the metadata, repeat the first two steps below (sub-steps a and b).

   1. Create an instance of the Video Analytics metadata.

      This instance contains all of the configuration information that is needed to enable video heartbeat tracking. For example:

      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. Initialize the Video Analytics provider.

      After creating a media player instance, you must create a Video Analytics provider instance and provide the application context to it.

      TIP

      Always create a new provider instance for each content playback session and remove the previous reference after you detach the media player instance.

      VideoAnalyticsProvider videoAnalyticsProvider = new VideoAnalyticsProvider(appContext);
      
      

   3. Set the Video Analytics metadata on the videoAnalyticsProvider instance.

      videoAnalyticsProvider.setVideoAnalyticsMetadata(vaMetadata);
      

   4. Attach the media player instance to the videoAnalyticsProvider instance:

      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);
      

   5. Destroy the Video Analytics provider.

      Before you begin a new content playback session, destroy the previous instance of the video provider. After you receive the content complete event (or notification), wait a few minutes before you destroy the video analytics provider instance. Destroying the instance immediately might interfere with the Video Analytics provider’s ability to send a “video complete” ping.

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

   6. Manually mark the Live/Linear stream as complete.

      If you have various episodes on one live stream, you can manually mark an episode as complete by using the complete API. This ends the video tracking session for the current video episode, and you can start a new tracking session for the next episode.

      TIP

      This API is optional and does not work for VOD video tracking.

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