Inizializzare e configurare l’analisi video

Puoi configurare il lettore per tenere traccia e analizzare l’utilizzo dei video.

Prima di attivare il tracciamento video (heartbeat video), assicurati di disporre dei seguenti elementi:

• Informazioni di inizializzazione TVSDK Configurazione/Browser - Contatta il tuo rappresentante di Adobe per informazioni specifiche sul tuo account di tracciamento video:

Per configurare il tracciamento video nel lettore:

1. Crea un'istanza e configura la libreria VisitorAPI.

   Considera le seguenti informazioni:
   

   • La creazione di un'istanza richiede un parametro di input dell'ID organizzazione Marketing Cloud fornito da Adobe.

     Questo è un valore stringa.

   • L'unica opzione di configurazione per la libreria VisitorAPI è l'URL dell'endpoint di back-end che fornisce l'identificatore univoco per l'utente corrente.

   • L’URL del server di tracciamento dei visitatori è lo stesso dell’URL del server di tracciamento di Analytics.

     Per informazioni sull'implementazione del servizio ID visitatori, consulta Implementazione del servizio ID visitatori.

   var_visitor = new Visitor("MARKETING_CLOUD_ORG_ID");
   _visitor.trackingServer = "URL_OF_THE_VISITOR_TRACKER_SERVER”;
   

2. Crea un'istanza e configura il componente AppMeasurement.

   L'istanza AppMeasurement dispone di molte opzioni di configurazione. Per ulteriori informazioni, consulta la documentazione Adobe Analytics Developer . Le opzioni nel seguente codice di esempio ( account, visitorNamespace e trackingServer) sono obbligatorie e i valori sono forniti da un Adobe.

   IMPORTANTE

   È necessario assicurarsi che la catena di dipendenze sia impostata correttamente. L’istanza AppMeasurement aggrega (dipende da) il componente API del visitatore.

   var appMeasurement = new AppMeasurement();
   appMeasurement.visitor = visitor;
   appMeasurement.trackingServer = 'URL_OF_THE_ADOBE_ANALYTICS_TRACKING_SERVER';
   appMeasurement.account = 'ACCOUNT_NAME'; // Also known as RSID
   appMeasurement.pageName = 'Sample Page Name';
   appMeasurement.charSet = "UTF-8";
   appMeasurement.visitorID = "test-vid";
   

   IMPORTANTE

   Nell’applicazione, assicurati che appMeasurementObject.visitor sia popolato prima di avviare il flusso di analisi video, altrimenti potresti non ottenere alcun risultato di tracciamento. Questi risultati sono indicati dai messaggi nel registro. Puoi aggiungere una chiamata di tracciamento vuota ( appMeasurementObject.track), eseguire il polling della proprietà visitor fino a quando non viene compilata e avviare l'analisi video.

3. Inizializzare e configurare i metadati di tracciamento heartbeat video.

   IMPORTANTE

   È possibile arrestare il flusso midstream del modulo di analisi video e reinizializzarlo in base alle esigenze. Prima di reinizializzare il modulo, assicurati che i metadati di analisi video siano aggiornati anche ai metadati del contenuto corretti. Per ricreare i metadati, ripeti i passaggi secondari 1 e 2.

   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:

      function getVideoAnalyticsMetadata() {
          var vaObj = new AdobePSDK.VA.VideoAnalyticsMetadata();
          vaObj.appMeasurement = appMeasurement;
          vaObj.trackingServer = 'hbTrackingServer';
          vaObj.publisher = 'hbPublisher';
          vaObj.channel = 'sample-channel';
          vaObj.playerName = 'TVSDK-HTML';
          vaObj.appVersion = '1.0.0';
          vaObj.videoName = 'hbFriendlyName'; // this will overwrite the ContextData variable a.media.friendlyName
          vaObj.assetDuration = durationInSeconds;
          // use this to override the default asset length of -1 for live streams
          vaObj.debugLogging = false;
          return vaObj;
      }
      

   2. Dopo aver creato un'istanza di lettore multimediale, crea un'istanza di tracciamento di Video Analytics e fornisci un riferimento all'istanza di lettore multimediale.
      Ricorda quanto segue:

      • Crea sempre una nuova istanza di tracciamento per ogni sessione di riproduzione dei contenuti e rimuovi il riferimento precedente (dopo aver scollegato l'istanza di Media Player).

      • I metadati creati nel passaggio 1 secondario devono essere forniti nel costruttore di Video Analytics Tracker.

        var videoAnalyticsMetadata = getVideoAnalyticsMetadata();
        videoAnalyticsProvider = new AdobePSDK.VA.VideoAnalyticsProvider(videoAnalyticsMetadata);
        videoAnalyticsProvider.attachMediaPlayer(player);
        

   3. Distruggi il tracker di Video Analytics.
      Prima di iniziare una nuova sessione di riproduzione dei contenuti, elimina l’istanza precedente del tracker di video. Dopo aver ricevuto l’evento di completamento del contenuto (o notifica), attendi alcuni minuti prima di eliminare l’istanza di tracciamento video. La distruzione immediata dell’istanza potrebbe interferire con la capacità del tracker di Video Analytics di inviare un ping completo del video.

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

   4. Contrassegna manualmente il flusso Live/Lineare come completato.
      Se hai vari episodi su uno streaming live, puoi contrassegnare manualmente un episodio come completo utilizzando l'API completa. Questo termina la sessione di tracciamento video per l'episodio video corrente e puoi avviare una nuova sessione di tracciamento per l'episodio successivo.

      SUGGERIMENTO

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

      if (videoAnalyticsProvider)
      {
         videoAnalyticsProvider.trackVideoComplete();
      videoAnalyticsProvider.detachMediaPlayer();
      videoAnalyticsProvider = null;
      // Create a new instance of VideoAnalyticsProvider to continue tracking.
      }
      

Risorse Business.Adobe.com