As tags de script de Teste e Produção são os snippets de código que você usa para implementar o banner e a central de preferências que você configurou em conformidade com cookies em seu site. Depois que a tag for implementada em seu site e republicada no aplicativo, todas as alterações em seu modelo associado, regras de geolocalização ou categorizações serão enviadas para seu site automaticamente.
CDNs de teste e de produção
A CDN de teste ou a CDN de produção deve ser implementada o mais próximo possível da parte superior <head> da seção HTML do site em todas as páginas. O CDN contém um identificador exclusivo que é específico para o domínio para o qual foi gerado. Isso está no script data-Domain. O CDN de teste deve ser anexado a"-teste".
O script precisa de ser carregado em cada página do seu domínio para garantir que os visitantes encontrem imediatamente um banner e uma central de preferências quando acessam seu site, se eles ainda não tiverem consentido. Depois que o usuário tiver consentido ou interagido com o banner e/ou a central de preferências, um cookie será deixado na página para impedir que o banner reapareça nas páginas subsequentes do usuário.
Se você usar um construtor de sites ou um sistema de gerenciamento de conteúdo (CMS) para gerenciar seus domínios, poderá personalizá-lo no modelo de seu site ou por meio de um recurso de injetor de código.
Cuidado
O script deve ser colocado antes de qualquer outro script em seu site, para garantir que o banner seja carregado antes de qualquer outro script carregar ou definir cookies. Isso permite que a tag do script comunique as preferências de consentimento do visitante do site aos fornecedores subsequentes.
Dica
Você pode definir códigos de idioma usando sublinhados ou hifens.
Exemplo: EN-US ou en_US.
O CDN de teste corresponde ao script CDN de produção, exceto por:
Não há cache, o que significa que as alterações podem ser visualizadas imediatamente depois da republicação.
Esse script funcionará em qualquer site de teste que seja ou não um subdomínio do domínio verificado no aplicativo e deve ser usado para fins de teste.
Nota
Quando um cookie é escrito, ele é escrito para um domínio específico, por exemplo .exemplo.com ou www.teste-exemplo.com.
Um cookie escrito em .exemplo.com é enviado em qualquer solicitação para o domínio raiz.
Entretanto, se estivesse em um domínio diferente, como www.staging-example.com, não conseguiria escrever um cookie em .exemplo.com. Qualquer domínio com www. é considerado um subdomínio de um domínio maior.
O script CDN de teste escreve cookies no domínio em que está atualmente, permitindo que ele se comporte como o script CDN de produção em um ambiente de teste. A CDN de produção é específica do domínio verificado no aplicativo.
Atenção
Se o seu domínio e o script não forem os mesmos, o script não funcionará corretamente e o banner reaparecerá continuamente.
Se o seu site de teste/teste for um domínio diferente do seu script, você deverá usar o script de teste para testar e funcionar corretamente.
O script CDN de produção faz referência a um SDK hospedado pela OneTrust. Caso queira hospedar o SDK em seus próprios servidores, poderá baixar o SDK completo e hospedá-lo localmente.
Visualização do Log de alterações
Ao publicar um script, a primeira tela será o Log de alterações. Esta tela mostrará as principais alterações no script que serão publicadas e todos os recursos incompatíveis com a versão do script que você está tentando publicar.
Implementando o script CDN de teste
No menu Conformidade de cookies, selecione Scripts. É exibida a tela Scripts.
Selecione o domínio onde o Banner do cookie será implementado.
Clique no botão Publicar teste. O painel Testar site é exibido.
Escolha uma versão para publicar e revisar os recursos incompatíveis. Clique em Confirmar.
Clique no botão Copiar scripts para obter o script CDN de teste.
Cole o script copiado em sua seção <head> para seu local de teste. O script deve ser colocado antes de qualquer outro script em sua seção <head>.
Testar CDN - Tela de referência
Campo
Descrição
Escolha uma versão do script para publicar
Escolha a versão do script a ser publicado. O padrão será a versão mais recente.
Essa configuração permite publicar a configuração em uma versão anterior do OneTrust.
Ao publicar um script em uma versão mais antiga do que a atual versão OneTrust de seu locatário OneTrust (por exemplo OneTrust está atualmente em 6,7, Mas você quer publicar seu script na versão 6,6), você não poderá utilizar nenhum dos novos recursos ou correções de bugs que foram lançados com a versão mais recente do OneTrust (no cenário acima, quaisquer recursos lançados com 6,7).
Se selecionar uma versão mais antiga, haverá uma lista de recursos incompatíveis com a versão de publicação selecionada. Esses recursos ainda poderão ser configurados na ferramenta Admin, mas o script não poderá usar esses recursos se for publicar em uma versão mais antiga.
Nota
A data de término do suporte para a versão selecionada será exibida.
Publicar idiomas individuais.
Habilite esta configuração para publicar o script para um idioma ou idiomas específicos. Se não habilitada, todos os idiomas serão publicados. Esta opção é desabilitada por padrão.
Nota
Se a detecção de idiomas não estiver ativada para o script, será necessário publicar os idiomas individualmente.
Se o script tiver sido publicado anteriormente para todos os idiomas existentes nos modelos, esses idiomas ainda existirão quando o script for carregado. Somente as alterações aplicadas aos idiomas selecionados serão publicadas.
Solicitar que usuários consintam novamente?
A ativação dessa configuração exigirá que os usuários do site tenham o consentimento novamente. Isso irá expirar o cookie do OptanonAlertBoxClosed e adicionar um valor de AwaitingReconsent=true ao cookie do OptanonConsent. O valor anterior de consentimento dos usuários ainda estará presente após o consentimento, de modo que os valores da categoria de cookies não sejam redefinidos com base na configuração padrão. Quando os arquivos de script são carregados com a nova configuração (não carregados do cache), o banner será apresentado novamente se configurado como tal para a regra de geolocalização.
Impedir busca de banner
Se a opção Impedir Busca de banner ou Central de preferências estiver ativada, quando a página for carregada, não carregaremos o HTML ou CSS. Esses elementos só serão chamados quando o visitante do site tomar uma ação explícita para chamá-los. Isso é usado para ajudar a otimizar o desempenho do site.
Impedir que se obtenha a Central de preferências
Quando ativado, o modelo HTML e CSS da Central de preferências só será carregado quando necessário.
Ativar bloqueio automático de cookies
A configuração ativará o recurso de bloqueio automático OneTrust. Os cookies serão automaticamente bloqueados ou autorizados a cair com base no modelo de consentimento configurado e, em seguida, quando o usuário fornecer consentimento ou interagir, bloqueados ou autorizados a cair de acordo . Certifique-se de ler se OneTrust Cookie Auto-Blocking™ deseja ativar esse recurso.
A ativação desse recurso adiciona um script adicional à CDN, portanto, se você já tiver implementado, certifique-se de incluir o script adicional em sua página. O script será encontrado no mesmo local na CDN.
Bloquear tecnologias de rastreamento conhecidas automaticamente
Se ativados, os cookies, pixels e web beacons conhecidos por serem usados na segmentação do público serão automaticamente bloqueados.
Este recurso será ativado e definido para "determinar o idioma das configurações do navegador do visitante do site" por padrão. Isso significa que o usuário verá o banner e a central de preferências no idioma configurado para o navegador se o idioma estiver configurado no modelo.
Caso opte por mudar a configuração para "Determinar o idioma na página HTML", o idioma será controlado pelo idioma declarado em HTML. O código de idioma no HTML deve corresponder ao código de idioma do modelo.
Por exemplo, tenho um site alemão onde quero mostrar o banner cookie para meus usuários em alemão e quero fazer isso com base no meu idioma declarado em HTML. O código de idioma para alemão no meu modelo OneTrust é "de". Posso ver isso em Gerenciar Idiomas. Meu código de idioma declarado em HTML também precisaria ser "de".
<html lang="de">
A seleção desta configuração adiciona data-document-language="true" ao script. Caso já tenha implementado seu script e decida alterar esta configuração, será necessário fazer essa adição ao script. Isso será refletido na CDN após a configuração.
Como implementar o script CDN de produção
Importante
[en] Production scripts can only be published within 30 minutes of publishing test scripts. You must first publish you test script to publish your production script.
Use este script para o seu site de produção. As alterações publicadas levarão até 4 horas para serem armazenadas. Você pode evitar esse atraso usando o botão Habilitar eliminação de cache.
Nota
Para evitar que eventos sejam enviados ao Google Analytics, adicione o seguinte atributo ao script do Banner de cookies.
data-ignore-ga='true'
No menu Conformidade de cookies, selecione Scripts. É exibida a tela Scripts.
Selecione o domínio onde o script será implementado.
Clique no botão Publicar a produção. É exibido o painel Publicar.
Selecione a versão do script para publicar e revisar os recursos incompatíveis.
Nota
A data de término do suporte para a versão selecionada será exibida.
Clique no botão Confirmar.
Personalize suas configurações para o script CDN de produção. Caso queira hospedar seu script localmente, clique em Baixar para baixar o script para executá-lo localmente. Consulte CDN de produção - Tela de referência.
Acesse a guia Scripts de produção.
Cole o script copiado no <head> do seu site. O script deve ser colocado antes de qualquer outro script em sua seção <head>.
Clique no botão Publicar para publicar suas configurações.
Botão Configurações de cookies
O botão Configurações de cookies é uma forma de permitir que os usuários do seu site revejam a central de preferências e alterem seu consentimento. O texto do botão pode ser configurado no modelo. O script CDNde produção também deve ser incluído na página.
No menu Conformidade de cookies, selecione Scripts. É exibida a tela Scripts.
Clique no nome do domínio que deseja implementar. A tela Detalhes dos scripts é exibida.
Navegue até a guia Scripts de produção ou Scripts de teste
Clique no botão Copiar script para obter o script do botão "Configuração de cookies".
Cole o script copiado no código do seu site. O botão Configurações de cookies faz referência ao script que é colocado no <head> do site.
Lista de cookies
Este snippet irá inserir uma lista de cookies detalhada, incluindo uma descrição e tabela de cookies com base na categorização atual de cookies. É possível incorporar o script em uma política de privacidade ou em uma página de lista de cookies independente. O script CDN de produção também deve ser incluído na página.
No menu Conformidade de cookies, selecione Scripts. É exibida a tela Scripts.
Clique no nome do domínio que deseja implementar. A tela Detalhes dos scripts é exibida.
Navegue até a guia Scripts de produção ou Scripts de teste.
Clique no botão Copiar script para obter o script da lista de cookies.
Cole o script copiado no código da página em que deseja exibir a lista. A lista de cookies faz referência ao script que é colocado no <head> do site.
CDN de produção - Tela de referência
Campo
Descrição
Escolha uma versão do script para publicar
Escolha a versão do script a ser publicado. O padrão será a versão mais recente.
Essa configuração permite publicar a configuração em uma versão anterior do OneTrust.
Ao publicar um script em uma versão mais antiga do que a atual versão OneTrust de seu locatário OneTrust (por exemplo OneTrust está atualmente em 6,7, Mas você quer publicar seu script na versão 6,6), você não poderá utilizar nenhum dos novos recursos ou correções de bugs que foram lançados com a versão mais recente do OneTrust (no cenário acima, quaisquer recursos lançados com 6,7).
Se selecionar uma versão mais antiga, haverá uma lista de recursos incompatíveis com a versão de publicação selecionada. Esses recursos ainda poderão ser configurados na ferramenta Admin, mas o script não poderá usar esses recursos se for publicar em uma versão mais antiga.
Nota
A data de término do suporte para a versão selecionada será exibida.
Publicar idiomas individuais
Habilite esta configuração para publicar o script para um idioma ou idiomas específicos. Se não habilitada, todos os idiomas serão publicados. Esta opção é desabilitada por padrão.
Nota
Se a detecção de idiomas não estiver ativada para o script, será necessário publicar os idiomas individualmente.
Solicitar que usuários consintam novamente?
A ativação dessa configuração exigirá que os usuários do site tenham o consentimento novamente. Isso irá expirar o cookie do OptanonAlertBoxClosed e adicionar um valor de AwaitingReconsent=true ao cookie do OptanonConsent. O valor anterior de consentimento dos usuários ainda estará presente após o consentimento, de modo que os valores da categoria de cookies não sejam redefinidos com base na configuração padrão. Quando os arquivos de script são carregados com a nova configuração (não carregados do cache), o banner será apresentado novamente se configurado como tal para a regra de geolocalização.
Ativar o Cache Busting
Habilite esse recurso para eliminar o atraso entre a publicação do Script de produção e as alterações que aparecem no domínio.
Impedir busca de banner
Se a opção Impedir busca de banner ou Central de preferências estiver ativada, quando a página for carregada, não carregaremos o HTML ou CSS. Esses elementos só serão chamados quando o visitante do site tomar uma ação explícita para chamá-los. Isso é usado para ajudar a otimizar o desempenho do site.
Impedir que se obtenha a Central de preferências
Quando ativado, o modelo HTML e CSS da Central de preferências só será carregado quando necessário.
Ativar bloqueio automático de cookies
A configuração ativará o recurso de bloqueio automático OneTrust. Os cookies serão automaticamente bloqueados ou autorizados a cair com base no modelo de consentimento configurado e, em seguida, quando o usuário fornecer consentimento ou interagir, bloqueados ou autorizados a cair de acordo . Certifique-se de ler por meio do bloqueio automático de cookies OneTrust se quiser ativar esse recurso.
A ativação desse recurso adiciona um script adicional à CDN, portanto, se você já tiver implementado, certifique-se de incluir o script adicional em sua página. O script será encontrado no mesmo local na CDN.
Bloquear tecnologias de rastreamento conhecidas automaticamente
Se ativados, os cookies, pixels e web beacons conhecidos por serem usados na segmentação do público serão automaticamente bloqueados.
Este recurso será ativado e definido para "determinar o idioma das configurações do navegador do visitante do site" por padrão. Isso significa que o usuário verá o banner e a central de preferências no idioma configurado para o navegador se o idioma estiver configurado no modelo.
Caso opte por mudar a configuração para "Determinar o idioma na página HTML", o idioma será controlado pelo idioma declarado em HTML. O código de idioma no HTML deve corresponder ao código de idioma do modelo.
Por exemplo, tenho um site alemão onde quero mostrar o banner cookie para meus usuários em alemão e quero fazer isso com base no meu idioma declarado em HTML. O código de idioma para alemão no meu modelo OneTrust é "de". Posso ver isso em Gerenciar Idiomas. Meu código de idioma declarado em HTML também precisaria ser "de".
<html lang="de">
A seleção desta configuração adiciona data-document-language="true" ao script. Caso já tenha implementado seu script e decida alterar esta configuração, será necessário fazer essa adição ao script. Isso será refletido na CDN após a configuração.
