For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cómo trabajar con la API de dominios dinámicos de AdBlock

Las herramientas de AdBlock son cada vez más sofisticadas, lo que plantea desafíos importantes para los publishers que buscan maximizar los ingresos de la publicidad en línea. Para ayudar a mitigar estos desafíos, esta API permite a los publishers ajustar dinámicamente sus scripts según los dominios activos, reduciendo significativamente el riesgo de que el contenido sea bloqueado por el software AdBlock.

Al garantizar la entrega de anuncios mediante dominios rotados regularmente, los publishers pueden:

  • Mantener las fuentes de ingresos: Evitar interrupciones causadas por anuncios bloqueados.

  • Mejorar la experiencia del usuario: Entregar contenido publicitario sin interrupciones y sin activar la detección de AdBlock.

  • Automatizar la gestión de dominios: Eliminar las actualizaciones manuales con un ciclo de vida automatizado del dominio de 7 días.

Se generan nuevos dominios cada 3 días y están disponibles a través de la API. Los dominios tendrán un ciclo de vida de 6 días.

  • 3 días activos

  • 3 días obsoletos

Una vez que expire el ciclo de vida, el dominio se desactivará. Por razones de rendimiento, se recomienda almacenar el dominio en caché durante 24 horas antes de solicitar un nuevo dominio a la API.

Esta API solo está disponible para Script inline de Popunders y Vídeo In-Stream zonas.

Requisitos

Para usar esta API, los publishers deben:

  • Hacer una solicitud GET al endpoint: https://ads.exoclick.com/adblock-domains.php

  • Recibirás un nuevo dominio de entrega de anuncios en la respuesta

  • A continuación, debes cambiar el endpoint de sindicación utilizado en la etiqueta de tu zona publicitaria por el nuevo proporcionado en la respuesta de la API.

Pasos para implementar

1

Obtener el dominio activo

Para recuperar dinámicamente el dominio activo, debes hacer una llamada a la API de servidor a servidor. Esto es crucial porque las llamadas a la API pueden ser bloqueadas si se realizan desde el lado del cliente.

Aquí tienes un ejemplo de llamada de servidor a servidor en PHP:

Y esta es la respuesta esperada de la API:

2

Actualiza tu script

Usa la dominio devuelto por el endpoint para actualizar el dominio usado en tu zona publicitaria. El dominio original depende del formato del anuncio:

  • Para Vídeo In-Stream zonas cambia el Etiqueta VAST:

    • Antes : https://s.magsrv.com/v1/vast.php?t={random}&idzone={zoneId}

    • Después : https://newsub.newdomain.com/v1/vast.php?t={random}&idzone={zoneId}

  • Para las zonas Popunders cambia el syndication_host en el script inline:

    • Antes : s.pemsrv.com

    • Después : newsub.newdomain.com

Detectar AdBlock

Para detectar si el usuario tiene habilitada una extensión de adblock, debes alojar ads.js del lado del publisher (tu propio dominio/CDN) e incluirlo al principio de tu etiqueta body etiqueta.

No hagas solicitudes a https://www.exoclick.com/ads.js directamente.

Crea tu propio ads.js archivo:

  1. Crea un archivo llamado ads.js en una ruta pública de tu sitio web (por ejemplo /js/ads.js).

  2. Añade el siguiente contenido a ese archivo.

  3. Carga ese archivo desde tu página antes de la lógica de integración de tus anuncios.

Contenido del archivo de referencia:

Luego añade la siguiente línea al principio de tu etiqueta body etiqueta:

Este script será bloqueado por Adblock en caso de que el cliente lo esté usando, debido a la presencia de las palabras clave "exoclick" y "ads". Después de cargar este script, un fragmento de JS intentará leer una variable específica. Si la variable no está definida o es inaccesible, podemos determinar que el script ha sido bloqueado.

Ejemplos de integración

En estos dos ejemplos estamos usando fetchAdblockDomain.php como nombre de la llamada de servidor a servidor para obtener el dominio de adblock.

In-Stream

Para usar dominios dinámicos con In-Stream, asegúrate de incluir el reproductor VAST dentro del script, de lo contrario el reproductor cargará la zona publicitaria in-stream predeterminada en lugar de usar el dominio actualizado. En este ejemplo, estamos usando el reproductor HTML5 Fluidplayer.

Popunder

Solución de problemas

No se devolvió ningún dominio

A veces, el endpoint puede devolver dominios vacíos.

Registra siempre la respuesta del endpoint durante la depuración para identificar posibles problemas. Si success es false, contacta con soporte.

Se devuelve el dominio predeterminado a pesar de tener Adblock habilitado

Estas son algunas razones comunes por las que tu script podría estar usando el dominio predeterminado a pesar de que Adblock esté habilitado:

  • ads.js no está alojado del lado del publisher. Esta integración requiere servir ads.js desde tu propio dominio (por ejemplo /js/ads.js). Solicitar directamente https://www.exoclick.com/ads.js no es compatible.

  • el dominio predeterminado se renderiza antes que el dominio de adblock. Asegúrate de que el script que inserta la zona publicitaria en tu sitio siempre espere a la llamada de servidor a servidor. Dependiendo de la cadena de ejecución, el dominio predeterminado podría añadirse al sitio antes de que se devuelva el dominio de adblock, lo que impedirá que tu sitio web inserte el dominio actualizado.

Para obtener más ayuda, contacta con el equipo de soporte aquí.

Última actualización

¿Te fue útil?