Diário · Consent Mode

Como configurar o Google Consent Mode v2 na Shopify

2 de setembro de 20267 min de leituraPor Walter Masseroni Gonzalez, Leon Aves, Daragh McCarthy e Alana Rossi

Defina os padrões do Consent Mode como negado no theme.liquid acima do seu contêiner, e faça seu banner gravar cada escolha no Consent Mode e na Customer Privacy API da Shopify no mesmo clique. Se as suas tags do Google vêm só do app Google & YouTube, o banner da Shopify ou uma CMP conectada a essa API configura o Consent Mode por você.

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

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á duas formas de falhar. Ligue só o Consent Mode e suas tags do GA4 e do Ads se comportam, enquanto os pixels personalizados e os de apps seguem sem bloqueio. Ligue só o lado da Shopify e o seu próprio contêiner dispara sem controle.

Um clique no banner precisa escrever nos dois.

Shopify

Customer Privacy API

Controla os Custom Pixels e os pixels de apps, incluindo o pixel do checkout.

Quem escreve nele setTrackingConsent()

Google

Consent Mode v2

Controla o contêiner no theme.liquid e as tags do Google que ele dispara: GA4 e Google Ads.

Quem escreve nele gtag('consent', 'update', ...)

Nenhum dos sistemas lê o outro, e nenhum deles avisa que o outro nunca foi informado.

Os dois sistemas de consentimento que uma loja Shopify roda. A maioria das configurações conecta um deles e parece pronta, porque nada em nenhum dos lados avisa que o outro nunca ficou sabendo da escolha do visitante.

As tags do Google do app Google & YouTube precisam de alguma coisa disso?

Quase nada. O próprio guia de configuração do Consent Mode do Google diz que, assim que o banner de cookies da Shopify está ativo, o Consent Mode é ativado automaticamente, e que o app Google & YouTube deve funcionar automaticamente quando a sua CMP se integra com a Customer Privacy API. Nesse caminho, suas tags do Google respondem a um único sistema de consentimento, e ele é o da Shopify.

O resto deste guia é para o outro caminho: tags do GA4 ou do Google Ads num contêiner do Google Tag Manager que você colocou no tema, ou um contêiner carregado como pixel personalizado. A ajuda de privacidade do cliente da Shopify diz que um pixel web personalizado precisa de um trecho de código adicionado à mão para ativar o Consent Mode v2. Uma loja pode usar os dois caminhos ao mesmo tempo, por exemplo o app para as conversões do Ads e um contêiner para o GA4, e aí cada tag segue um sistema diferente.

  • Só o app Google & YouTube: ative o banner da Shopify ou uma CMP que grave na Customer Privacy API, depois verifique (passo seis).
  • Seu próprio contêiner, no tema ou num pixel personalizado: siga os seis passos.
  • Os dois: siga os seis passos e confira se as tags do app e as do contêiner informam o mesmo estado.
  1. Decida qual banner é dono da decisão

    O próprio banner da Shopify, em Configurações e depois Privacidade do cliente, ou uma CMP. O banner da Shopify grava na Customer Privacy API por você, o que cobre as tags do app Google & YouTube, mas a Shopify não documenta nenhuma atualização do Consent Mode para um contêiner que você adicionou ao tema, então você ainda precisa fazer essa ponte com esse contêiner. Uma CMP instalada como app da Shopify costuma cobrir os dois lados; uma colada no tema como script só cobre o lado do Google até você adicionar o callback. É o passo seis que mostra quais metades a sua cobre de fato.

  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 pixels personalizados e os de apps nunca ficam sabendo que o visitante disse não. É uma falha que continuamos encontrando 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 na prévia. No caminho da recusa, sua requisição do GA4 ainda deve sair com um valor gcs mostrando a recusa em vez de não sair, os pixels personalizados devem estar ausentes e nenhum cookie de publicidade deve ser gravado. No caminho da aceitação, tudo deve aparecer. O Tag Assistant mostra o estado de consentimento que cada tag do Google leu. Depois repita a verificação inteira dentro do checkout, que roda no próprio sandbox e pode se comportar de outro jeito que a 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. Para ver qual dos dois você acabou rodando, Consent Mode básico versus avançado é mais rápido do que ler o seu próprio contêiner.

O que pega 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.

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.

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 e escreve no Consent Mode e na Customer Privacy API no mesmo clique. Ele passa o mesmo estado para o contêiner, de modo que os dois sistemas trabalham com o mesmo registro do que o visitante escolheu.

Perguntas frequentes

Como configurar o Google Consent Mode v2 na Shopify?

Se as suas tags do Google vêm do app Google & YouTube, o banner da Shopify ou uma CMP conectada à Customer Privacy API configura o Consent Mode por você. Para o seu próprio contêiner, defina os padrões do Consent Mode como negado no theme.liquid acima dele, e carregue seu banner no tema, não num pixel personalizado. No clique do visitante, envie a atualização do Consent Mode e uma chamada ao setTrackingConsent da Shopify. A Shopify roda dois sistemas de consentimento: a Customer Privacy API controla os pixels personalizados e os de apps, e o Consent Mode controla as tags do seu contêiner. Gravar só em um deixa o outro disparando com o estado que já tinha. Depois verifique na loja ao vivo pelo caminho da aceitação e pelo da recusa, e confira o checkout separadamente, porque o checkout roda no próprio sandbox.

O banner de cookies próprio da Shopify funciona com o Google Consent Mode v2?

Para as tags instaladas pelo app Google & YouTube, sim: a ajuda do Google diz que o Consent Mode é ativado automaticamente assim que o banner da Shopify está ativo. Para as tags de um contêiner que você mesmo adicionou ao tema, não. O banner da Shopify grava a escolha do visitante na Customer Privacy API, que controla os pixels personalizados e os pixels de apps, e a Shopify não documenta nenhuma atualização do Consent Mode para o seu próprio contêiner. Você ainda precisa de uma ponte que escute a decisão de consentimento e envie a atualização de consentimento do gtag, ou de um app de consentimento que cubra as duas metades por você.

Por que os meus Custom Pixels da Shopify ainda disparam depois que o visitante recusa os cookies?

Porque os Custom Pixels são controlados pela Customer Privacy API da Shopify, não pelo Google Consent Mode, e nada escreveu uma recusa nela. O Consent Mode não alcança a camada da plataforma. O que quer que colete a escolha precisa chamar o setTrackingConsent com as categorias correspondentes no mesmo clique que envia a atualização do Consent Mode. Até isso acontecer, a plataforma mantém o estado que tinha, e pendente não é uma recusa.

Por que o banner de cookies não aparece para alguns visitantes recorrentes na Shopify?

Numa loja, expandimos um banner da Shopify para o conjunto completo de regiões europeias. Os visitantes que tinham navegado antes de o banner existir continuaram tratados como tendo aceitado e nunca o viram, enquanto os visitantes novos receberam corretamente o estado pendente e o banner. Esse é o comportamento observado numa loja, não uma regra documentada, então confirme na sua. Onde isso acontece, uma taxa de aceitação medida nas primeiras semanas depois do lançamento está misturando dois públicos.

Continue lendo


Comece com uma análise

Veja o que sua página inicial já carrega antes de instalar qualquer coisa. O scanner gratuito lê a página e o seu contêiner público do Tag Manager.


Uma primeira passada, não um veredito. Quatro verificações na sua página inicial, e abrimos o seu contêiner.
V
Análise gratuitaSem precisar de conta

Grátis para um site e 1.500 sessões por mês. Pro a partir de €7 por mês, mais IVA, para sites ilimitados.

Instalações passo a passo para WordPress, Shopify, Webflow, Wix e mais.

Grátis para um site

Banner, análise e registros de consentimento para um site, grátis. Pro a partir de €7 por mês, mais IVA, para sites ilimitados.