Integración de Hivestack OnSign TV

Las plataformas programáticas son una tendencia fuerte y una excelente manera de aumentar las ventas de publicidad DOOH.

Hivestack es una plataforma de publicidad programática mundial y completa que ofrece fácil acceso a los DSP más grandes del mercado, como Yahoo OmniChannel y Google DV360.

Este tutorial describe cómo integrar OnSign TV Screens con Hivestack.

Requisitos:

• Una cuenta activa OnSign TV
• Una cuenta Hivestack activa
• Debe tener una clave API de Hivestack proporcionada por Hivestack para realizar solicitudes de anuncios
• Necesitará un ID de pantalla de Hivestack para cada pantalla Player
  
• Requisitos Player :

La cuenta de OnSign TV debe estar habilitada para las siguientes funciones que no están habilitadas de forma predeterminada:

• Atributos personalizados
• Eventos de la aplicación
• Aplicación Hivestack

Paso 1: Configuración de atributos Player personalizados

Los atributos Player personalizados funcionan como variables Player locales a las que las aplicaciones pueden acceder durante el tiempo de reproducción.

Una vez que se crea un atributo Player personalizado desde el menú de configuración, será posible ingresar un atributo personalizado para cada Player .

Los atributos Player personalizados se configuran en cada Player en Configuración > Atributos personalizados

Para utilizar la aplicación Hivestack, se deben configurar estos dos atributos personalizados:

• Clave API de Hivestack: tipo texto
• ID de pantalla de Hivestack: escriba texto

Ahora que se crearon los atributos Player personalizados, la clave API de Hivestack y la ID de pantalla deben configurarse en la configuración de cada Player .

1. Haga clic en el menú Player
2. Seleccione un Player específico
3. Haga clic en Configuración
4. Ingrese la clave API de Hivestack y el ID de pantalla de Hivestack

Paso 2: Configurar la aplicación Hivestack

La configuración de la aplicación Hivestack sigue el mismo proceso que cualquier otra aplicación de contenido de OnSign TV.

Haga clic en el menú Contenido y navegue hasta la carpeta donde debe almacenarse la aplicación Hivestack.

Haga clic en el botón Nuevo > Aplicación > Luego escriba "Hivestack" en el cuadro de búsqueda y seleccione la aplicación Hivestack.

1 - Configure el nombre de la aplicación (como cualquier otra aplicación de OnSign TV).

2 - Seleccione el entorno de Hivestack al que debe conectarse la aplicación. Este puede ser el entorno de prueba, si aún está validando la solución, o el de producción, si su entorno está configurado y listo para mostrar anuncios a su audiencia.

3 - Seleccione una imagen de respaldo . Esta se mostrará cuando no haya ninguna imagen creativa disponible en Hivestack o cuando no haya tiempo suficiente para recuperarla de la plataforma Hivestack.

El modo de depuración se puede activar para proporcionar información adicional. Es una forma práctica de garantizar que todo funcione correctamente o de depurar errores en caso de que la aplicación no muestre correctamente los elementos creativos.

Los errores comunes son:

• El uso de una clave API incorrecta o una ID de pantalla no válida no permitirá que la aplicación obtenga los elementos creativos del servidor Hivestack.
• El archivo multimedia es demasiado grande y la descarga no se completó a tiempo para su presentación. No se preocupe, el archivo se descargará en segundo plano y debería presentarse correctamente en el siguiente ciclo.

Aquí hay una aplicación publicada con el modo de depuración habilitado.

Tenga en cuenta que como el medio recuperado tiene una duración de 20 segundos, la reproducción de este medio durará exactamente 20 segundos, incluso si la duración publicada del contenedor es mayor.

Paso 3: Crear una campaña wrapper

La app Hivestack tiene un comportamiento de longitud variable. Esto permite reproducir creatividades de diferentes duraciones provenientes de Hivestack. Para aprovechar esta función, la app Hivestack debe colocarse en un contenedor con una longitud al menos igual a la creatividad más grande que se va a presentar.

Por ejemplo, si el anuncio tiene una duración máxima de 15 segundos, la aplicación debe colocarse en una campaña que dure al menos 15 segundos o dentro de una Playlist y, luego, el elemento Playlist debe configurarse como de 15 segundos.

Aun así, debido a su comportamiento variable, si el mensaje creativo recibido solo dura 10 segundos, el elemento solo se reproducirá durante 10 segundos y se saltará al siguiente elemento.

Paso 4: Informe de reproducción de la aplicación Hivestack

OnSign TV puede proporcionar dos informes diferentes para la aplicación Hivestack:

• Informe de reproducción de contenido : contará las veces que se presentó la aplicación Hivestack.
• Eventos de la aplicación : Esto proporcionará información detallada de cada contenido multimedia reproducido por la aplicación Hivestack. Es una excelente manera de comparar la cantidad de anuncios mostrados con los informes de la plataforma Hivestack.

Requisitos del firewall

Además de la configuración del firewall OnSign , asegúrese de que se pueda acceder a los siguientes dominios desde cada player que necesite presentar anuncios programáticos de Hivestack:

• apps.hivestack.com (Para enviar solicitudes de anuncios y reproducir llamadas de confirmación)
• dgg3rnz8nudgw.cloudfront.net (Para descargar los archivos creativos)
• cdn-apps.hivestack.com (Para descargar los archivos creativos)

Investigando errores

Si la aplicación Hivestack no se comporta como se espera, los problemas más probables son:

• Sin red : si no hay red, la aplicación no puede verificar si hay un anuncio designado para presentar.
• Credenciales incorrectas o faltantes : si, por algún motivo, falta el OrgID o el Screen ID, la aplicación no podrá consultar anuncios disponibles.

Prueba de sus credenciales de Hivestack

Probar sus credenciales de Hivestack es bastante simple, simplemente abra una de las dos URL a continuación, reemplazando [ScreenID] y [Org_ID] con sus credenciales.

Puesta en escena : si sus credenciales funcionan solo en entornos de prueba y ensayo

https://uat.hivestack.com/nirvana/api/v1/units/schedulevast/[SCREEN_ID]?apikey=[API_KEY]

Producción : si sus credenciales ya están disponibles en el entorno de producción

https://apps.hivestack.com/nirvana/api/v1/units/schedulevast/[SCREEN_ID]?apikey=[API_KEY]