Envío de Brightcove Analytics desde el SDK nativo para iOS

En este tema, aprenderá a configurar propiedades en Brightcove Analytics desde su aplicación móvil utilizando Brightcove SDK para iOS.

Integración analítica

Si usa el reproductor Brightcove y catalog incluido en el SDK para recuperar y reproducir videos, los datos analíticos se recopilarán automáticamente y aparecerán en el módulo Video Cloud Analytics.

Si anula el BCOVVideo clase o no utilice el reproductor Brightcove y catalog , debe enviar su ID de cuenta a Video Cloud Analytics.

Personalizar propiedades

A partir de la versión 4.1.8 de Brightcove Mobile SDK para iOS, puede enviar valores personalizados a Brightcove Analytics desde su aplicación para ID de cuenta, URI de destino y URI de origen.

Se requiere su ID de cuenta, pero se establece automáticamente cuando usa el reproductor Brightcove y el catalog.

Puede establecer los URI de origen y destino si lo desea. Los valores predeterminados se basan en el nombre del paquete de la aplicación.

Estas propiedades se pueden configurar en su ViewController archivo de implementación. Por lo general, esto se hace después de la llamada para crear el PlaybackController:

id<BCOVPlaybackController> controller =
    [[BCOVPlayerSDKManager sharedManager] createPlaybackController];

controller.analytics.account = your accountId;
controller.analytics.destination = valid URI;
controller.analytics.source = valid URI;

Cuenta

Utilizar el account propiedad para establecer el valor de ID de cuenta en Brightcove Analytics. Esta propiedad será útil solo en los casos en que no haya accountId valor en los metadatos del video (por ejemplo, si su aplicación usa una combinación de videos de Video Cloud, que contienen el accountId propiedad y videos que no sean de Video Cloud, que no contendrán la accountId propiedad).

controller.analytics.account = @"your accountId";

Cuando establezca la propiedad de la cuenta, el valor de esta propiedad se utilizará para cualquiera de sus videos que aún no tengan una accountId propiedad. El valor más útil para esta propiedad es su propio ID de cuenta. Estos videos se informarán en el módulo de análisis como Otro / Tercero ya que Brightcove Analytics no admite actualmente informes detallados para videos que no se recuperan a través del servicio de catálogo de Brightcove.

Para los videos de Video Cloud, configurar esta anulación de cuenta no tiene ningún efecto en los informes, ya que el video accountId El valor de los metadatos permanece sin cambios. Ese valor no se puede anular estableciendo este valor de cuenta.

Destino

Utilizar el destination propiedad para establecer el valor de la ubicación que origina el evento. El valor de la propiedad de destino DEBE estar en el formato de URI adecuado, similar a este ejemplo:

bcsdk://com.mhogben.source

El valor predeterminado de la propiedad de destino es bcsdk:// seguido del identificador del paquete de la aplicación como se indica en el info.plist expediente.

Por ejemplo, en una aplicación de muestra de iOS, el valor de destino predeterminado sería bcsdk://com.brightcove.sampleAppMainScreen.Destination y podría anularse así:

controller.analytics.destination =
    @"myapp://com.mycompany.homescreen.destination";

Cualquier pantalla en su aplicación que instancia una BCOVPlaybackController puede establecer esta anulación de destino en un valor distinto, para realizar un mejor seguimiento de las vistas de video dentro de la propia aplicación.

Fuente

Utilizar el source propiedad para establecer el URI que envió al usuario final al URI de destino. Al igual que con el valor de destino, el valor de la propiedad de origen DEBE estar en el formato de URI adecuado, similar a este ejemplo:

bcsdk://com.mhogben.source

El valor predeterminado de la propiedad de origen es nulo. Cuando el valor es nulo, la propiedad de origen no se envía al servidor de Analytics.

A continuación, se muestra un ejemplo de cómo establecer la propiedad de origen:

controller.analytics.source =
    @"myapp://com.mycompany.homescreen.destination.source";

Ver análisis

En el módulo de Video Cloud Analytics, puede ver datos de métricas a nivel de cuenta o en un nivel detallado, como por video. Para aprender cómo, vea los siguientes documentos: