Guía de instalación

Todo lo necesario para conectar un sitio web a AdRecover.

1. Añade el fragmento

Después de añadir tu sitio en el panel, copia tu fragmento personal. Tiene este aspecto:

<script async src="https://adrecover.onrender.com/embed.js" data-publisher="pub_XXXXXXXXXXXXXXXX"></script>

Usa el fragmento de tu panel: contiene tu propio ID de editor. El mismo fragmento funciona en todos los sitios de tu cuenta.

2. Dónde colocarlo

Pega el fragmento justo antes de la etiqueta de cierre </body> de cada página, o una sola vez en la plantilla, diseño o pie de página compartido que usan todas las páginas.

El script es asíncrono y no bloquea el renderizado. También funciona si lo colocas en <head>.

WordPress y otros CMS

  • WordPress: usa un plugin de código para cabecera/pie o añade el fragmento al footer.php de tu tema antes de </body>.
  • Shopify: Tienda online → Temas → Editar código → theme.liquid, antes de </body>.
  • Wix, Squarespace y similares: usa el ajuste de código personalizado o inyección de código para el pie de página.
  • Google Tag Manager: crea una etiqueta HTML personalizada con el fragmento que se active en todas las páginas.

3. Comprueba la conexión

Abre cualquier página de tu sitio en una ventana normal del navegador. Luego pulsa Comprobar conexión en el diálogo de instalación. El estado del sitio cambia a Conectado cuando la primera página vista llega a AdRecover.

Publicar un aviso y conectar el script son cosas distintas: un aviso publicado solo se muestra cuando el script está instalado.

Modos de recuperación

  • Muro AdBlock: un diálogo que no se puede cerrar mientras el bloqueo esté confirmado. Los visitantes pueden abrir las instrucciones y comprobar de nuevo.
  • Recordatorio amable: un mensaje que se puede cerrar, con control de frecuencia.
  • Solo medición: mide sin mostrar ningún mensaje. No se muestra nada hasta que publiques un aviso.

Reglas de segmentación

Los avisos nuevos omiten la página de inicio por defecto. Para probar un muro recién publicado, visita una página interna (por ejemplo, un artículo) con el bloqueador activado.

Puedes excluir rutas como /login o /checkout. Una regla incluye la ruta y todo lo que cuelga de ella. Termina una regla con * para incluir cualquier ruta que empiece así.

Aplicaciones de una sola página

El script detecta la navegación del lado del cliente mediante la History API y trata cada ruta nueva como una nueva página vista. No tienes que llamar a nada.

Política de seguridad de contenido

Si tu sitio usa una Content Security Policy, permite el servidor de AdRecover para scripts y conexiones. La detección también hace una solicitud de prueba a un servidor de anuncios habitual; si tu CSP la bloquea, la detección puede dar resultados no concluyentes con más frecuencia.

Probar con un bloqueador

  • Instala el script y publica el Muro AdBlock.
  • Activa un bloqueador (por ejemplo uBlock Origin o AdBlock) y abre una página interna.
  • Aparece el muro. Pulsa Comprobar de nuevo sin cambiar nada: el muro permanece.
  • Pausa el bloqueador para el sitio y pulsa Comprobar de nuevo: el muro se cierra.
  • Vuelve a activar el bloqueador y carga otra página: el muro aparece de nuevo.

Resolución de problemas

  • El estado sigue en Esperando la instalación: comprueba que el fragmento está en el sitio en producción y que el dominio registrado coincide con la dirección del navegador (con y sin www se consideran el mismo sitio; otros subdominios necesitan su propia entrada).
  • No aparece ningún aviso: comprueba que el aviso está publicado, que la página no está excluida y que no estás en la página de inicio con Omitir página de inicio activado.
  • El panel avisa de un dominio no registrado: tu fragmento se cargó en un dominio que no está en tu cuenta. Añádelo si es tuyo.

Privacidad y almacenamiento

El script no instala cookies. Usa el almacenamiento de sesión para contar las páginas de una visita y, en el Recordatorio amable con Mostrar una vez, el almacenamiento local para recordar que ya se mostró. AdRecover no guarda direcciones IP de los visitantes; los eventos de detección se conservan por un tiempo limitado y después solo quedan los totales diarios.

Content-Security-Policy: script-src 'self' https://adrecover.onrender.com https://pagead2.googlesyndication.com; connect-src 'self' https://adrecover.onrender.com https://pagead2.googlesyndication.com