Este artigo faz parte da série Integração.
Antes de seguir o guia abaixo, certifique-se de ter consultado o artigo de apresentação geral Escolha seu método de integração do Axeptio.
⚠️ Atenção! Este método de integração não é aquele que recomendamos na maioria dos casos.
A integração do script Axeptio "na mão" deve ser reservada para contextos técnicos específicos (sites muito personalizados, restrições particulares, ambientes sem gerenciador de tags, etc.) e para pessoas com conhecimentos técnicos mínimos.
👉 Se este não for seu caso, ou se tiver dúvidas, recomendamos vigorosamente que privilegie os métodos de integração recomendados (Google Tag Manager, plugins CMS...), mais simples de manter e evoluir.
Antes de prosseguir, reserve um tempo para consultar o artigo Escolha seu método de integração do Axeptio para garantir que esta abordagem seja adequada ao seu projeto.
Já está carregando Axeptio por outro método (GTM, plugin CMS ou outro)? Nesse caso, não é necessário seguir este guia.
Obter o script do seu widget
O script do seu widget é o código que você deve inserir em seu site para exibir seu widget.
Para obtê-lo, é muito simples:
Na administração do Axeptio, abra seu projeto.
No menu à esquerda, clique em "Integração" e depois clique na aba "Geral".
No menu suspenso "Configuração do banner", selecione a configuração de seu banner a aplicar.
Pronto! Mágica, o script aparece! Até tem um pequeno botão "Copiar" para facilitar sua vida 😉
Integrar e publicar o script
Agora que você tem o script em mãos, tudo que resta é integrá-lo em seu site 💻
Você pode integrar o script Axeptio no código do seu site de uma das duas maneiras a seguir:
Logo antes do fechamento da tag </body>
Esta opção permite limitar o impacto no desempenho e é apropriada quando outros serviços (analytics, marketing, etc.) também são carregados no final da página.
Dentro da tag <head>
Esta opção deve ser privilegiada quando certos serviços ou tags de terceiros (como Google Analytics 4 ou Google Tag Manager) são carregados no início da página e dependem das informações de consentimento.
⚠️ Nota importante sobre localização e sequenciamento de scripts
Tenha especial atenção à localização do script Axeptio em suas páginas, relacionado aos outros serviços que dependem dele.
Algumas soluções, como Google Analytics 4, recomendam integrar sua tag diretamente no <head> para que seja carregada o mais cedo possível. Se uma tag GA4 (ou qualquer outro serviço equivalente) for carregada antes que Axeptio tenha conseguido definir os sinais do Consent Mode, as primeiras requisições serão enviadas sem sinais de consentimento, o que resultará em não conformidade.
Para evitar qualquer problema de sequenciamento, certifique-se de que Axeptio seja carregado pelo menos tão cedo quanto, e idealmente antes, qualquer serviço ou tag de terceiros que dependa das informações de consentimento.
Isso garante que os sinais de consentimento sejam devidamente definidos antes da execução desses serviços.