Neste guia vamos entender a etapa de Instalação da Tag AdOpt - uma das seis etapas essenciais de configuração do seu Aviso de Cookies na AdOpt.
💡 Dica: Recomendamos que deixe essa etapa por último e configure todas as outras anteriormente, pois são pré-requisito para o funcionamento da instalação.
Essa etapa é destinada a instalação e monitoramento da status da instalação da Tag da AdOpt no seu site. A maneira como a Tag for instalada pode afetar o seu funcionamento e isso ficará mais claro neste guia.
Código HTML da sua Tag
Siga o nosso tutorial guiado, ou o passo a passo abaixo:
Logo após acessar o seu painel da AdOpt, acesse a Organização e o Aviso que você deseja instalar.
Cada Aviso de Cookies criado dentro da sua conta terá um código HTML único! Dentro da seção de instalação do aviso, copie a Tag usando o botão à direita para evitar erros.
Maneiras de Instalar a Tag da AdOpt
Você poderá instalar a Tag:
via Google Tag Manager;
diretamente no código do seu site;
via plug-in de integração direta (Tray Commerce; WordPress;...)
Instalação via Google Tag Manager (GTM)
Siga o nosso tutorial guiado, ou o passo a passo abaixo:
1. Acesse sua conta do Google Tag Manager (GTM)
2. Crie uma Tag.
Em seu Google Tag Manager, crie uma nova Tag clicando em Novo > HTML personalizado.
No campo HTML cole o Código do Aviso AdOpt.
Para você identificar a Tag depois, coloque um nome na parte superior da página (exemplo: “Tag AdOpt”)
3. Acionador (Triggering):
Defina o disparo em Todas as Páginas (All Pages)
4. Clique em “Salvar/Guardar” e a Tag estará configurada.
5. Publique/Envie as alterações
📢 Importante: Não basta salvar. É necessário publicar as alterações para que o Aviso apareça em seu site.
6. Retorne à plataforma AdOpt, atualize a página limpando o cache. Após alguns minutos, vá na seção de "Instalação do Aviso", aperte em “Verificar Instalação”.
7. A plataforma AdOpt vai escanear o seu site buscando a instalação do código. Essa etapa pode levar alguns instantes.
8. Com o reconhecimento da instalação da Tag, o status da instalação será atualizado.
Seguindo todos esses passos seu aviso estará instalado!
Instalação via Código
Cole o código HTML da Tag da AdOpt no cabeçalho ou <header> do seu site.
Não esqueça de “Salvar” e “Publicar” a alteração no seu site.
A performance de ativação da Tag AdOpt é bem rápida. Uma vez dentro do site, verifique a ativação do Aviso de Cookies e seu funcionamento.
Retorne à plataforma AdOpt, atualize a página limpando o cache. Após alguns minutos, vá na sessão de "Instalação do Aviso", aperte em “Verificar Instalação”.
Instalação via Plug-in (Tray Commerce; WordPress;...)
Também é possível instalar via integração dentro da plataforma onde o seu site está hospedado.
A AdOpt está trabalhando para facilitar a instalação em plataformas como Tray Commerce, WordPress, VTEX e mais.
Verifique na Central de Ajuda a seção “Plataformas e integrações” para identificar todas as integrações disponíveis na AdOpt.
Verifique a sua Instalação
Clique em “Verificar a Instalação” para iniciar uma análise de nosso sistema em seu site. Será analisada a cada uma das etapas de configuração do Aviso de Cookies dentro da plataforma AdOpt e depois a instalação no seu site - nas URL’s cadastradas durante a criação do Aviso de Cookies.
Se precisar alterar as URLs, volte na página inicial da sua Organização e edite as URL’s do Aviso de Cookies.
Caso cada um dos passos for concluído com sucesso, a etapa de Instalação será atualizada e ficará concluída.
Resultado da Análise (Warnings e Errors)
Após a verificação da instalação o sistema da AdOpt apresentará um resultado da análise que pode conter: Warnings e Errors
Warnings (ou alertas) - cor amarela:
Indicam se o código foi instalado corretamente ou se existem melhorias que podem ser realizadas.
Estes não necessariamente paralisam o aparecimento do Aviso de Cookies da AdOpt, mas podem interferir nas funções essenciais da nossa Tag. Portanto, faz-se necessário analisar minuciosamente esses alertas para garantir o desempenho da Tag.
Exemplo de Warnings
Aqui está um exemplo de alerta comum que pode aparecer da sua conta:
Na maioria dos casos os alertas não influenciam na ativação da Tag (e Aviso de Cookies), mas vale analisar o detalhamento da mensagem:
No caso abaixo, a Tag não foi instalada no <head>.
A Tag instalada no <head> terá preferência frente a outros serviços instalados no site, o que pode garantir uma melhor performance da tag AdOpt e também o funcionamento correto de outras funcionalidades que dependem da ativação da AdOpt previamente aos serviços listados no banner.
Um exemplo desse mal funcionamento seria em relação ao Bloqueio de Tags, etapa essencial para garantir a conformidade do seu site com a privacidade dos seus visitantes.
📢 Importante: A Tag da AdOpt deve, necessariamente, vir antes de todas as Tags não necessárias do seu site. Desse modo, com a configuração do Bloqueio de Tags, elas somente serão ativadas após o consentimento expresso do visitante do seu site.
Neste outro exemplo, a classe do Aviso foi alterada, podendo influenciar no comportamento do Aviso. Verifique se o Aviso de Cookies está aparecendo no seu site. Caso estiver funcionando normalmente, ignore esse alerta.
💡 Dica: Em alguns casos, a alteração do conteúdo da Tag pode interferir no acionamento da mesma, como explicamos no guia: Erro de Cache
Errors (ou erros) - cor vermelha:
Significam que o sistema identificou erros na ativação ou no comportamento da Tag.
Mensagens de erro são críticas e interferem no funcionamento da AdOpt.
Exemplos de Erros
O erro abaixo indica que a Tag não foi instalada, ou que ainda não está no site.
Clicando na seta conforme print anterior, podemos observar um detalhamento da mensagem de erro. Ela apresentará:
Um código (Tag não instalada);
Um print do momento da análise (Captura de Tela);
Uma sugestão de solução (Código correto).
Monitore a Instalação
No painel da AdOpt é possível configurar a análise da instalação periodicamente. Dependendo do seu plano, é possível escolher entre a frequência semanal ou mensal e o cadastro de um e-mail para ser notificado com o resultado da análise.
