Integración de Place Exchange OnSign
IMPORTANTE: Los anuncios programáticos son un servicio independiente que no está incluido en la licencia estándar OnSign . Si le interesa suscribirse, póngase en contacto con nuestro equipo.
Requisitos:
- Una cuenta activa OnSign TV
- Una cuenta activa de PlaceExchange
- Debe tener un ID de organización de PlaceExchange proporcionado por PlaceExchange
- Necesitará un nombre de unidad de anuncio de PlaceExchange para cada pantalla Player
- Requisitos Player :
- player Windows , Android o Linux : con la aplicación OnSign TV versión 10.3.0 o superior
- Samsung SSSP6 : con la aplicación OnSign TV 10.3.5 o superior y firmware 2430.3 o superior
- LG webOS 6 : con la aplicación OnSign TV 10.3.5 o superior y firmware 03.68.33/1.6.8 o superior
IMPORTANTE: La integración programática no funcionará si la aplicación OnSign TV está desactualizada o si el firmware del SoC no cumple con los requisitos.
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
- Complemento Player
- Aplicación PlaceExchange
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 Place Exchange, se deben configurar estos dos atributos personalizados:
- ID de organización de PlaceExchange : escriba texto
- Nombre de la unidad de anuncios de PlaceExchange: escriba texto
Los atributos personalizados distinguen entre mayúsculas y minúsculas y deben ingresarse con la ortografía exacta.
Ahora que se han creado los atributos Player personalizados, es necesario configurar la ID de organización y la ID de pantalla de PlaceExchange en la configuración de cada Player .
- Haga clic en el menú Player
- Seleccione un Player específico
- Haga clic en Configuración
- Ingrese el ID de la organización y el ID de pantalla de PlaceExchange
Paso 2: Configurar la aplicación PlaceExchange
La configuración de la aplicación Place Exchange 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 Place Exchange.
Haga clic en el botón Nuevo > Aplicación > Luego escriba "Intercambio de lugares" en el cuadro de búsqueda y seleccione la aplicación Intercambio de lugares.
1 - Configure el nombre de la aplicación (como cualquier otra aplicación de OnSign TV).
2 - Seleccione un medio de respaldo . Esto se mostrará cuando no haya ningún material creativo disponible en PlaceExchange o cuando no haya tiempo suficiente para recuperarlo de la plataforma.
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 un ID de organización de PlaceExchange o un nombre de unidad de anuncio no permitirá que la aplicación obtenga los elementos creativos del servidor de PlaceExchange.
- Si el archivo multimedia es demasiado grande y la descarga no se realizó a tiempo para su presentación, no se preocupe, ya que 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: Complemento programático para cada player
Además de una aplicación dedicada para cada plataforma SSP, el equipo OnSign ha desarrollado un plugin de anuncios programáticos. Este plugin proporciona un canal de retorno a cada SSP programático, confirmando la reproducción de cada anuncio.
Gestionar la confirmación programática de anuncios mediante el plugin ofrece una ventaja significativa: garantiza que el evento no dependa del tiempo de visualización del anuncio. Esta arquitectura mejora la fiabilidad y soporta problemas temporales de red, lo que permite al plugin confirmar la reproducción del anuncio hasta 10 minutos después de su aparición.
El complemento programático es genérico y compatible con todas las plataformas programáticas integradas en OnSign TV. Solo se necesita agregar una instancia por player .
Por lo tanto, para cualquier player que presente anuncios programáticos, se debe configurar e instalar un complemento programático.
Paso 4: Crear una campaña wrapper
La app PlaceExchange tiene un comportamiento de longitud variable. Esto permite la reproducción de creatividades de diferentes duraciones provenientes de PlaceExchange. Para aprovechar esta función, la app PlaceExchange debe colocarse en un contenedor con una longitud al menos igual a la del contenido creativo más grande que se vaya 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 5: Informe de reproducción programática de aplicaciones
OnSign TV puede proporcionar dos informes diferentes para la aplicación PlaceExchange:
- Informe de reproducción de contenido : contará las veces que se presentó la aplicación PlaceExchange.
- Eventos de la aplicación: Esto proporcionará información detallada de cada elemento multimedia reproducido por la aplicación PlaceExchange. Es una excelente manera de comparar la cantidad de anuncios mostrados con los informes de la plataforma PlaceExchange.
Investigando errores
Si la aplicación PlaceExchange 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.