Inicialización y configuración de análisis de vídeo

Última actualización: 2023-09-19

Puede configurar el reproductor para que rastree y analice el uso del vídeo.

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

  • TVSDK para Android
  • Información de configuración e inicialización: póngase en contacto con su representante de Adobe para obtener la información específica de su cuenta de seguimiento de vídeo:
ADBMobileConfig.json

Importante: Este nombre de archivo de configuración JSON debe permanecer ADBMobileConfig.json . No se pueden cambiar el nombre y la ruta de acceso de este archivo de configuración. La ruta a este archivo debe ser <source root="">/assets .

Extremo del servidor de seguimiento de AppMeasurement La dirección URL del extremo de colección del back-end de Adobe Analytics (anteriormente SiteCatalyst).
Extremo del servidor de seguimiento de análisis de vídeo La URL del punto de conexión de la colección del back-end de Video Analytics. Aquí es donde se envían todas las llamadas de seguimiento de Video Heartbeat.

Sugerencia: La URL del servidor de seguimiento de visitantes es la misma que la 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 cuenta También se conoce como ID del grupo de informes (RSID).
ID de organización de Marketing Cloud Un valor de cadena necesario para crear una instancia del componente Visitante.
Editor Este es el ID del editor que el representante del Adobe proporciona a los clientes.

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

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

  1. Confirme que las opciones de tiempo de carga en la variable ADBMobileConfig.json el archivo de recursos es correcto.

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

    Este archivo de configuración con formato JSON está empaquetado como un recurso con TVSDK. El reproductor solo lee estos valores durante la carga y los valores permanecen constantes mientras se ejecuta la aplicación.

    Para configurar las opciones de tiempo de carga:

    1. Confirme que la variable ADBMobileConfig.json contiene los valores apropiados proporcionados por el Adobe.

    2. Confirme que este archivo se encuentra en la assets carpeta.

      Esta carpeta debe estar ubicada en la raíz del árbol de origen de la aplicación.

    3. Compile y cree su aplicación.

    4. Implemente y ejecute la aplicación agrupada.

      Para obtener más información sobre esta configuración de AppMeasurement, consulte Medición de vídeo en Adobe Analytics.

  2. Inicialice y configure los metadatos de seguimiento de Video Heartbeat.

    IMPORTANTE

    Puede detener el módulo de análisis de vídeo en el flujo medio y reiniciarlo de nuevo según sea necesario. Antes de reiniciar el módulo, asegúrese de que los metadatos de análisis de vídeo 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 VideoAnalyticsMetadata getVideoAnalyticsTrackingMetadata() {
          VideoAnalyticsMetadata vaMetadata = new VideoAnalyticsMetadata();
      
          vaMetadata.setTrackingServer("example.com");
          vaMetadata.setPublisher("sample-publisher");
          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.quietMode = false; // 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. Añada 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:

      ((MetadataNode)resourceMetadata).setNode(
            DefaultMetadataKeys.VIDEO_ANALYTICS_METADATA_KEY.getValue(), vaMetadata);
      
    3. Inicialice el rastreador de Video Analytics.

      Después de crear una instancia de reproductor de contenidos, debe crear una instancia de seguimiento de Video Analytics y proporcionar una referencia a la instancia de reproductor de contenidos.

      SUGERENCIA

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

      VideoAnalyticsProvider videoAnalyticsProvider =
        new VideoAnalyticsProvider(appContext);
      
      // Attach the TVSDK media player instance
      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);
      
    4. Destruya el rastreador de Video Analytics.

      Antes de comenzar una nueva sesión de reproducción de contenido, destruya 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 de seguimiento de vídeo. La destrucción inmediata de la instancia podría interferir con la capacidad del rastreador de Video Analytics para enviar un ping de vídeo completo.

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

      Si tiene varios episodios en un flujo en directo, puede marcar manualmente un episodio como completado 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.

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

En esta página