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

Como trabalhar com a API de Domínios Dinâmicos do AdBlock

As ferramentas de AdBlock estão cada vez mais sofisticadas, o que representa desafios significativos para os publicadores que procuram maximizar a receita proveniente da publicidade online. Para ajudar a mitigar estes desafios, esta API permite que os publicadores ajustem dinamicamente os seus scripts com base em domínios ativos, reduzindo significativamente o risco de o conteúdo ser bloqueado por software AdBlock.

Ao garantir a entrega de anúncios por meio de domínios rotacionados regularmente, os publicadores podem:

  • Manter as fontes de receita: Evitar interrupções causadas por anúncios bloqueados.

  • Melhorar a experiência do utilizador: Entregar conteúdo publicitário de forma fluida, sem acionar a deteção do AdBlock.

  • Automatizar a gestão de domínios: Eliminar atualizações manuais com um ciclo de vida automatizado de 7 dias para o domínio.

Novos domínios são gerados a cada 3 dias e ficam disponíveis através da API. Os domínios terão um ciclo de vida de 6 dias.

  • 3 dias ativos

  • 3 dias descontinuados

Assim que o ciclo de vida expirar, o domínio será desativado. Por motivos de desempenho, recomenda-se armazenar em cache o domínio durante 24 horas antes de solicitar um novo domínio da API.

Esta API está disponível apenas para Script inline de Popunders e Vídeo In-Stream zonas.

Requisitos

Para usar esta API, os publicadores precisam de:

  • Fazer uma pedido GET para o endpoint: https://ads.exoclick.com/adblock-domains.php

  • Receberá um novo domínio de veiculação de anúncios na resposta

  • De seguida, deve alterar o endpoint de sindicação usado na tag da sua zona de anúncios para o novo fornecido na resposta da API.

Passos para Implementar

1

Obter o Domínio Ativo

Para obter dinamicamente o Domínio ativo, deve fazer uma chamada de API servidor a servidor. Isto é crucial porque as chamadas à API podem ser bloqueadas se forem feitas do lado do cliente.

Aqui está um exemplo de chamada servidor a servidor em PHP:

E aqui está a resposta esperada da API:

2

Atualize o seu script

Use o domínio retornado pelo endpoint para atualizar o domínio usado na sua zona de anúncios. O domínio original depende do formato do anúncio:

  • Para Vídeo In-Stream zonas, altere a tag VAST:

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

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

  • Para zonas Popunders, altere o syndication_host no script inline:

    • Antes : s.pemsrv.com

    • Depois : newsub.newdomain.com

Detetar o AdBlock

Para detetar se o utilizador tem uma extensão de adblock ativada, você deve alojar ads.js do lado do publicador (o seu próprio domínio/CDN) e incluí-lo logo no início da sua body tag.

Não não solicitar https://www.exoclick.com/ads.js diretamente.

Crie o seu próprio ads.js ficheiro:

  1. Crie um ficheiro chamado ads.js num caminho público no seu site (por exemplo /js/ads.js).

  2. Adicione o seguinte conteúdo a esse ficheiro.

  3. Carregue esse ficheiro a partir da sua página antes da lógica de integração de anúncios.

Conteúdo do ficheiro de referência:

Depois, adicione a seguinte linha logo no início da sua body tag:

Este script será bloqueado pelo AdBlock caso o cliente o esteja a usar, devido à presença das palavras-chave "exoclick" e "ads". Após carregar este script, um snippet JS tentará ler uma variável específica. Se a variável estiver indefinida ou inacessível, podemos determinar que o script foi bloqueado.

Exemplos de Integração

Nestes dois exemplos estamos a usar fetchAdblockDomain.php como nome da chamada servidor a servidor para obter o domínio do Adblock.

In-Stream

Para usar Domínios Dinâmicos com In-Stream, certifique-se de incluir o player VAST dentro do scriptcaso contrário, o player carregará a zona de anúncios in-stream predefinida em vez de usar o domínio atualizado. Neste exemplo, estamos a usar o player HTML5 Fluidplayer.

Popunder

Resolução de problemas

Nenhum domínio devolvido

Por vezes, o endpoint pode devolver domínios vazios.

Registe sempre a resposta do endpoint durante a depuração para identificar potenciais problemas. Se success for false, contacte o suporte.

O domínio predefinido é devolvido apesar de o Adblock estar ativado

Aqui estão algumas razões comuns pelas quais o seu script pode estar a usar o domínio predefinido apesar de o Adblock estar ativado:

  • ads.js não está alojado do lado do publicador. Esta integração requer servir ads.js do seu próprio domínio (por exemplo /js/ads.js). Solicitar diretamente https://www.exoclick.com/ads.js não é suportado.

  • domínio predefinido sendo renderizado antes do domínio adblock. Certifique-se de que o script que insere a zona de anúncios no seu site aguarda sempre a chamada servidor-a-servidor. Dependendo da cadeia de execução, o domínio predefinido pode ser adicionado ao site antes de o domínio adblock ser devolvido, o que impedirá o seu site de inserir o domínio atualizado.

Para obter mais assistência, contacte a equipa de apoio aqui.

Última atualização

Isto foi útil?