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

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 2.5 para Android.

  • Información de configuración/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.

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 dos primeros pasos a continuación (subpasos) a y b).

    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.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. Inicialice el proveedor de Video Analytics.

      Después de crear una instancia de reproductor de contenidos, debe crear una instancia de proveedor de Video Analytics y proporcionarle el contexto de aplicación.

      SUGERENCIA

      Cree siempre una nueva instancia de proveedor 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);
      
    3. Configure los metadatos de Video Analytics en la variable videoAnalyticsProvider ejemplo.

      videoAnalyticsProvider.setVideoAnalyticsMetadata(vaMetadata);
      
    4. Adjunte la instancia del reproductor de contenidos a videoAnalyticsProvider instancia:

      videoAnalyticsProvider.attachMediaPlayer(mediaPlayer);
      
    5. Destruya el proveedor de Video Analytics.

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

      if (videoAnalyticsProvider) {
          videoAnalyticsProvider.detachMediaPlayer();
          videoAnalyticsProvider = null;
      }
      
    6. 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 funciona para el seguimiento de vídeos de VOD.

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

En esta página