Inicializar y configurar Video Analytics

Puede configurar el reproductor para rastrear y analizar el uso de vídeo.

Antes de activar el seguimiento de vídeo (latidos de vídeo), asegúrese de que dispone de lo siguiente:

  • TVSDK para Desktop HLS
  • Información de configuración/inicialización : póngase en contacto con su representante de Adobe para obtener información específica sobre su cuenta de seguimiento de vídeo:
Punto final del servidor de seguimiento de AppMeasurement La dirección URL del extremo de recopilación back-end de Adobe Analytics (anteriormente SiteCatalyst).
Punto final del servidor de seguimiento de Video Analytics Dirección URL del extremo de recopilación back-end de video analytics. Aquí es donde se envían todas las llamadas de seguimiento de Video Heartbeat.

Sugerencia: La dirección URL del servidor de seguimiento de visitantes es la misma que la dirección URL del servidor de seguimiento de Analytics. Para obtener información sobre la implementación del servicio de ID de visitante, consulte Implementación del servicio de ID .

Nombre de la cuenta También conocido como ID de grupo de informes (RSID).
ID de organización de Marketing Cloud Un valor de cadena necesario para crear una instancia del componente Visitante.
Punto final del servidor de seguimiento de visitantes Dirección URL del extremo back-end que proporciona un identificador único para el visor de vídeo actual.
Editor Este es el ID del editor que su representante de Adobe proporciona a los clientes.

Sugerencia: Este ID no es solo una cadena con el nombre de marca o televisión.

Para configurar el seguimiento de vídeo en el reproductor:

  1. Cree una instancia de la biblioteca VisitorAPI y configúrela.

    Tenga en cuenta la siguiente información:
    
    • La creación de instancias requiere un parámetro de entrada de ID de organización de Marketing Cloud proporcionado por el Adobe.

      Es un valor de cadena.

    • La única opción de configuración para la biblioteca VisitorAPI es la URL del extremo back-end que proporciona el identificador único para el usuario actual.

    • La dirección URL del servidor de seguimiento de visitantes es la misma que la dirección URL del servidor de seguimiento de Analytics.

      Para obtener información sobre la implementación del servicio de ID de visitante, consulte Implementación del servicio de ID de visitante.

    var_visitor = new Visitor("MARKETING_CLOUD_ORG_ID"); 
    _visitor.trackingServer = "URL_OF_THE_VISITOR_TRACKER_SERVER”; 
    
  2. Cree una instancia del componente AppMeasurement y configúrelo.

    La instancia de AppMeasurement tiene muchas opciones de configuración. Para obtener más información, consulte la documentación Adobe Analytics Developer. Las opciones del siguiente código de muestra ( account, visitorNamespace y trackingServer) son necesarias y los valores se proporcionan mediante Adobe.

    IMPORTANTE

    Debe asegurarse de que la cadena de dependencias esté correctamente configurada. La instancia de AppMeasurement agrega (depende de) el componente de API de visitante.

    // Instantiate and configure AppMeasurement 
    
    // Instantiate AppMeasurement instance only once! 
    if (_appMeasurementObject == null) {  
        _appMeasurementObject = new AppMeasurement(); 
    } 
    
    with (_appMeasurementObject) { 
        account = "ACCOUNT_NAME"; // Also known as RSID 
        trackingServer = "URL_OF_THE_ADOBE_ANALYTICS_TRACKING_SERVER"; 
    
        // Use the same value here as for the Visitor API component 
        visitorNamespace = "MARKETING_CLOUD_ORG_ID"; 
    
        // Attach the Visitor API to the AppMeasurement instance. 
        visitor = _visitor;  
        pageName = "pageName"; 
        charSet = "UTF-8"; 
        currencyCode = "USD"; 
    } 
    
    IMPORTANTE

    En la aplicación, asegúrese de que appMeasurementObject.visitor se rellena antes de iniciar el flujo de análisis de vídeo o de que no se obtengan resultados de seguimiento. Estos resultados se indican mediante los mensajes del registro. Puede agregar una llamada de seguimiento vacía ( appMeasurementObject.track), sondear la propiedad visitor hasta que se rellene e iniciar Video Analytics.

  3. Inicialice y configure metadatos de seguimiento de Video Heartbeat.

    IMPORTANTE

    Puede detener el flujo intermedio del módulo de análisis de vídeo y reiniciarlo de nuevo según sea necesario. Antes de reiniciar el módulo, asegúrese de que los metadatos de Video Analytics también se actualicen a los metadatos de contenido correctos. Para volver a crear los metadatos, repita los subpasos 1 y 2.

    1. Cree una instancia de los metadatos de Video Analytics.

      Esta instancia contiene toda la información de configuración necesaria para habilitar el seguimiento de Video Heartbeat. Por ejemplo:

      private function getVideoAnalyticsTrackingMetadata():VideoAnalyticsMetadata {     
          // Initialize visitor id service and appMeasurement      
          [...] // as shown in the previous steps     
      
          var vaMetadata:VideoAnalyticsMetadata = new VideoAnalyticsMetadata(); 
      
          with (vaMetadata) { 
              trackingServer = "hbTrackingServer"; 
              publisher = "hbPublisher"; 
              channel = "hbChannel";  
              playerName = "hbPlayerName"; 
      
              // this overwrites the ContextData variable a.media.friendlyName 
              videoName = "hbFriendlyName";  
      
              // this will overwrite the ContextData variable a.media.name 
              videoId = "hbName"; 
      
              enableChapterTracking = true; 
      
              // Set these to false for production deployment 
              debugLogging = true;  
              quietMode = false; 
      
          } 
      } 
      
    2. Agregue los metadatos de Video Analytics a la instancia de metadatos global.

      Cuando esté listo, establezca la instancia de metadatos global en el recurso de medios o en el elemento del reproductor de medios:

      var resourceMetadata:Metadata = _player.currentItem.resource.metadata; 
      resourceMetadata.setMetadata(DefaultMetadataKeys.VIDEO_ANALYTICS_METADATA_KEY,  
                                   getVideoAnalyticsTrackingMetadata());
      
    3. Inicialice el rastreador de Video Analytics.

      Después de crear una instancia de reproductor de medios, debe crear una instancia de rastreador de Video Analytics y proporcionar una referencia a la instancia del reproductor de medios.

      SUGERENCIA

      Cree siempre una nueva instancia de seguimiento para cada sesión de reproducción de contenido y elimine la referencia anterior después de separar la instancia del reproductor de medios.

      _videoAnalyticsProvider = new VideoAnalyticsProvider(_appMeasurementObject); 
      _videoAnalyticsProvider.attachMediaPlayer(_player);
      
    4. Destruya el rastreador de Video Analytics.

      Antes de comenzar una nueva sesión de reproducción de contenido, elimine la instancia anterior del rastreador de vídeo. Después de recibir el evento de finalización de contenido (o notificación), espere unos minutos antes de destruir la instancia del rastreador de vídeo. Destruir la instancia inmediatamente podría interferir con la capacidad del rastreador de Video Analytics para enviar un ping de finalización de vídeo.

      if (videoAnalyticsTracker) { 
          videoAnalyticsTracker.detachMediaPlayer(); 
          videoAnalyticsTracker = null; 
      }
      
    5. Marca de forma manual como completado el flujo en directo/lineal.

      Si tiene varios episodios en una emisión en directo, puede marcar manualmente un episodio como completo mediante la API completa. Esto finaliza la sesión de seguimiento de vídeo del episodio de vídeo actual y puede iniciar una nueva sesión de seguimiento para el episodio siguiente.

      SUGERENCIA

      Esta API es opcional y no es necesaria para el seguimiento de vídeo de VOD.

En esta página