Guia de instalação do PrestaShop

Adicione o Velo
ao PrestaShop.

Instale o banner de cookies do Velo e o Google Consent Mode v2 no PrestaShop com uma linha no template de head do seu tema. A maioria das instalações leva poucos minutos quando você já tem acesso de administrador ao site. Se você usa Google Tag Manager, esse caminho também está nesta página.

Instruções e fontes das imagens revisadas em 3 de novembro de 2026.

Começar

OndeTema filho → head.tpl

PlanoPrestaShop 1.7, 8 ou 9

Entra no arDepois de limpar o cache

Tempo típicoCerca de cinco minutos

Cole uma linha
no head.tpl.

Adicione o trecho de código do seu site ao head global do site, depois publique e teste o resultado. Se as suas tags de medição já rodam pelo Google Tag Manager, use o caminho abaixo.

Já usa o Google Tag Manager? Vá por esse caminho ↓

Três passos · cerca de cinco minutos

01

Copie a linha

Copie o trecho de código de instalação completo deste site no seu painel do Velo. O exemplo abaixo mostra o formato; substitua your-site-id antes de usá-lo. Mantenha o endpoint da API fornecido pelo seu painel.

<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app.veloconsent.com" data-velo-site="your-site-id" async></script>
02
Edite o template de head do seu tema

Em um tema filho do seu tema ativo, copie templates/_partials/head.tpl do tema pai e cole o trecho de código completo do Velo logo depois do bloco head_charset, acima do bloco hook_header, onde os módulos adicionam as tags deles. Salve e depois limpe o cache em Parâmetros Avançados → Desempenho. Editar o tema pai também funciona, mas uma atualização do tema sobrescreve a alteração.
PrestaShop · template de head do tema
```
{* In your child theme: templates/_partials/head.tpl,
   copied from the parent theme *}
{block name='head_charset'}
  <meta charset="utf-8">
{/block}
{* Paste the complete Velo snippet from your dashboard here. *}

{* …the rest of the parent's head.tpl, unchanged… *}

{block name='hook_header'}
  {$HOOK_HEADER nofilter}
{/block}
```
Referência de configuração verificada · 3 de novembro de 2026
Referência de configuração conferida com a documentação da plataforma. Não é uma captura de tela do painel administrativo.
Documentação da plataforma ↗
03

Publique e confira o site no ar

Salve e publique a mudança seguindo os passos da plataforma acima e depois limpe qualquer cache do site ou da CDN. Abra a URL publicada em uma sessão nova do navegador. Confira o banner onde as suas regras de região o exigem, teste aceitar e recusar e verifique os padrões e as atualizações de consentimento antes de as suas tags de medição rodarem. Confirme que o site aparece como instalado no seu painel do Velo.

Captura da interface no ar · 23 de setembro de 2026
O banner real em veloconsent.com, capturado em 23 de setembro de 2026. O texto, o layout e as configurações regionais do seu banner podem ser diferentes.
Site do Velo no ar ↗Ver em tamanho real ↗

Um ponto de atenção

Se o banner não renderizar depois da edição, é quase sempre o cache: limpe em Parâmetros Avançados → Desempenho e recarregue forçado. Depois confira se o tema filho é o tema ativo e se o trecho de código está acima do bloco hook_header, onde os módulos adicionam as próprias tags.

Ainda comparando opções? Veja todas as plataformas compatíveis.

Recomendado se você já usa um contêiner

Ou adicione a tag
no Tag Manager.

Já tem um contêiner web do Google Tag Manager neste site? Adicione o Velo pela Community Template Gallery e configure por lá. Se você precisa instalar o contêiner primeiro, use a integração compatível da sua plataforma e confira na URL publicada.

01Adicione o template do Velo CMPTemplates→Tag Templates→New→Search Gallery
02Crie a tagTags→New→Velo CMP template
03Revise as opções avançadasAdvanced→url_passthrough→ads_data_redaction
04Dispare em Consent Initialization – All PagesTriggering→Consent Initialization – All Pages
05Ative a visão geral de consentimentoAdmin→Container Settings→Enable consent overview
06Faça o preview e publiquePreview→Submit→Publish

Velo CMP · configuração da tag

ID do site no Velo: Copie o ID exato do site no seu painel do Velo.
Tema do banner: Light ou Dark
Endpoint da API do Velo (opcional): Use o endpoint da API que aparece nas configurações de instalação do Velo.

Campos do template verificados · 23 de setembro de 2026

Nomes dos campos conferidos no template Velo CMP publicado. Use o ID do seu próprio site e o seu endpoint da API.

Template Velo CMP ↗

O guia completo do Tag Manager Seis passos, cerca de dez minutos, igual em qualquer plataforma.

Perguntas sobre o PrestaShop,
respondidas.

O que os times que instalam no PrestaShop perguntam primeiro.

Qual versão do PrestaShop isso cobre?

Os passos valem para o PrestaShop 1.7, 8 e 9 com o tema Classic, o Hummingbird ou um tema baseado em um deles, que mantêm o head da página em templates/_partials/head.tpl. Os temas do PrestaShop 1.6 mantêm o head em outro template, então lá o caminho pelo Tag Manager é o mais simples.

Minha loja já mostra um banner de cookies de um módulo.

Desative esse módulo em Módulos → Gerenciador de módulos, para o Velo ser a única camada de consentimento rodando. Dois banners confundem os visitantes, e só o Velo liga a decisão ao Consent Mode e ao registro de auditoria.

Por que o banner não aparece depois da edição?

Quase sempre o cache: limpe em Parâmetros Avançados → Desempenho e recarregue forçado. Se ainda assim não renderizar, confira se o tema filho é o tema ativo e se o head.tpl dele está em templates/_partials/head.tpl, o mesmo caminho do tema pai.

Isso deixa o site mais lento?

O trecho de código do painel carrega de forma assíncrona. Como com qualquer script, meça o efeito dele no seu site e confira a ordem das suas tags; o carregamento assíncrono, por si só, não garante que os padrões de consentimento rodem antes das outras tags.

Um assistente de IA pode fazer isso por mim?

Sim. Copie o prompt em Instalar com agentes, logo abaixo, no Claude, ChatGPT, Cursor ou no assistente que você já usa. Ele carrega os passos desta página, a ordem em que as tags precisam carregar e as verificações que o agente tem que rodar antes de dizer que terminou.

Ou entregue
para um agente.

Copie o prompt no Claude, ChatGPT, Cursor ou no assistente que você já usa. Ele carrega tudo o que está nesta página: os dois caminhos, a ordem em que as tags precisam carregar e as verificações que provam que deu certo.

O prompt

Cole este prompt no seu assistente e depois informe o ID do seu site e o trecho de instalação completo ou as configurações do GTM que estão no seu painel do Velo.

Prompt de instalação · PrestaShop

Instale o Velo no PrestaShop.

Guia atual: https://veloconsent.com/prestashop

Antes de editar, pegue no painel do Velo o ID do meu site e o trecho de código de instalação completo ou as configurações do GTM. Confirme qual ferramenta de consentimento e quais tags de medição já rodam no site.

Escolha um único caminho de instalação:
A. Se o site já usa Google Tag Manager, adicione o template Velo CMP (publicado por ampliodata) pela Community Template Gallery. Defina o ID do meu site, o tema e o endpoint da API conforme o painel. Revise as opções avançadas; as duas vêm desligadas por padrão. Use Consent Initialization – All Pages, depois use o Preview e verifique o consentimento antes de publicar. Passo a passo completo: https://veloconsent.com/google-tag-manager

B. Para instalação direta: Em um tema filho do seu tema ativo, copie templates/_partials/head.tpl do tema pai e cole o trecho de código completo do Velo logo depois do bloco head_charset, acima do bloco hook_header, onde os módulos adicionam as tags deles. Salve e depois limpe o cache em Parâmetros Avançados → Desempenho. Editar o tema pai também funciona, mas uma atualização do tema sobrescreve a alteração.

Preserve o código que não tem relação com esta instalação. Evite instalações duplicadas do Velo ou padrões de consentimento concorrentes. Não presuma que colocar o código no head ou carregá-lo de forma assíncrona, por si só, garante a ordem das tags.

Confira o site publicado em uma sessão nova. Verifique o banner conforme as regras de região configuradas, os padrões iniciais de consentimento, as atualizações ao aceitar/recusar e o evento velo_consent_update. Confira se as tags que não são do Google seguem as categorias atribuídas a elas. Teste uma segunda página e qualquer checkout separado. Confirme que os sinais chegam ao painel do Velo.

Informe o que mudou, onde mudou e o resultado de cada verificação. Descreva qualquer acesso que faltou ou verificação que você não conseguiu concluir.

Trabalhando com um agente que lê a web? Aponte ele para veloconsent.com/llms.txt e /install.md para o mesmo contexto em texto puro.

Do diário.

Google Consent Mode v2 no Velo: o que há de novo Consent Mode v2 ligado desde a instalação, banner nos requisitos do Google, análise de cada página com aviso por e-mail e suporte em primeiro lugar. 2 de novembro de 2026

Como configurar o Google Consent Mode v2 no Shopify Defina os padrões como denied acima do contêiner e então grave a escolha do visitante tanto no Google Consent Mode quanto na Customer Privacy API do Shopify, no mesmo clique. 2 de setembro de 2026

Google Consent Mode no Squarespace: configuração e limites O banner nativo do Squarespace bloqueia os cookies de análise, mas não envia sinais de Consent Mode. 16 de agosto de 2026

Todos os artigos