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. O módulo suporta PrestaShop 8.x e 9.x.

Requisitos e versões suportadas

  • O módulo suporta PrestaShop 8.x e 9.x.
  • 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

Descarregue o ZIP oficial de instalação do CookiePilot, guarde-o e carregue-o no PrestaShop sem o descompactar.

Descarregar o ZIP

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 loja usa PrestaShop 8.x ou 9.x 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, volte ao PrestaShop Back Office, reabra a configuração CookiePilot CMP e inicie sessão com a conta verificada se necessário.
  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 insere um script CookiePilot no head de cada página da loja e usa um hook inicial do módulo. Os scripts inseridos antes diretamente no tema ainda podem arrancar primeiro, por isso configure-os para serem bloqueados pelo autoblocking do CookiePilot ou para aguardarem consentimento no GTM.
  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.

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: depois de aceitar todos os consentimentos, as ferramentas de análise e marketing podem funcionar de acordo com a configuração da loja.
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 codificados diretamente pode carregar fora da camada de consentimento. Configure o bloqueio automático do CookiePilot para bloquear ou cobrir essas tags, ou configure-as no GTM para serem executadas apenas depois do consentimento necessário.

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.

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.