Anuncios

Hay parámetros opcionales que se pueden usar para personalizar la publicidad de Fluid Player.

No se requieren parámetros y se usarán los valores predeterminados si no se pasan.

Las opciones VAST se relacionan con los anuncios servidos y con cómo el reproductor los maneja.

Estas opciones son específicamente para cuando se muestran anuncios en el reproductor.

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            adList:                     {},
            skipButtonCaption:          'Omitir anuncio en [seconds]',
            skipButtonClickCaption:     'Omitir anuncio <span class="skip_button_icon"></span>',
            adText:                     null,
            adTextPosition:             'top left',
            adCTAText:                  '¡Visítalo ahora!',
            adCTATextPosition:          'bottom right',
            vastTimeout:                5000,
            showPlayButton:             false,
            maxAllowedVastTagRedirects: 1,

            vastAdvanced: {
                vastLoadedCallback:       (function() {}),
                noVastVideoCallback:      (function() {}),
                vastVideoSkippedCallback: (function() {}),
                vastVideoEndedCallback:   (function() {})
            }
        }
    }
);

adList

Configura una o varias etiquetas VAST. Para cada una de las etiquetas hay múltiples opciones.

Ten en cuenta que la respuesta XML de la etiqueta VAST Content-Type debe ser ya sea application/xml o text/xml.

• roll (obligatorio): Las posiciones disponibles en la línea de tiempo: preRoll, midRoll, postRoll, onPauseRoll.

• vastTag (obligatorio): La URL del XML VAST (consulta las etiquetas/atributos compatibles vastLinear.xml)

• timer (solo para mid-roll): La propiedad timer programa cuándo debe mostrarse el anuncio. Hay dos formas de definir esto:

  • [seconds]: La cantidad de segundos hasta que comience el anuncio. Ejemplo: timer: 10

  • [percentage]: El porcentaje del video que se debe mostrar antes de que comience el anuncio. Ejemplo: timer: 50%

• fallbackVastTags (Opcional): Un array que contiene las URL de Vast; si la URL en vastTag falla, el reproductor intentará con estas.

• adText (Opcional para anuncios lineales): La sección adText describe la capacidad de establecer texto para que aparezca en los anuncios. Al usar este parámetro en el adList puedes especificar texto único por anuncio.

• adTextPosition (Opcional para anuncios lineales): Solo es relevante si adText está en uso. Esto te permite establecer la posición de adText por anuncio.

• adClickable (Opcional para anuncios lineales): Desactiva abrir la página de destino en una nueva pestaña cuando se hace clic en el reproductor y mantiene la funcionalidad de reproducir/pausar.

Podemos configurar múltiples midRoll con el mismo valor de timer, además múltiples preRoll, postRoll y onPauseRoll se pueden configurar. Consulta el ejemplo a continuación:

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            adList: [
                {
                    roll: 'preRoll',
                    vastTag: 'vastPreRoll_1.xml',
                    adText: 'La publicidad nos apoya directamente'
                },
                {
                    roll: 'preRoll', // múltiples anuncios preRoll
                    vastTag: 'vastPreRoll_2.xml',
                    adText: 'La publicidad nos apoya directamente'
                },
                {
                    roll: 'midRoll',
                    vastTag: 'vastMidRoll_1.xml',
                    timer: 8
                },
                {
                    roll: 'midRoll',
                    vastTag: 'vastMidRoll_2.xml',
                    // En caso de que vastTag falle, el reproductor recurrirá a una de las etiquetas válidas de este array
                    fallbackVastTags: ['vastMidRoll_3.xml', 'vastMidRoll_4.xml'],
                    // varios anuncios para el mismo momento
                    timer: 8
                },
                {
                    roll: 'midRoll',
                    vastTag: 'vastMidRoll_2.xml',
                    timer: 10,
                    adClickable: false // Predeterminado true
                },
                {
                    roll: 'postRoll',
                    vastTag: 'vastPostRoll.xml',
                    adText: 'Gracias por mirar',
                    adTextPosition: 'top right'
                }
            ]
        }
    }
);

• vAlign (solo para nonLinear, opcional): Las posiciones verticales disponibles para los anuncios no lineales: top, middle, bottom. Predeterminado: bottom.

• nonLinearDuration (solo para nonLinear, opcional): La cantidad de segundos hasta que se mostrará el anuncio no lineal. Si no se establece ni el atributo minSuggestedDuration del XML VAST, no se cerrará hasta el final del video.

• size (solo para nonLinear, opcional): La dimensión del anuncio. Tamaños compatibles: 468x60, 300x250, 728x90

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            adList: [
                {
                    roll: 'onPauseRoll',
                    vastTag: 'vastNonLinear.xml',
                    vAlign: 'top',
                    nonlinearDuration: 10,
                    size: '300x250'
                }
            ]
        }
    }
);

skipButtonCaption

El texto que se mostrará durante la cuenta regresiva de un anuncio. El [seconds] marcador se usa para la cuenta regresiva en segundos. (Predeterminado: "Omitir anuncio en [seconds]")

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            skipButtonCaption: 'Espera [seconds] segundos más'
        }
    }
);

skipButtonClickCaption

Esto define el texto que se mostrará cuando la cuenta regresiva termine y el usuario pueda saltar al video principal. (Predeterminado: 'Omitir anuncio ')

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            skipButtonClickCaption: 'Ver video principal <span class="skip_button_icon"></span>'
        }
    }
);

adText

Se puede mostrar texto personalizado cuando se reproduce un anuncio in-stream. Este texto aparece en la esquina superior izquierda del reproductor y se establecerá con el color principal.

Tiene adicional adTextPosition parámetro, que puede tener valores como 'top right', 'top left', 'bottom right', 'bottom left'.

El texto y la posición del anuncio también se pueden establecer de forma por anuncio.

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            adText: 'La publicidad nos ayuda a mantener las luces encendidas', // Predeterminado null,
            adTextPosition: 'top left' // Predeterminado 'top left'
        }
    }
);

adCTAText

La página de destino del anuncio se mostrará en el adCTAText área. Puedes añadir texto personalizado encima de esta URL, o puedes elegir desactivarlo.

La captura de pantalla siguiente muestra cómo aparecerá de forma predeterminada, y el código siguiente muestra cómo modificarlo o desactivarlo.

Tiene adicional adCTATextPosition parámetro, que puede tener valores como 'top right', 'top left', 'bottom right', 'bottom left'.

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            // adCTAText: '¡Suscríbete ahora!', // Predeterminado "¡Visítalo ahora!",
            // adCTATextPosition: 'bottom left', // Predeterminado 'bottom right'
            adCTAText: false // Desactivar adCTAText
        }
    }
);

El texto CTA también puede tomarse del XML VAST que se establece mediante adCTATextVast parámetro. Así que, si este parámetro se establece en true, utilizará el texto proporcionado en el XML VAST. Si el texto del XML VAST está vacío o este parámetro no está configurado, recurrirá al valor predeterminado establecido en adCTAText.

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            adCTAText: '¡Suscríbete ahora!', // Predeterminado "¡Visítalo ahora!",
            adCTATextPosition: 'bottom left', // Predeterminado 'bottom right’,
            adCTATextVast: true, // Activado. Para usar el texto CTA tal como se proporciona en el XML VAST.
        }
    }
);

vastTimeout

Este parámetro te permite establecer el tiempo, en milisegundos, que se esperará a que cargue VAST. (Predeterminado: 5000)

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            vastTimeout: 1000 // Predeterminado 5000
        }
    }
);

vastAdvanced

Podemos especificar las funciones de callback en los diferentes eventos VAST.

• vastLoadedCallback: Cuando VAST se ha cargado.

• noVastVideoCallback: Cuando no hay video VAST.

• vastVideoSkippedCallback: Si se omite el anuncio.

• vastVideoEndedCallback: Cuando el anuncio ha terminado.

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            vastAdvanced: {
                vastLoadedCallback:       (function() { console.log("Aquí un evento") }),
                noVastVideoCallback:      (function() { console.log("Aquí otro") }),
                vastVideoSkippedCallback: (function() { console.log("Aquí uno más") }),
                vastVideoEndedCallback:   (function() { console.log("Aquí está el último") })
            }
        }
    }
);

showPlayButton

Opción para mostrar el icono del botón de reproducción después de que el video del anuncio se haya detenido. De forma predeterminada, este parámetro se establecerá en false, pero se puede habilitar como se muestra a continuación.

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            showPlayButton: true // Predeterminado false
        }
    }
);

maxAllowedVastTagRedirects

Fluid Player admite wrappers VAST a través de .La maxAllowedVastTagRedirects establece el máximo de redirecciones permitidas (wrappers).

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            maxAllowedVastTagRedirects: 1 // Predeterminado 3
        }
    }
);

adClickable

Hacer clic en el reproductor mientras se muestra un anuncio in-stream abrirá la página de destino en una nueva pestaña.

Si deseas desactivar esto y permitir abrir la página de destino solo mediante el llamado a la acción, puedes usar el adClickable parámetro.

Esto se puede establecer para todos los anuncios in-stream o por cada anuncio listado. Para obtener detalles sobre cómo añadirlo por anuncio, consulta la sección adlist .

fluidPlayer(
   'my-video',
    {
        vastOptions: {
            adClickable: false // Predeterminado true
        }
    }
);

VPAID

A diferencia de los anuncios VAST normales, VPAID es muy dinámico e interactivo.

Para más información https://www.iab.com/guidelines/digital-video-player-ad-interface-definition-vpaid-2-0/

Para habilitar la carga de anuncios VPAID allowVPAID la opción debe establecerse en true (false por defecto).

El reproductor admite VPAID versión 2.0

fluidPlayer(
    'video-vpaid-ads',
    {
        vastOptions: {
            allowVPAID: true, // Predeterminado false.
            adList: [
                {
                    roll: 'preRoll',
                    vastTag: './vastxmls/vpaid_linear.xml'
                },
                {
                    roll: 'midRoll',
                    vastTag: './vastxmls/vpaid_nonlinear.xml',
                    timer: 5
                },
            ]
        }
    }
);

Seguimiento VAST

Los siguientes eventos son compatibles con Fluid Player.

• start

• firstQuartile

• midpoint

• thirdQuartile

• complete

• progress

• impression

• clickTracking

• iconClickTrough