Inizializzare e configurare l’analisi video

Puoi configurare il lettore per il tracciamento e l’analisi dell’utilizzo dei video.
Prima di attivare il tracciamento video (heartbeat video), assicurati di disporre dei seguenti elementi:

• TVSDK 2.5 per Android.

• Informazioni su configurazione/inizializzazione

  Contatta il rappresentante di Adobe per informazioni specifiche sull’account di tracciamento video:

Per configurare il tracciamento video nel lettore:

1. Conferma che le opzioni di caricamento nel ADBMobileConfig.json il file di risorse è corretto.

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

   Questo file di configurazione in formato JSON è incluso come risorsa con TVSDK. Il lettore legge questi valori solo al momento del caricamento e i valori rimangono costanti durante l’esecuzione dell’applicazione.

   Per configurare le opzioni del tempo di caricamento:

   1. Confermare che ADBMobileConfig.json Il file contiene i valori appropriati (forniti dall'Adobe).

   2. Conferma che il file si trovi in assets/ cartella.

      Questa cartella deve trovarsi nella radice della struttura di origine dell'applicazione.

   3. Compila e genera l’applicazione.

   4. Distribuire ed eseguire l'applicazione in bundle.

      Per ulteriori informazioni su queste impostazioni AppMeasurement, vedi Misurazione dei video in Adobe Analytics.

2. Inizializza e configura i metadati di tracciamento heartbeat video.

   IMPORTANTE

   Puoi arrestare il modulo di analisi video nel flusso intermedio e reinizializzarlo, se necessario. Prima di reinizializzare il modulo, accertati che anche i metadati di analisi video siano aggiornati ai metadati di contenuto corretti. Per ricreare i metadati, ripeti i primi due passaggi seguenti (passaggi secondari) a e b).

   1. Crea un’istanza dei metadati di Video Analytics.

      Questa istanza contiene tutte le informazioni di configurazione necessarie per abilitare il tracciamento heartbeat video. Ad esempio:

      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. Inizializza il provider Video Analytics.

      Dopo aver creato un’istanza del lettore multimediale, devi creare un’istanza del provider Video Analytics e fornirle il contesto dell’applicazione.

      SUGGERIMENTO

      Crea sempre una nuova istanza del provider per ogni sessione di riproduzione dei contenuti e rimuovi il riferimento precedente dopo aver scollegato l’istanza del lettore multimediale.

      VideoAnalyticsProvider videoAnalyticsProvider = new VideoAnalyticsProvider(appContext);
      

   3. Imposta i metadati di Video Analytics su videoAnalyticsProvider dell'istanza.

      videoAnalyticsProvider.setVideoAnalyticsMetadata(vaMetadata);
      

   4. Allega l’istanza del lettore multimediale a videoAnalyticsProvider istanza:

      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);
      

   5. Elimina il provider Video Analytics.

      Prima di iniziare una nuova sessione di riproduzione dei contenuti, elimina l’istanza precedente del provider video. Dopo aver ricevuto l’evento di completamento del contenuto (o la notifica), attendi alcuni minuti prima di eliminare l’istanza del provider di analisi video. Distruggere immediatamente l’istanza potrebbe interferire con la capacità del provider Video Analytics di inviare un ping "video completato".

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

   6. Contrassegna manualmente il flusso live/lineare come completato.

      Se hai diversi episodi su un flusso live, puoi contrassegnare manualmente un episodio come completo utilizzando l’API completa. In questo modo si termina la sessione di tracciamento video per l’episodio video corrente e si può avviare una nuova sessione di tracciamento per l’episodio successivo.

      SUGGERIMENTO

      Questa API è facoltativa e non funziona per il tracciamento video VOD.

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

Risorse Business.Adobe.com