Integración de Vengo OnSign

Requisitos:

• Una cuenta OnSign activa
• Una cuenta Vengo activa
  • Credenciales de Vengo:
    • ID de organización de Vengo
    • El ID de la unidad de anuncios de Vengo suele ser único para cada pantalla
• Requisitos de OnSign Player :
  • player Windows , Android o Linux : con la aplicación OnSign versión 10.6.0 o superior
  • Samsung Tizen : con la aplicación OnSign 10.6.3 o superior y firmware 2430.3 o superior
  • LG webOS 4 o 6 : con la aplicación OnSign 10.6.3 o superior y firmware 03.68.33/1.6.8 o superior

Aunque no es un requisito estricto, recomendamos encarecidamente utilizar aplicaciones programáticas con el plan OnSign Pro o superior, ya que esto permitirá el uso de atributos personalizados Player como variables de entrada para las aplicaciones programáticas.

Paso 1: Configuración de atributos Player personalizados

Los atributos Player personalizados actúan como variables locales a las que las aplicaciones pueden acceder durante la reproducción.

Cada Player puede tener sus propios valores de atributos únicos, definidos y almacenados una vez que se crea el atributo.

Esto hace que los atributos personalizados sean especialmente útiles para almacenar credenciales programáticas. En lugar de configurar varias aplicaciones, solo se necesita una. Al ejecutarse, la aplicación recupera automáticamente las credenciales almacenadas en el Player y las utiliza para realizar la solicitud programática del anuncio.

Si bien los atributos personalizados se pueden crear en la configuración de la cuenta, la aplicación programática Vengo proporciona un acceso directo interno que permite crear los atributos personalizados necesarios directamente desde la aplicación.

1. Haga clic en el menú “Contenido”
2. Cree o navegue hasta la carpeta donde debe almacenarse la aplicación Vengo
3. Haga clic en el botón “ Nuevo ” > Aplicación > Luego escriba “Vengo” en el cuadro de búsqueda y seleccione la aplicación Vengo.
4. Introduzca un nombre válido para que la aplicación pueda guardarse más tarde.
5. Expandir los atributos de la aplicación (aquí es donde se deben ingresar las credenciales)
   1. En la mayoría de los casos, el “ ID de organización de Vengo ” será el mismo para todos players , por lo que se puede ingresar directamente en la aplicación, lo que significa que no es necesario crear un atributo personalizado para ello.
   2. El " ID de unidad publicitaria de Vengo " suele ser único para cada pantalla, así que conéctalo a un atributo Player personalizado si ya lo tienes o haz clic en el menú desplegable, ve hasta el final y haz clic en "Crear nuevo atributo Player ". Sigue los pasos para configurar un atributo Player específico.
6. Seleccione el entorno al que debe conectarse la aplicación: Producción o Staging.
7. Selecciona un medio de respaldo. Este medio es una imagen o un video que se mostrará cuando no haya anuncios.
8. Configurar la duración de la reserva. Esto es opcional y solo se aplica a la reserva de medios de imágenes.
9. Marque la opción “Omitir reproducción cuando no hay anuncios programados” en su comportamiento deseado es no omitir la reproducción de la aplicación cuando no hay ningún anuncio para mostrar.
10. ¡Ahora que todo está listo, simplemente guarda la aplicación!

Ahora que se crearon los atributos Player personalizados, el ID de la organización de Vengo y el ID de la unidad de anuncios de Vengo deben configurarse en todos players que los usarán.

Paso 3: Configuración del ID de la unidad de anuncios de Vengo para cada player

Si bien la aplicación está lista y configurada para publicarse, aún es necesario configurar el ID de la unidad de anuncio de Vengo para cada player a través del atributo Player personalizado configurado previamente.

Este proceso debe realizarse para cada player que reproducirá la aplicación Vengo.

1. Haga clic en el menú player
2. Seleccione el player a configurar
3. Haga clic en la configuración player .
4. Localice la unidad de anuncios de Vengo (atributo Player personalizado)
5. Ingresa la unidad de anuncios de Vengo
6. Guardar la configuración

Paso 4: Publicación de la aplicación Vengo

¡Ahora que todo está listo, el único paso que queda es publicar la aplicación!

Las aplicaciones programáticas se consideran de "Longitud de Contenido Variable", lo que significa que su duración puede variar según el anuncio recibido. Si bien esto ofrece flexibilidad, también requiere un cuidado especial al decidir cómo se colocan o publican estas aplicaciones.

Regla clave: Las aplicaciones de longitud de contenido variable se pueden omitir por completo o finalizar antes de la duración definida, pero nunca pueden exceder el tiempo asignado al elemento.

Ejemplo: Supongamos que una aplicación programática se coloca dentro de un elemento de una playlist con una duración de 10 segundos. En la práctica, esto significa:

• Si no hay ningún anuncio disponible y la aplicación está configurada para omitir, es posible que se omita el elemento.
• Si se recibe un anuncio de menos de 10 segundos de duración (por ejemplo, 7 segundos), el anuncio se reproducirá y finalizará a los 7 segundos, para luego pasar sin problemas al siguiente elemento de la playlist .
• Si se recibe un anuncio de más de 10 segundos, la aplicación lo reproducirá, pero lo acortará a los 10 segundos. Dado que el anuncio no se mostró completo, no se enviará la confirmación a la plataforma programática, lo que significa que probablemente no se pagará.

Paso 5: Prueba de sus credenciales

Vengo requiere dos credenciales para recuperar anuncios correctamente:

• ID de organización de Vengo : número único para identificar la red publicitaria
• ID de unidad publicitaria de Vengo : ID único para identificar el espacio publicitario específico (pantalla).

Para probar y asegurarse de que sus credenciales sean correctas, simplemente copie esta URL en su navegador, reemplazando los elementos respectivos con sus credenciales.

Prueba de credenciales en el entorno de Vengo Staging:

https://staging-pubads.vengolabs.com/trafficking/vast/ad_request?organization_id=[VengoOrganizationID]&ad_unit_id=[VengoAdUnit ID]

Prueba de credenciales en el entorno de producción de Vengo:

https://pubads.vengolabs.com/trafficking/vast/ad_request?organization_id=[VengoOrganizationID]&ad_unit_id=[VengoAdUnit ID]