O que o parâmetro gcd significa e o que ele prova que o gcs não consegue

Todos os artigos

gcd é um parâmetro das requisições que as tags do Google enviam, e ele carrega o quadro completo do consentimento: os quatro sinais do Consent Mode em uma string, cada posição registrando qual era o padrão e para o que uma atualização o mudou. É isso que ele prova e o gcs não consegue. O gcs informa onde dois sinais terminaram. O gcd diz, para os quatro, se um padrão chegou a ser definido. O Google não o documenta, e essa é a outra metade deste post.

Por que existe um segundo parâmetro?

Se você já depurou uma configuração de consentimento pelo painel de rede, já leu o gcs. Ele é curto, é fácil e responde a uma pergunta: no instante em que este hit saiu da página, o armazenamento estava concedido? G100 para os dois negados, G111 para os dois concedidos, os estados mistos no meio, e G1-- para uma tag que disparou sem nenhum estado de consentimento associado. Usamos o tempo todo, e o método está descrito em como conferir se o seu banner está enviando o sinal do Consent Mode v2.

Ele tem dois limites, e eles são o motivo deste post. Cobre apenas ad_storage e analytics_storage, então os dois sinais introduzidos na versão dois, ambos listados na visão geral do Consent Mode do Google, simplesmente não estão nele. E, no par que cobre, informa um resultado sem histórico, então um sinal negado porque alguém escolheu negar se parece muito com um negado porque ninguém o configurou.

As duas falhas aparecem mais adiante como dados faltando, e só uma delas é decisão do visitante. É no gcd que essa distinção fica.

Como a string é montada

O valor abre com 11 e depois alterna um dígito separador com uma letra, uma vez por sinal, antes de um dígito final. As quatro letras, em ordem, são ad_storage, analytics_storage, ad_user_data e ad_personalization. As letras são a mensagem inteira.

Cada letra responde a duas perguntas ao mesmo tempo, e é essa a parte que compensa uma leitura cuidadosa. Ela registra se um padrão foi definido antes de a tag disparar e se uma atualização chegou depois. Assim, um caractere pode dizer que um sinal começou negado e foi concedido quando o visitante aceitou, ou que ele nunca fez parte da sua configuração de Consent Mode.

Lendo passo a passo

1. Capture uma requisição de uma tag do Google

   Abra o painel de rede, filtre pelo endpoint collect e carregue a página em uma sessão limpa. As requisições enviadas por uma tag atual do Google levam o gcd, e levam com ou sem Consent Mode configurado, então um carregamento de página comum geralmente basta para gerar um. Integrações mais antigas ou feitas à mão podem não enviá-lo, e essa ausência já é um achado por si só.

2. Divida a string nos separadores

   O valor começa com 11 e depois alterna um dígito separador com uma letra de sinal. As quatro letras, em ordem, são ad_storage, analytics_storage, ad_user_data e ad_personalization. Leia as letras; os dígitos são estrutura, não estado.

3. Traduza cada letra em um padrão e uma atualização

   l significa que o sinal nunca foi definido pelo Consent Mode. p é negado por padrão sem atualização; q é negado por padrão e continua negado depois de uma. t é concedido por padrão sem atualização; v é concedido por padrão e depois de uma atualização. r é negado por padrão e depois concedido; u é concedido por padrão e depois negado. m é negado por uma atualização sem padrão antes dela, e n é concedido por uma atualização sem padrão antes dela.

4. Leia as que não têm padrão como falha de instalação

   l, m e n dizem que algo estava faltando antes de a tag rodar. l significa que o sinal nunca foi configurado. m e n significam que chegou uma atualização para um sinal que não tinha padrão, que é a falha de ordem: a tag já estava livre para rodar antes de o consentimento ser expresso.

5. Confirme em uma superfície documentada antes de mudar qualquer coisa

   Leve a hipótese que a string deu para o Tag Assistant ou para a visão de consentimento do seu gerenciador de tags e confira lá. Essa é a superfície que o Google documenta, e é nela que você deve agir.

O que cada letra está realmente dizendo?

Agrupar as nove letras pelo que elas provam funciona melhor do que decorá-las. Três descrevem um sinal sem padrão antes de a tag rodar, e são essas que pedem ação. l é a primeira a procurar: o sinal nunca foi definido pelo Consent Mode, o que é uma falha diferente de alguém recusar alguma coisa, e é comum em instalações anteriores à versão dois que ainda enviam o par original. Um l na posição de ad_user_data ou ad_personalization geralmente encerra a investigação, porque não há nada quebrado no banner.

m e n significam que uma atualização chegou a um sinal que não tinha padrão, o que é a falha de ordem e não a de mapeamento: a tag estava livre para rodar antes de o consentimento ser expresso, e por que as tags disparam antes de o banner de cookies carregar mostra como impedir isso. As seis restantes descrevem um sinal que foi configurado e depois seguiu um caminho, e essas são leituras saudáveis mesmo quando a resposta é uma recusa.

O aviso que tem que acompanhá-lo

O Google não publica o gcd como contrato. É um parâmetro interno, a codificação dele pode mudar sem aviso e nenhuma versão desta decodificação tem garantia de sobreviver a um release de tag. Isso tem que estar aqui, não em uma nota de rodapé: uma decodificação sem data de validade transforma uma ajuda de depuração em uma falsa certeza.

Por isso a regra que seguimos é estreita. Use o gcd para formar uma hipótese dentro de uma única sessão, quando algo está faltando e você ainda não sabe por quê. Confirme em uma superfície que o Google documenta, como a visão geral de consentimento do Tag Manager, antes de mudar qualquer coisa, e nunca construa monitoramento em cima da string: um parser lendo um parâmetro não documentado não é um monitor, é uma pane esperando uma nota de versão que ninguém mandou.

Usado assim, ele justifica o seu lugar, por causa da única coisa que nenhuma superfície documentada entrega tão rápido: um único caractere, em uma requisição que você já tem aberta, que diz se um sinal foi recusado ou nunca foi conectado.

O Velo envia os quatro sinais a partir de um único mapeamento de categorias que você consegue ler em uma só tela, e o estado que o visitante escolheu é o estado que sai da página, o que torna uma string como esta chata de ler. Como isso é ligado está na página do produto.