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 iOS
  • 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:
ADBMobileConfig.json

Importante: Este nombre de archivo de configuración JSON debe permanecer ADBMobileConfig.json . El nombre y la ruta de este archivo de configuración no se pueden cambiar. La ruta a este archivo debe ser <source root>/AdobeMobile .

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.
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. Confirme que las opciones de tiempo de carga del archivo de recursos ADBMobileConfig.json son correctas.

    { 
        "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 lee estos valores solo en el momento de la carga y los valores permanecen constantes mientras se ejecuta la aplicación.

    Para configurar las opciones de tiempo de carga:

    1. Confirme que el archivo ADBMobileConfig.json contiene los valores adecuados que proporciona Adobe.

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

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

    3. Compile y cree la 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 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:

      - (PTVideoAnalyticsTrackingMetadata *)getVideoAnalyticsTrackingMetadata 
      { 
          PTVideoAnalyticsTrackingMetadata *vaTrackingMetadata =  
            [[[PTVideoAnalyticsTrackingMetadata alloc]  
                 initWithTrackingServer:@"example.com" 
                 publisher:@"sample-publisher"] autorelease]; 
      
          // Set these to NO for production deployment. 
          vaTrackingMetadata.debugLogging = YES;  
          vaTrackingMetadata.quietMode = NO; 
      
          vaTrackingMetadata.channel = @"test-channel"; 
          vaTrackingMetadata.videoName = @"myvideo"; 
          vaTrackingMetadata.videoId = @"myvideoid"; 
          vaTrackingMetadata.playerName = @"PSDK Player"; 
          vaTrackingMetadata.enableChapterTracking = YES; 
          vaTrackingMetadata.useSSL = NO; 
          // use this API to override the default asset length -1 for live streams 
          vaTrackingMetadata.assetDuration = SAMPLE_ASSET_DURATION; 
      
      }
      
    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:

      - (PTMetadata *)createMetadata 
      { 
          PTMetadata *metadata = [[[PTMetadata alloc] init] autorelease]; 
      
          [metadata setMetadata:[self getVideoAnalyticsTrackingMetadata]  
            forKey:PTVideoAnalyticsTrackingMetadataKey]; 
      
          return metadata; 
      } 
      
      PTMetadata *metadata = [self createMetadata]; 
      
      PTMediaPlayerItem *item =  
        [[[PTMediaPlayerItem alloc] initWithUrl:[[[NSURL alloc]  
          initWithString:@"media-url"] autorelease] 
          mediaId:@"media-id" metadata:metadata] autorelease];
      
    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.

      self.videoAnalyticsTracker =  
        [[[PTVideoAnalyticsTracker alloc] initWithMediaPlayer:self.player] autorelease];
      
    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.

      self.videoAnalyticsTracker = nil;
      
    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.

      if (self.videoAnalyticsTracker) 
      { 
         [self.videoAnalyticsTracker trackVideoComplete];   
      }
      

En esta página