Google AdSense

En esta página

Integra Google AdSense mediante los layouts de Astro y los archivos estáticos de tu sitio. Este enfoque usa código del sitio y no requiere un plugin de EmDash. Necesitas acceso al código fuente y al despliegue del sitio, además del código de verificación y el ID de editor de tu cuenta de AdSense.

Google controla la aprobación del sitio, la entrega de anuncios y los requisitos de consentimiento. Sigue las instrucciones de Google para conectar un sitio en tu cuenta. Los ejemplos siguientes muestran dónde va ese código en EmDash; no garantizan la aprobación de AdSense.

Agregar el código de verificación y de anuncios

  1. Abre el layout compartido que usan las páginas públicas que quieres monetizar. En la plantilla de blog, es src/layouts/Base.astro. Conserva su <EmDashHead> existente y el resto del contenido del head.

  2. Pega el código de AdSense en el <head> del layout. El siguiente ejemplo del cargador usa un ID de editor de marcador de posición; reemplaza todo el valor ca-pub-0000000000000000 por el tuyo.

    <script
        is:inline
        async
        src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
        crossorigin="anonymous"
    ></script>

    El atributo is:inline de Astro mantiene el script tal como está escrito en lugar de empaquetarlo. Cárgalo una sola vez por página, incluso cuando varias unidades de anuncios comparten la página. Consulta la documentación de Astro sobre el manejo de scripts.

    Si eliges el método de verificación por etiqueta meta de AdSense, coloca la etiqueta exacta que proporciona Google en el mismo <head>. El siguiente ejemplo muestra la etiqueta de cuenta de AdSense con un ID de marcador de posición.

    <meta name="google-adsense-account" content="ca-pub-0000000000000000" />

    El campo Google Verification en Settings > SEO de EmDash emite google-site-verification, no google-adsense-account. No pongas el ID de editor de AdSense en ese campo.

  3. Para los anuncios automáticos, configura las ubicaciones en AdSense. Para las unidades de anuncios manuales, pega el marcado de la unidad de anuncios y el script de inicialización de Google en un componente o página de Astro donde deba aparecer el anuncio. Agrega is:inline a cualquier <script> de inicialización para que Astro lo conserve. Mantén el cargador compartido en el layout en lugar de repetirlo para cada unidad.

Mantén el código de anuncios ejecutable en el código fuente confiable del sitio, no en el contenido de las entradas. Aplica los requisitos de consentimiento antes de habilitar los scripts de anuncios; este ejemplo no implementa un gestor de consentimiento. Si el sitio establece una Content Security Policy, configúrala para los recursos que requieren las instrucciones actuales de Google.

Servir ads.txt en la raíz

Crea public/ads.txt en el proyecto de tu sitio Astro, junto al directorio src/ del sitio. Astro copia los archivos públicos sin cambios, de modo que el archivo se sirve en /ads.txt.

Copia en el archivo, como texto sin formato, la línea que proporciona AdSense. El siguiente ejemplo usa un ID de editor de marcador de posición; usa la línea exacta de Google para tu cuenta.

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

Si ads.txt ya existe, agrega la línea de AdSense conservando las entradas de otros proveedores de anuncios. Sigue la guía de ads.txt de Google para conocer el dominio y el contenido de archivo requeridos. Guarda este archivo en el proyecto del sitio, no en la biblioteca de medios de EmDash.

Desplegar y comprobar

Despliega el sitio después de cambiar su layout o los archivos de public/. En el dominio público registrado en AdSense, comprueba que:

  • El código fuente de la página contiene la etiqueta de verificación o el script elegido en <head>, con tu ID de editor, y un único cargador compartido de AdSense.
  • https://your-domain.example/ads.txt devuelve el texto sin formato esperado en lugar de un 404 o una página HTML.
  • Los paneles de red y de consola del navegador no muestran errores de script ni solicitudes bloqueadas por la política de seguridad del sitio. Los bloqueadores de anuncios pueden impedir que las comprobaciones locales carguen anuncios.

Vuelve a AdSense para solicitar la verificación y la revisión. Que el script se cargue correctamente o que el archivo ads.txt sea accesible no significa por sí mismo que el sitio esté aprobado ni que se mostrarán anuncios.

Reutilizar la integración en un plugin

Para una integración compartida entre sitios, un plugin nativo de confianza puede aportar scripts mediante page:fragments. El layout anfitrión debe renderizar los componentes de inserción de EmDash correspondientes. Los plugins en sandbox no pueden inyectar scripts ni HTML sin procesar. Un archivo estático public/ads.txt sigue siendo una cuestión de despliegue a nivel de sitio.