Guía de instalación

Todo lo necesario para conectar un sitio web a AdCobalt.

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://adcobalt.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 AdCobalt.

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 se muestran por defecto en todas las páginas, incluida la de inicio. Para probar un muro recién publicado, abre tu sitio 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í.

Mostrar desde la página N y Esperar cuentan durante toda la visita: todas las páginas y pestañas de tu sitio, desde que llega el visitante. Una visita termina tras 30 minutos sin ver páginas, así que para volver a probarlos usa una ventana privada.

Membresías sin anuncios

Los visitantes que mantienen su bloqueador pueden pagarte una membresía sin anuncios en lugar de permitir los anuncios. Es opcional y está desactivada por defecto.

  • Conecta Stripe en la página Miembros. Los miembros pagan en tu propia cuenta de Stripe; tú eres el vendedor, así que Stripe envía los recibos a tu nombre y tú gestionas allí reembolsos, disputas e impuestos. AdCobalt se queda con el 8 % de cada pago (la comisión de Stripe se aplica como siempre).
  • Activa la oferta en el Recovery Builder (pestaña Miembros), elige un precio mensual y, si quieres, uno anual, y publica. El botón «Sin anuncios» solo aparece cuando Stripe puede cobrar.
  • Añade un enlace a #adcobalt-membership en el pie de página o el menú, por ejemplo <a href="#adcobalt-membership">Membresía</a>. Los miembros lo usan para gestionar o cancelar; los demás visitantes pueden unirse o iniciar sesión.
  • Los miembros nunca ven el aviso. Para no cargarles tampoco los anuncios, envuelve tu código de anuncios: (window.adcobaltQueue = window.adcobaltQueue || []).push(function (ar) { if (!ar.isMember) { /* cargar anuncios */ } }); El script también lanza el evento adcobalt:ready.
  • Los miembros pueden cancelar en cualquier momento en dos clics desde el enlace del correo de bienvenida, desde tu enlace Membresía o en la página de gestión. Conservan el acceso hasta el final del periodo pagado.

La membresía se recuerda en el almacenamiento local del navegador en tu sitio. En otro dispositivo, los miembros inician sesión con su correo.

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 AdCobalt 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 tu sitio.
  • 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, si activaste Omitir la página de inicio, que no estás en ella.
  • Otros dominios que usan tu código (página Sitios web): tu fragmento se ejecutó en un dominio que no está en tu cuenta. Allí no se muestra ni se mide nada. Añádelo si es tuyo o ignóralo.

Privacidad y almacenamiento

El script no usa cookies. Usa el almacenamiento local en tu sitio para contar las páginas de una visita (una visita termina tras 30 minutos sin ver páginas), recordar cuándo se mostró por última vez un Recordatorio amable, que el navegador vio un aviso mientras bloqueaba anuncios (hasta 7 días) y que después los permitió (hasta 180 días tras su última visita) y, solo para miembros sin anuncios, un token de membresía firmado. Aparte de ese token, estas entradas solo guardan marcas de tiempo y contadores. AdCobalt no guarda direcciones IP de los visitantes; los eventos de detección se conservan un tiempo limitado y después solo quedan los totales diarios.

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