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 "em disco" deve ser reservada para contextos técnicos específicos (sites muito customizados, restrições particulares, ambientes sem gerenciador de tags, etc.) e para pessoas com competências técnicas mínimas.
👉 Se este não for seu caso, ou se tiver dúvidas, recomendamos fortemente que você privilegie os métodos de integração recomendados (Google Tag Manager, plugins CMS...), que são 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.
Você já carrega Axeptio através de outro método (GTM, plugin CMS ou outro)? Nesse caso, você não precisa seguir este guia.
Obtenha o script do seu widget
O script do seu widget é o código que você deve inserir no 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 do seu banner a aplicar.
Pronto! Como mágica, o script aparece! Há até um pequeno botão "Copiar" para facilitar sua vida 😉
Integre e publique o script
Agora que você tem o script em mãos, só falta integrá-lo ao seu site 💻
Você pode integrar o script Axeptio no código do seu site de uma das duas maneiras seguintes:
Logo antes do fechamento da tag </body>
Esta opção permite limitar o impacto no desempenho e é adequada quando outros serviços (analytics, marketing, etc.) também são carregados na parte inferior da página.
Dentro da tag <head>
Esta opção deve ser preferida 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 o posicionamento e sequenciamento dos scripts
Tenha especial atenção ao posicionamento do script Axeptio nas suas páginas, em relação 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 possa 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 de, qualquer serviço ou tag de terceiros que dependa das informações de consentimento.
Isto garante que os sinais de consentimento sejam definidos corretamente antes da execução desses serviços.