Como configurar o Google Consent Mode v2 na Shopify

Todos os artigos

Coloque os padrões do Consent Mode, definidos como denied, no theme.liquid acima do contêiner, e faça o seu banner escrever a escolha do visitante em dois lugares no mesmo clique: no Google Consent Mode e na Customer Privacy API da própria Shopify. A Shopify roda dois sistemas de consentimento, não um. Conecte só a metade do Google e os seus Custom Pixels continuam disparando seja qual for a escolha do visitante.

A Shopify tem dois sistemas de consentimento, e só um deles é do Google

A maioria dos guias sobre o tema explica como ativar um app de consentimento e colar um contêiner. A parte que decide se a configuração se sustenta é estrutural e específica da Shopify: o consentimento é aplicado em dois lugares separados que não sabem nada um do outro, a menos que você os conecte.

A Customer Privacy API da Shopify controla o que a plataforma controla: Custom Pixels e pixels de apps. Nada que você faça no Google Tag Manager chega até ela. Ela escuta uma coisa só, Shopify.customerPrivacy.setTrackingConsent(), e até que algo chame isso, mantém o estado que já tinha. A Shopify documenta o método na referência da Customer Privacy API.

O Google Consent Mode v2 controla as suas próprias tags: o contêiner no theme.liquid e tudo o que ele dispara. Ele escuta gtag('consent', ...) e não faz ideia de que a Customer Privacy API existe.

Então há dois formatos de falha. Conecte só o Consent Mode e as suas tags do GA4 e do Ads se comportam, enquanto os Custom Pixels e os pixels de apps continuam sem bloqueio. Conecte só o lado da Shopify e o seu próprio contêiner dispara sem controle. Um app de consentimento da App Store geralmente cuida dos dois, e por isso esse caminho é mais fácil; uma CMP colada no tema não cuida, a menos que você mesmo escreva o callback.

Acertar isso não é um detalhe. Todo visitante cuja escolha chega a apenas um dos dois sistemas é rastreado sem permissão ou some dos relatórios sem motivo. Quantos visitantes recusam na sua loja depende das suas regiões, do seu público e do design do seu banner, e é na taxa de consentimento da sua CMP ou nas configurações de privacidade do cliente da Shopify que você vê isso.

Como configurar o Consent Mode v2 na Shopify?

1. Decida qual banner é dono da decisão

   O banner próprio da Shopify, em Settings e depois Customer privacy, ou uma CMP. O banner da Shopify escreve na Customer Privacy API por você, mas não fala Consent Mode, então você ainda precisa conectá-lo ao seu contêiner. Uma CMP instalada como app da Shopify geralmente cobre os dois lados; uma colada no tema como script cobre só o lado do Google até você adicionar o callback. O passo seis é o que mostra quais metades a sua de fato cobre.

2. Defina padrões denied acima do contêiner

   Um comando default do Consent Mode que define ad_storage, analytics_storage, ad_user_data e ad_personalization como denied, colocado no theme.liquid antes do snippet do contêiner, não depois. É nessa ordem que toda a configuração se apoia: um padrão que chega depois que o contêiner já disparou uma tag não é um padrão, é uma correção que chegou tarde demais. Se você atende regiões fora do EEE, defina os padrões por região em vez de negar em todo lugar.

3. Mantenha o banner no tema, nunca num Custom Pixel

   Os Custom Pixels rodam dentro de um iframe em sandbox com origem opaca própria. Um banner não consegue renderizar na página a partir dali, e gravações de cookies feitas lá dentro não se comportam como gravações próprias (first party). O banner pertence ao theme.liquid, no contexto principal da página, acima do contêiner.

4. Escreva a escolha nos dois sistemas no mesmo clique

   Ao aceitar ou recusar, envie a atualização do Consent Mode e, no mesmo handler, chame Shopify.customerPrivacy.setTrackingConsent() com as categorias correspondentes. Se você pular essa metade, os Custom Pixels e os pixels de apps nunca ficam sabendo que o visitante disse não. Essa é a lacuna mais comum que encontramos em lojas Shopify que acham que já terminaram.

5. Reaja à escolha na mesma visualização de página

   A Shopify dispara um evento visitorConsentCollected quando o consentimento é registrado. Escute esse evento e aplique o estado em vez de esperar a próxima navegação, para que um visitante que aceita na página de coleção seja medido nessa mesma página, e não só a partir da seguinte.

6. Verifique na loja publicada, nos dois caminhos, e teste o checkout separadamente

   Não no preview. No caminho de recusa, a sua requisição do GA4 ainda deve sair, com um valor gcs indicando a recusa, em vez de não sair; os Custom Pixels devem estar ausentes, e nenhum cookie de publicidade deve ser gravado. No caminho de aceitação, tudo isso deve aparecer. Depois repita a verificação inteira dentro do checkout, que roda no próprio sandbox e pode se comportar de forma diferente da loja que você acabou de testar.

O argumento sobre a ordem, sem as especificidades da Shopify, está em por que as tags disparam antes de o banner de cookies carregar, e Consent Mode básico versus avançado mostra qual dos dois você acabou rodando mais rápido do que ler o seu próprio contêiner.

Três coisas que pegam as pessoas de surpresa na Shopify

Pendente não é aceito. Antes de o visitante escolher, a Customer Privacy API informa um estado pendente. Uma ponte que trata qualquer coisa que não seja um não explícito como sim vaza dados em toda primeira visualização de página. Trate pendente como recusado.

Visitantes recorrentes de antes de o banner entrar no ar podem nunca vê-lo. Numa loja em que expandimos um banner da Shopify para o conjunto completo de regiões europeias, os visitantes novos receberam corretamente o estado pendente e o banner, enquanto os visitantes recorrentes que tinham navegado antes de o banner existir continuaram tratados como tendo aceitado e nunca o viram. Esse é o comportamento observado numa loja, não uma regra documentada, então confirme na sua antes de ler uma taxa de aceitação: as primeiras semanas podem misturar dois públicos.

O checkout é um ambiente diferente. O checkout da Shopify roda os pixels dentro daquele iframe em sandbox, numa origem opaca em que gravar cookies gera erro. Uma configuração perfeita na loja ainda pode produzir sessões de checkout sem nenhum contexto de página. Isso é uma falha de medição, não de consentimento, mas aparece no momento em que os números se recusam a bater.

O que conferir quando os números ainda parecem errados

Diagnostique os dois sistemas separadamente, porque o sintoma indica o lado que falhou. Custom Pixels ainda disparando depois de uma recusa significa que nada escreveu na Customer Privacy API: passo quatro. O GA4 ficando em silêncio em vez de enviar pings com denied significa que os seus padrões negam sem o Consent Mode estar ativo: passo dois. Cookies antes de qualquer clique significam que algo carrega acima dos seus padrões, geralmente um script fixo no código e não uma tag do contêiner, o que é uma questão de categorização.

O Velo cuida das duas metades a partir de uma única decisão: o banner fica no tema, escreve no Consent Mode e na Customer Privacy API no mesmo clique e passa o mesmo estado para o contêiner, de modo que os dois sistemas não têm como discordar sobre o que o visitante disse.