# 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. ```javascript fluidPlayer( 'my-video', { vastOptions: { adList: {}, skipButtonCaption: 'Omitir anuncio en [seconds]', skipButtonClickCaption: 'Omitir anuncio ', 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](#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: ```javascript 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 ```javascript 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]") ```javascript 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 ') ```javascript fluidPlayer( 'my-video', { vastOptions: { skipButtonClickCaption: 'Ver video principal ' } } ); ``` ### 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](#adlist). ```javascript fluidPlayer( 'my-video', { vastOptions: { adText: 'La publicidad nos ayuda a mantener las luces encendidas', // Predeterminado null, adTextPosition: 'top left' // Predeterminado 'top left' } } ); ``` ![](/files/29a4e6e6e18c5cc4d8a601d9baf60b9eeeae7b5f) ### 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'. ```javascript 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`. ```javascript 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. } } ); ``` ![](/files/079d0ca5b2ff50626a087a8d55deb2f30e780d2d) ### vastTimeout Este parámetro te permite establecer el tiempo, en milisegundos, que se esperará a que cargue VAST. (**Predeterminado:** 5000) ```javascript 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. ```javascript 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. ```javascript 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). ```javascript 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](#adctatext), 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](#adlist) . ```javascript 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 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 ```javascript 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 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.fluidplayer.com/es/configuracion/advertisements.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.