Controlar os parâmetros do evento disponíveis para as tags com as transformações

O objetivo deste documento é orientar usuários de inclusão de tags no servidor que precisam controlar quais parâmetros foram expostos para as tags.

Um contêiner do lado do servidor tem um client que aceita as solicitações HTTP que chegam. A informação na solicitação HTTP é convertida em um objeto event data. Suas tags do lado do servidor lê o objeto "event data".

O que são as transformações?

As transformações permitem incluir, excluir ou modificar a saída dos parâmetros de evento do seu cliente antes de serem expostas para as tags. Com as transformações, você protege informações sensíveis e tem um controle preciso sobre quais parâmetros do evento ficam disponíveis para processamento adicional.

As transformações permitem a você criar regras para:

• Permitir o compartilhamento apenas de parâmetros de evento explicitamente definidos com as tags.
• Aumentar os parâmetros ao incluir regras para editar ou adicionar parâmetros do evento.
• Editar informações de entrada excluindo parâmetros de evento das tags.

Você pode aplicar uma transformação a todas as suas tags, a tipos de tags ou a um conjunto selecionado individualmente. Além disso, é possível aplicar um conjunto de condições que foram atendidas antes da execução da transformação.

As variáveis são avaliadas sempre que uma transformação é executada. Dependendo do que suas transformações fazem, as variáveis podem levar a diferentes valores.

Permitir que as tags usem os parâmetros do evento

Com a transformação Permitir parâmetros, você consegue especificar os parâmetros que gostaria de expor para suas tags. Os parâmetros do evento que não foram explicitamente definidos serão descartados.

Cuidado: a transformação Permitir parâmetros remove todos os parâmetros de evento que não foram explicitamente especificados, até mesmo os valores exigidos pelas tags do Google. Antes de criar essa transformação, investigue quais parâmetros de evento suas tags usam e inclua todos os parâmetros necessários. Caso contrário, sua medição pode ser prejudicada. Consulte a referência event data e os eventos measurement protocol para mais informações.

Para que as tags usem determinados parâmetros de evento:

1. No seu espaço de trabalho, abra o menu Transformações.
2. Crie uma Nova regra de transformação.
3. Clique em Configuração da transformação e selecione Permitir parâmetros.
4. Adicione os parâmetros do evento que as tags usam. Confira todos os parâmetros do evento comuns.
5. Opcional: a opção Condições de correspondência permite que você defina regras para ativar a transformação. Por padrão, as regras de transformação sempre se aplicam.
6. Em Tags afetadas, escolha os tipos de tags ou as tags individuais que respondem a essa regra de transformação. Por padrão, a transformação se aplica a todas as tags.
7. Dê um nome e salve a regra de transformação.

Exemplo: registre informações selecionadas para sua tabela do BigQuery

Assumir o controle sobre os parâmetros que registrou permite a você:

• Garantir que informações sensíveis não sejam registradas no seu repositório de dados interno.
• Evitar o registro excessivo para economizar espaço de armazenamento e custos do Cloud.
• Armazenar métricas relevantes para monitoramento e geração de relatórios.

Quero saber como fazer isso.

Para permitir que apenas determinados parâmetros sejam registrados:

1. Crie uma Nova regra de transformação.
2. Clique em Configuração da transformação e selecione Permitir parâmetros.
3. Em Parâmetros a serem permitidos, adicione os parâmetros necessários, por exemplo, event_name, page_hostname, page_path, client_id etc.
4. Em Tags afetadas, selecione a tag que envia dados para seu data warehouse. Para o BigQuery, você pode usar addEventCallback e BigQuery APIs em uma tag personalizada ou encontrar opções prontas na Galeria de modelos da comunidade para monitorar o contêiner do servidor.
5. Dê um nome e salve a transformação. Vamos ter algo parecido com isto:

Aumentar parâmetros do evento

A transformação Aumentar evento permite que você modifique os valores dos parâmetros de evento ou adicione novos parâmetros a serem disponibilizados para as tags.

Cuidado: as tags não funcionam como esperado quando os parâmetros usados são modificados. Verifique em quais parâmetros suas tags se baseiam antes de aumentar os parâmetros.

Para modificar ou adicionar determinados parâmetros de evento:

1. No seu espaço de trabalho, abra o menu Transformações.
2. Crie uma Nova regra de transformação.
3. Clique em "Configuração da transformação" e selecione Aumentar evento.

4. Em Parâmetros a serem aumentados:

   • Para modificar parâmetros do evento existentes, insira o parâmetro que você quer modificar em Nome e adicione um novo Valor. Confira todos os parâmetros do evento comuns.

   • Para adicionar um novo valor de objeto de dados de eventos, insira um Nome e Variável de sua escolha.

5. Opcional: a opção Condições de correspondência permite que você defina regras para ativar a transformação. Por padrão, as regras de transformação sempre se aplicam.

6. Em Tags afetadas, escolha os tipos de tags ou as tags individuais que respondem a essa regra de transformação. Por padrão, a transformação se aplica a todas as tags.

7. Dê um nome e salve a regra de transformação.

Exemplo: configure os lances com base no valor para eventos de compra

A estratégia lances com base no valor ajuda você a melhorar a performance da campanha otimizando seu gasto com publicidade para segmentar usuários de maior valor para a empresa. Quando você configurar os lances com base no valor, o Google Ads vai definir os lances mais valiosos para você com base no seu valor de conversão. A transformação Aumentar evento é útil para configurar os lances com base no valor do lado do servidor.

Quero saber como fazer isso.

As instruções a seguir são válidas apenas se a tag de acompanhamento de conversões do Google Ads não especifica um valor de conversão.

Para configurar os lances com base no valor:

1. Crie uma Nova regra de transformação.
2. Clique em Configuração da transformação e selecione Aumentar evento.
3. Em Parâmetros a serem aumentados, adicione uma nova linha. Configure uma variável para carregar o valor monetário do seu item na transformação:
   1. No parâmetro Name, insira o nome do valor que você quer ajustar, por exemplo, value. Substitua todos os campos value, já que eles representam o valor monetário de um evento.
   2. No parâmetro Value, configure uma variável que recupere os preços do seu banco de dados. Por exemplo, se você armazena dados do produto no Firestore, adicione uma variável Pesquisa do Firestore.
4. Em Condições de correspondência, defina que essa transformação deve se aplicar apenas a determinados eventos. Para aplicar lances com base no valor só para eventos de compra, defina: {{Event Name}} é igual a purchase.
5. Em Tags afetadas, adicione todas as tags de acompanhamento de conversões do Google Ads a que essa transformação deve se aplicar.
6. Dê um nome e salve sua tag. Vamos ter algo parecido com isto:

Excluir os parâmetros de evento das tags

A transformação Excluir parâmetros é útil para remover parâmetros do evento específicos das suas tags.

Cuidado: as tags não funcionam como esperado quando os parâmetros necessários são excluídos. Verifique em quais parâmetros suas tags se baseiam antes de transformar os parâmetros.

Para excluir determinados parâmetros de evento:

1. No seu espaço de trabalho, abra o menu Transformações.
2. Crie uma Nova regra de transformação.
3. Clique em "Configuração da transformação" e selecione Excluir parâmetros.
4. Adicione os parâmetros do evento que as tags não podem usar. Confira todos os parâmetros do evento comuns.
5. Opcional: a opção Condições de correspondência permite que você defina regras para ativar a transformação. Por padrão, as regras de transformação sempre se aplicam.
6. Em Tags afetadas, escolha os tipos de tags ou as tags individuais que respondem a essa regra de transformação. Por padrão, a transformação se aplica a todas as tags.
7. Dê um nome e salve a regra de transformação.

Exemplo: exclua dimensões personalizadas do GA4 com base no consentimento do usuário

A transformação Excluir parâmetros permite que você controle quais dados próprios são enviados ao Google. Por exemplo, quando um usuário nega cookies do analytics_storage, recomendamos selecionar dimensões personalizadas.

Quero saber como fazer isso.

Para remover uma dimensão personalizada:

1. Crie uma Nova regra de transformação.
2. Clique em Configuração da transformação e selecione Excluir parâmetros.
3. Em Parâmetros a serem excluídos, adicione uma nova linha e defina as dimensões personalizadas que você quer excluir, por exemplo, payment_type e payment_status.
4. Em Condições de correspondência, defina que a transformação deve se aplicar apenas quando o usuário rejeita os cookies do analytics_storage.
   Forme as condições a seguir:
   • {{gcs}} é igual a G100
   • {{gcs}} é igual a G110
5. Opcional: em Tags afetadas, adicione todas as tags a que esta transformação deve se aplicar.
6. Dê um nome e salve sua tag. Vamos ter algo parecido com isto:

Verificar se as suas regras de transformação foram aplicadas

Você pode conferir suas regras de transformação ao visualizar uma prévia do seu espaço de trabalho:

1. Abra seu site.

2. No seu contêiner do servidor do Gerenciador de tags do Google, selecione Visualizar.

   O Assistente de tags começa e carrega seu contêiner do servidor.

3. Se quiser conferir todas as tags e ações disparadas para um evento, selecione um nome de evento na lista à esquerda.

Verificar uma transformação que foi executada:

1. No evento que você quer verificar, abra a guia Tags.

2. Selecione uma tag disparada para mostrar as propriedades da tag, solicitações HTTP de saída, acionadores de disparo e transformações.

   Observação: as transformações apenas afetam tags que foram disparadas. Uma transformação poderá fazer com que sua tag não seja disparada se modificar ou remover campos do parâmetro do evento exigidos.

3. A visão geral Detalhes da tag mostra quais transformações foram executadas para uma tag e em que ordem. A ordem padrão é:

   1. Permitir parâmetros
   2. Aumentar parâmetros
   3. Excluir parâmetros
   Dica: você pode mudar a ordem padrão atribuindo um valor de prioridade para uma transformação. Quanto maior for o valor, mais alta será a prioridade.

   

4. Clique em uma transformação para conferir os detalhes dela. Os parâmetros do evento fornecidos para a tag são exibidos na seção Dados de eventos.

   

5. Ao clicar na caixa Dados de eventos, você pode conferir o estado dos parâmetros do evento depois de todas as transformações executadas. Para consultar os parâmetros do evento originais e transformados, abra Mostrar original.