Google AdSense

Nesta página

Integre o Google AdSense por meio dos layouts Astro e dos arquivos estáticos do seu site. Esta abordagem usa o código do site e não exige um plugin do EmDash. Você precisa de acesso ao código-fonte e à implantação do site, além do código de verificação e do ID de editor da sua conta do AdSense.

O Google controla a aprovação do site, a veiculação de anúncios e os requisitos de consentimento. Siga as instruções do Google para conectar um site na sua conta. Os exemplos abaixo mostram onde esse código fica no EmDash; eles não garantem a aprovação do AdSense.

Adicionar o código de verificação e de anúncios

  1. Abra o layout compartilhado usado pelas páginas públicas que você quer monetizar. No template de blog, ele é src/layouts/Base.astro. Mantenha o <EmDashHead> existente e o restante do conteúdo do head.

  2. Cole o código do AdSense no <head> do layout. O exemplo de carregador a seguir usa um ID de editor de espaço reservado; substitua todo o valor ca-pub-0000000000000000 pelo seu.

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

    O atributo is:inline do Astro mantém o script como foi escrito, em vez de incluí-lo no bundle. Carregue-o uma vez por página, mesmo quando várias unidades de anúncio compartilham a página. Consulte a documentação do Astro sobre o tratamento de scripts.

    Se você escolher o método de verificação por meta tag do AdSense, coloque a tag exata fornecida pelo Google no mesmo <head>. O exemplo a seguir mostra a tag de conta do AdSense com um ID de espaço reservado.

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

    O campo Google Verification em Settings > SEO do EmDash emite google-site-verification, não google-adsense-account. Não coloque o ID de editor do AdSense nesse campo.

  3. Para anúncios automáticos, configure as posições no AdSense. Para unidades de anúncio manuais, cole a marcação da unidade de anúncio e o script de inicialização do Google em um componente ou página do Astro onde o anúncio deve aparecer. Adicione is:inline a qualquer <script> de inicialização para que o Astro o preserve. Mantenha o carregador compartilhado no layout, em vez de repeti-lo para cada unidade.

Mantenha o código de anúncios executável no código-fonte confiável do site, e não no conteúdo das publicações. Aplique os requisitos de consentimento antes de habilitar os scripts de anúncios; este exemplo não implementa um gerenciador de consentimento. Se o site define uma Content Security Policy, configure-a para os recursos exigidos pelas instruções atuais do Google.

Servir o ads.txt na raiz

Crie public/ads.txt no projeto do seu site Astro, ao lado do diretório src/ do site. O Astro copia os arquivos públicos sem alterações, então o arquivo é servido em /ads.txt.

Copie para o arquivo, como texto simples, a linha fornecida pelo AdSense. O exemplo a seguir usa um ID de editor de espaço reservado; use a linha exata do Google para a sua conta.

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

Se o ads.txt já existir, adicione a linha do AdSense preservando as entradas de outros provedores de anúncios. Siga a orientação do Google sobre ads.txt para o domínio e o conteúdo de arquivo exigidos. Guarde este arquivo no projeto do site, não na biblioteca de mídia do EmDash.

Implantar e verificar

Implante o site depois de alterar o layout ou os arquivos de public/. No domínio público registrado no AdSense, verifique se:

  • O código-fonte da página contém a tag de verificação ou o script escolhido no <head>, com o seu ID de editor, e apenas um carregador compartilhado do AdSense.
  • https://your-domain.example/ads.txt retorna o texto simples esperado, em vez de um erro 404 ou de uma página HTML.
  • Os painéis de rede e de console do navegador não mostram erros de script nem requisições bloqueadas pela política de segurança do site. Bloqueadores de anúncios podem impedir que as verificações locais carreguem anúncios.

Volte ao AdSense para solicitar a verificação e a revisão. O carregamento bem-sucedido do script ou um arquivo ads.txt acessível não significa, por si só, que o site foi aprovado nem que os anúncios serão exibidos.

Reutilizar a integração em um plugin

Para uma integração compartilhada entre sites, um plugin nativo confiável pode contribuir com scripts por meio de page:fragments. O layout hospedeiro deve renderizar os componentes de inserção correspondentes do EmDash. Plugins em sandbox não podem injetar scripts nem HTML bruto. Um arquivo estático public/ads.txt continua sendo uma questão de implantação no nível do site.