Pular para o conteúdo principal
// translate-ignore ‘O banner de consentimento com os cookies permite ativar/desativar diferentes scripts de análise com base nas preferências do usuário.’; Superadministradores e usuários com permissão para editar as configurações do site podem personalizar o rastreamento de cookies do visitante e os banners de consentimento para cumprir com as leis de cookies da UE e o Regulamento Geral de Proteção de Dados (GDPR). Um banner de consentimento com os cookies permite que os visitantes aceitem ou recusem o rastreamento na sua conta da HubSpot com cookies. Este recurso funciona para todas as páginas da HubSpot, bem como para todas as páginas externas que tenham seu código de rastreamento do HubSpot instalado. Personalize as configurações de rastreamento de cookies e o banner de consentimento com os cookies. Neste artigo, saiba como gerenciar os cookies que são adicionados ao navegador de um visitante através do banner de consentimento com os cookies. Saiba também como usar um banner de consentimento com cookies de terceiros para distribuir o consentimento, desativar a coleta de consentimento e gerenciar recursos no HubSpot.

​
Remover cookies

_hsp.push(['revokeCookieConsent']); Remova os cookies criados pelo código de rastreamento do HubSpot que estão incluídos no banner de consentimento abaixo do GDPR; inclua os cookies da HubSpot relacionados ao rastreamento do visitante. Devido à remoção dos cookies, o visitante verá o banner de consentimento de cookies na próxima vez que carregar a página, pois ele aparecerá como se fosse um novo visitante. Esta função não remove os cookies colocados por banners externos. Veja a lista específica de cookies que serão removidos na central de conhecimento da HubSpot. Se o bloqueio de cookies estiver ativado, esta função revogará o consentimento, de modo que nenhum cookie de terceiros será atualizado ou adicionado em visitas futuras ao site. O bloco de código abaixo fornece um exemplo de definição de um manipulador de eventos para remover cookies quando o usuário clica em um elemento (como um botão) com um id de removeCookies: 
/*
Example code to remove the consent banner cookies
when a visitor clicks an element with the 'removeCookies' id.
*/

var _hsp = (window._hsp = window._hsp || []);
document.getElementById("removeCookies").onclick = function () {
  _hsp.push(["revokeCookieConsent"]);
};
_hsq.push(['doNotTrack']); Insira o cookie __hs_do_not_track no navegador do visitante. Isso impedirá que o código de rastreamento do HubSpot envie qualquer informação do visitante. Você pode remover o cookie chamando a função novamente e incluindo o {track: true} argumento: _hsq.push(['doNotTrack', {track: true}]); O bloco de código abaixo fornece um exemplo de definição de um manipulador de eventos para remover cookies quando o usuário clica em um elemento (como um botão) com um id de removeCookies: 
document.getElementById("doNotTrack").onclick = function () {
  _hsq.push(["doNotTrack"]);
};

​
Obter o status de consentimento de privacidade

_hsp.push(['addPrivacyConsentListener', callbackFunction]); Obtenha o status de consentimento de privacidade do visitante atual. Existem três categorias de consentimento que podem ser usadas para fornecer um controle mais granular ao usuário. Cada uma delas tem suas próprias chaves dentro do objeto consent.categories:
  • consent.categories.analytics
  • consent.categories.advertisement
  • consent.categories.functionality
A callbackFunction será chamada, dependendo do estado da página:
  • Se o banner não estiver ativado ou se o visitante já tiver visto o banner e clicado em aceitar ou recusar:
    • a callbackFunction será chamada imediatamente se o código do banner já estiver carregado.
    • a callbackFunction será chamada depois que o código de rastreamento for carregado se a função for enviada por push para _hsp antes do carregamento do código de rastreamento.
  • Se o banner estiver ativado, a função de chamada de retorno será chamada quando o visitante clicar no botão aceitar ou recusar.
O bloco de código abaixo demonstra como registrar os vários status de consentimento de categoria do visitante atual no console. 
var _hsp = (window._hsp = window._hsp || []);

// analytics
_hsp.push([
  "addPrivacyConsentListener",
  function (consent) {
    console.log(consent.categories.analytics);
  },
]);

// advertisement
_hsp.push([
  "addPrivacyConsentListener",
  function (consent) {
    console.log(consent.categories.advertisement);
  },
]);

// functionality
_hsp.push([
  "addPrivacyConsentListener",
  function (consent) {
    console.log(consent.categories.functionality);
  },
]);

// or it can all be done in one call
_hsp.push([
  "addPrivacyConsentListener",
  function (consent) {
    console.log(`analytics: ${consent.categories.analytics}`);
    console.log(`advertisement: ${consent.categories.advertisement}`);
    console.log(`functionality: ${consent.categories.functionality}`);
  },
]);

​
Cookies não por categoria

_hsp.push(['addPrivacyConsentListener', callbackFunction]); Permite que você obtenha o status de true ou false para o consentimento de privacidade do visitante atual. A callbackFunction será chamada, dependendo do estado da página:
  • Se o banner não estiver ativado ou se o visitante já tiver visto o banner e clicado em aceitar ou recusar:
    • a callbackFunction será chamada imediatamente se o código do banner já estiver carregado.
    • a callbackFunction será chamada depois que o código de rastreamento for carregado se a função for enviada por push para _hsp antes do carregamento do código de rastreamento.
  • Se o banner estiver ativado, a função de chamada de retorno será chamada quando o visitante clicar no botão aceitar ou recusar.
O bloco de código abaixo demonstra como registrar o status de consentimento do visitante atual no console. 
var _hsp = (window._hsp = window._hsp || []);
_hsp.push([
  "addPrivacyConsentListener",
  function (consent) {
    if (consent.allowed) {
      console.log("something");
    }
  },
]);
A callbackFunction aceita um objeto consent como seu único argumento. O objeto consent tem uma única propriedade allowed que será true se:
  • O banner de consentimento com os cookies não está ativado ou está ativado no modo somente notificação.
  • O visitante clica em Aceitar no banner quando o modo de consentimento está ativado.
  • O visitante clicou anteriormente em Aceitar no banner quando o modo de consentimento estava ativado.
A propriedade será false se o banner de consentimento estiver habilitado no modo opt-in e o visitante clicar ou tiver clicado anteriormente no botão de recusar.

​
Permitir que os visitantes do site gerenciem o consentimento

Chame a função showBanner para mostrar o banner novamente, permitindo que os visitantes do site façam alterações em suas preferências de consentimento. Por exemplo: 
​​var _hsp = window._hsp = window._hsp || [];
​​_hsp.push(['showBanner']);
O comportamento de showBanner varia de acordo com a política e está disponível apenas para políticas de Opt-In e Cookie por categoria. Para políticas de Opt-in, chamar showBanner fará com que o banner reapareça, conforme mostrado no vídeo abaixo: Para políticas de Cookies por categoria, chamar showBanner fará com que o modal para selecionar cada categoria reapareça, como mostrado no vídeo abaixo:

​
Exemplos de UI

Essa funcionalidade pode ser disponibilizada aos visitantes na forma de botões/links no seu site que eles podem usar para reabrir o banner e editar suas preferências. Veja a seguir exemplos com código.

​
Botão

Um botão, geralmente colocado no rodapé do site. 
<button
  type="button"
  id="hs_show_banner_button"
  onClick="(function(){
        var _hsp = window._hsp = window._hsp || [];
        _hsp.push(['showBanner']);
      })()"
>
  Cookie Settings
</button>

​
Botão de posição fixa

Um botão com posicionamento fixo na parte inferior da tela. Este tipo de botão tem a vantagem de estar prontamente disponível e fácil de encontrar, embora seja um pouco intrusivo para a experiência do usuário. 
<button
  id="hs-hud-cookie-settings"
  onClick="(function(){
      var _hsp = window._hsp = window._hsp || [];
      _hsp.push(['showBanner']);
    })()"
>
  Cookie Settings
</button>
Um link ou texto realçado. 
<a
  id="hs-cookie-settings-link"
  onClick="(function(){
      var _hsp = window._hsp = window._hsp || [];
      _hsp.push(['showBanner']);
    })()"
>
  Cookie Settings
</a>

​
Bloquear cookies de terceiros manualmente

O Banner de consentimento da HubSpot permite o tratamento manual de tecnologias de rastreamento de terceiros e cookies. É recomendado usar o tratamento manual se você tiver um site complexo e/ou um desenvolvedor Web dedicado. Se o bloqueio automático não funcionar para o seu site, o bloqueio manual poderá ser uma boa opção. O bloqueio manual é implementado por meio da API do ouvinte de consentimento do banner de cookie, conforme descrito nas seções abaixo. Esta API é usada para impedir que as tecnologias de rastreamento sejam executadas até que haja consentimento.

​
Uso geral

Se você quiser instalar um script de rastreamento no seu site para exibir anúncios direcionados aos visitantes. Você pode usar algo como o seguinte: <script src=”https://my.advertisement.script.com/ads”></script> Quando esse script é colado no HTML de cabeçalho de uma página em um site, ele é executado sempre que alguém visita essa página, independentemente do status de consentimento. Os visitantes terão cookies colocados em seu navegador sem consentimento. Para impedir que o script seja executado sem consentimento, você pode usar a API de escuta de consentimento do banner de cookies da HubSpot para instalar o script quando o visitante consentir com seus cookies. Escutas de consentimento são funções que são executadas sempre que o visitante envia seu consentimento. Para usar essa funcionalidade, é necessário criar uma escuta de consentimento que adicione o script à página se o visitante tiver consentido com os cookies de anúncios. 
<script>
 var _hsp = window._hsp = window._hsp || [];
_hsp.push(['addPrivacyConsentListener', (consent) => {
if (consent.categories.advertisement) {
const script = document.createElement('script');
        	script.src = "https://my.advertisement.script.com/ads";
        	document.head.appendChild(script)
}
}])
</script>
Este script registrará a escuta de consentimento no banner de cookies. Quando o consentimento com os cookies é enviado, a escuta de consentimento será executada, adicionando o script de anúncios de terceiros da HubSpot à página.

​
Exemplo: Google Tag

Google Tag ou gtag.js pode ser usado para adicionar o Google Analytics. Por exemplo: 
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_TRACKING_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){window.dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'GA_TRACKING_ID');
</script>
Para carregar o Google Analytics quando o consentimento com a análise tiver sido dado, o script gtag precisa ser adicionado: 
<!-- Google tag (gtag.js) -->
<script>
     var _hsp = window._hsp = window._hsp || [];
    _hsp.push(['addPrivacyConsentListener', (consent) => {
    if (consent.categories.analytics) {
        const script = document.createElement('script');
          script.src = "https://www.googletagmanager.com/gtag/js?id=GA_TRACKING_ID";
          script.async = 'true'
          document.head.appendChild(script)
      }
    }])
</script>
<script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());
    gtag('config', 'GA_TRACKING_ID');
</script>

​
Exemplo: HotJar

HotJar é outro exemplo de rastreamento de análises. Por exemplo: 
<!-- Hotjar Tracking Code -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:HOT_JAR_ID,hjsv:6};
        a=o.getElementsByTagName('head')[0];
        r=o.createElement('script');r.async=1;
        r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        a.appendChild(r);
    })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>
Para garantir que Hotjar seja executado quando o consentimento com a análise for dado, a escuta de consentimento pode ser adicionada. 
<!-- Hotjar Tracking Code -->
<script>
var _hsp = window._hsp = window._hsp || [];
_hsp.push(['addPrivacyConsentListener', (consent) => {
	if (consent.categories.analytics){
(function(h,o,t,j,a,r){
        		h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        		h._hjSettings={hjid:HOT_JAR_ID,hjsv:6};
        		a=o.getElementsByTagName('head')[0];
        		r=o.createElement('script');r.async=1;
        		r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        		a.appendChild(r);
    		})(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
}

}])
</script>

​
Consentimento com os cookies de terceiros

Na seção abaixo, saiba como usar um banner de consentimento com cookies de terceiros para:
  • Distribuir consentimento
  • Desativar a coleta de consentimento
  • Gerenciar recursos no HubSpot

​
Desativar o banner de cookies da HubSpot

Para desativar a renderização do banner de cookies da HubSpot, inclua o código abaixo em um script próximo à parte superior do html principal da página. Isso também desativará qualquer gerenciamento de consentimento. 
window.disableHubSpotCookieBanner = true;

​
Definir estado de consentimento do banner de cookies da HubSpot

Defina o valor de consentimento para todos os produtos da HubSpot, de terceiros ou personalizados integrados ao banner de cookies da HubSpot. Essa função pega um objeto especificando o estado de consentimento do visitante, salva esse valor como o estado de consentimento atual e distribui esse consentimento a todos os scripts com escutas de consentimento. Este valor não é salvo em cookies de consentimento gerenciados pelo banner de cookies. Cabe ao chamador desta função preservar o estado de consentimento entre as sessões. A função aceita um objeto de consentimento com os seguintes campos:
Nome do campoTipoDescrição
analyticsBooleanoConcede consentimento para usar cookies para coletar dados de análises do visitante do site.
advertisementBooleanoConcede consentimento para o uso de cookies para ajudar a exibir anúncios personalizados para o visitante.
functionalityBooleanoConcede consentimento para o uso de cookies para a funcionalidade necessária ao funcionamento do seu site (por exemplo, autenticação).
O bloco de código de exemplo abaixo inicializa todos os valores de consentimento para true. 
window._hsp = window._hsp || [];
window._hsp.push([
  "setHubSpotConsent",
  {
    analytics: true,
    advertisement: true,
    functionality: true,
  },
]);
Exemplo: usando um banner de cookie de terceiros para controlar os cookies da HubSpot O Snippet de código e o script a seguir fornecem um exemplo de como enviar um evento personalizado sempre que o estado de consentimento for alterado. Observe que a funcionalidade que você deseja implementar para seu caso de uso específico pode ser diferente do código de exemplo abaixo. Consulte a documentação de terceiros (por exemplo, a introdução do Google ao gerenciamento de consentimento do usuário) para obter mais informações sobre como adaptar o comportamento às necessidades do seu site. 
CustomEvent("thirdPartyConsentEvent", {
  detail: {
    analytics: true,
    advertisement: true,
    functionality: true,
  },
});
O script a seguir deve ser colocado na parte superior do html do cabeçalho da página. 
<script>
  // disable the hubspot cookie banner window.disableHubSpotCookieBanner = true // listen for the third party consent
  event and send consent to HubSpot window._hsp = window._hsp || []; document.addEventListener("thirdPartyConsentEvent",
  (e) =>{" "}
  {window._hsp.push([
    "setHubSpotConsent",
    {
      analytics: e.detail.analytics,
      advertisement: e.detail.advertisement,
      functionality: e.detail.functionality,
    },
  ])}
  )
</script>;
Last modified on December 10, 2025