PrestaShop

Módulo CookiePilot para PrestaShop com Consent Mode v2

Carregue um único ZIP no Module Manager, ligue o domínio da loja e o módulo serve o banner de consentimento a partir do head de cada página da loja. Compatível com PrestaShop 8.0.0 a 9.99.99.

Requisitos e versões suportadas

  • PrestaShop na versão 8.0.0 a 9.99.99.
  • Acesso ao back office com permissão para instalar módulos.
  • Uma conta CookiePilot. Pode registar-se, verificar o e-mail e iniciar sessão diretamente dentro do módulo.
  • O ZIP do módulo, versão 1.0.0, descarregado a partir da ligação abaixo. Não o descompacte.

Descarregue o módulo

O ZIP é servido pela aplicação CookiePilot no endereço abaixo e nunca é distribuído através de marketplaces de terceiros. Depois de descarregar, compare a soma SHA-256 com o valor publicado para confirmar que o ficheiro não foi alterado pelo caminho.

Tamanho: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Descarregar o ZIP

Em Linux ou macOS execute o comando abaixo. Em Windows use certutil -hashfile sobre o ficheiro descarregado. O resultado tem de coincidir exatamente com o resumo publicado.

tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL https://app.cookiepilot.io/downloads/cookiepilot-prestashop-addons-1.0.0.zip -o "$tmp"
echo "9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9  $tmp" | sha256sum --check

Instale o ZIP no Module Manager

  1. 1.No back office abra Módulos, depois Module Manager, e clique em Carregar um módulo.
  2. 2.Arraste o ZIP descarregado para a janela de upload. O PrestaShop instala-o e apresenta-o na lista como CookiePilot CMP.
  3. 3.Clique em Configurar na entrada CookiePilot CMP para abrir a página de configuração do módulo.
  4. 4.Se o upload for rejeitado, verifique se a versão do PrestaShop está entre 8.0.0 e 9.99.99 e se o ZIP é o ficheiro original, sem alterações.

Registe-se, verifique o e-mail e ligue a loja

  1. 1.Na página de configuração crie uma conta CookiePilot ou inicie sessão numa conta existente. O registo pede apenas um endereço de e-mail e uma palavra-passe.
  2. 2.Confirme o e-mail de verificação. O módulo conclui o início de sessão assim que o endereço fica verificado.
  3. 3.Ligue a loja: o módulo cria o domínio na sua conta CookiePilot automaticamente, ou volta a ligar-se a um domínio existente com o mesmo nome de host.
  4. 4.O painel Shop connection mostra então o domínio ligado, a conta e o plano atual, com o estado CONNECTED.

Onde o script é injetado

  1. 1.O módulo injeta o script CookiePilot no head de cada página da loja, exatamente uma vez, antes das tags de análise. Nunca cola código no tema, e hooks duplicados num tema não geram uma segunda cópia.
  2. 2.Se já existir no tema ou num contentor de tags um snippet CookiePilot colado à mão ou outro banner de consentimento, remova-o. Duas camadas de consentimento na mesma página competem pelo estado de consentimento e corrompem a medição.
  3. 3.O painel Storefront status tem um único interruptor, Enable CookiePilot banner and Consent Mode, pelo que pode confirmar a qualquer momento se o script está a ser servido.

Mapeamento do Consent Mode v2

  1. 1.O módulo define os valores por omissão do Google Consent Mode v2 como denied antes de o visitante tomar qualquer decisão. O armazenamento de análise e de marketing permanece denied até existir consentimento.
  2. 2.Accept All concede todas as categorias. Reject All mantém todas as categorias em denied. O consentimento granular concede exatamente as categorias que o visitante selecionou na vista de definições.
  3. 3.Os scripts opcionais estáticos e dinâmicos registados no módulo são bloqueados e libertados pelas mesmas categorias, pelo que um script só corre quando a sua categoria está concedida.

Comportamento em multiloja

  1. 1.Numa instalação multiloja a configuração é guardada por loja. Cada loja liga o seu próprio domínio e mantém as suas próprias chaves.
  2. 2.Uma loja acabada de criar não herda as chaves da loja proprietária. Abra a configuração do módulo no contexto de cada loja e ligue-a separadamente.

Verifique o dataLayer na consola

Abra a loja numa janela privada, abra a consola do navegador e cole o snippet abaixo. Antes de qualquer decisão deve ver uma única entrada default com valores denied. Depois de uma decisão tem de surgir uma entrada update com as categorias concedidas.

(window.dataLayer || []).forEach(function (entry) {
  if (entry && entry[0] === 'consent') {
    console.log(entry[1], entry[2]);
  }
});

Testes de trackers em cinco estados

Execute cada estado numa sessão privada nova e mantenha o separador Network aberto. Estes cinco estados são o teste de aceitação com que o próprio módulo é verificado.

Antes do consentimento: com o banner ainda aberto, o separador Network não mostra pedidos de análise nem de marketing e não são gravados cookies de rastreio.
Apenas análise: conceda só a análise na vista granular. Os pedidos de análise arrancam e os pedidos e cookies de marketing continuam ausentes.
Apenas marketing: conceda só o marketing. As tags de marketing podem disparar enquanto o armazenamento de análise permanece denied.
Accept All: as categorias concedidas arrancam e o dataLayer contém um consent update com valores granted.
Reject All: a loja continua a funcionar, incluindo carrinho e checkout, e os trackers ficam em silêncio mesmo depois de recarregar a página.

O Meta Pixel e o TikTok Pixel não leem o Consent Mode, por isso o Consent Mode v2 por si só não os trava. Têm de ficar cobertos pelo autoblocking do módulo ou ser disparados por event gating apenas depois do consentimento de marketing.

Desativar, desinstalar, reinstalar

Desativar o módulo remove o script CookiePilot da loja. O domínio na sua conta CookiePilot fica intacto.

Desinstalar remove os segredos locais e os hooks da base de dados da loja. Não apaga o domínio remoto nem as provas de consentimento armazenadas.

Reinstalar o módulo e voltar a ligar o mesmo domínio funciona: o módulo liga-se de novo ao domínio existente em vez de criar um duplicado.

Resolução de problemas

O banner não aparece depois da instalação

Limpe a cache do PrestaShop em Parâmetros avançados, Desempenho, e purgue o CDN se usar um. HTML em cache continua a servir páginas geradas antes de o módulo ser ativado.

Dois banners ou um estado de consentimento contraditório

Remova qualquer snippet de consentimento colado à mão no tema, em ferramentas do alojamento e em contentores de tags. Só pode correr uma camada de consentimento, e o módulo já a injeta uma vez.

Os trackers disparam antes do banner

Um tema ou outro módulo com GA4, Meta ou TikTok escritos à mão carrega fora da camada de consentimento. Mova essas tags para trás do autoblocking do módulo ou para uma configuração de tags condicionada ao consentimento.

Configurações com Google Tag Manager

Mantenha o módulo como única fonte de consentimento. Condicione cada tag do GTM ao estado de consentimento correspondente ou dispare-a depois do consent update, e nunca cole um segundo loader CookiePilot no contentor.

Continuam a surgir pedidos Meta ou TikTok

Estes píxeis ignoram o Consent Mode. Confirme que estão cobertos pelo autoblocking ou por event gating; um píxel escrito à mão no tema continua a disparar até ser movido para trás do consentimento de marketing.

O módulo numa loja real

Instale o módulo e teste a sua loja

Descarregue o ZIP, ligue o seu domínio e percorra os cinco estados de trackers numa sessão limpa. Toda a configuração acontece no back office.