Eventos

A finalidade das tags é permitir que você prepare suas páginas da Web e aplicativos para dispositivos móveis para enviar dados quando ocorrer algum tipo de evento. Esses dados podem incluir detalhes sobre o tipo de evento e parâmetros que descrevem as informações do evento.

O que é um evento?

É quando um usuário interage com um componente do seu site. Esses eventos podem incluir as seguintes ações, entre outras:

• Carregamentos de página da Web
• Cliques em links
• Envios de formulário
• Reproduções do vídeo
• Compras
• Inscrições
• Instalações de apps

O que é um parâmetro?

Os parâmetros são dados associados a um evento. Exemplos de parâmetros incluem:

• Valor do item
• Códigos de cupom
• Método de login
• ID da transação
• Moeda

Os eventos e parâmetros dizem muito sobre as preferências do cliente e ajudam a responder perguntas como: quais páginas do produto têm mais visualizações? Quais botões recebem cliques com mais frequência? Quais campanhas levam a compras ou assinaturas?

Comando event

O comando event (usado com a tag do Google) envia dados de eventos para produtos de medição e publicidade do Google. O protótipo de um comando event é o seguinte:

gtag('event', '<type>', {<parameters>});

<type> é o tipo de evento, como um evento de conversão do Google Ads ou um nome de evento do Google Analytics 4. <parameters> é um objeto de pares de nome/valor que contém dados que descrevem o evento.

Eventos no Gerenciador de tags

Os eventos no Gerenciador de tags são configurados com base no tipo de tag que está em uso. Exemplo:

• Os eventos de conversão para o Google Ads são enviados com a tag de acompanhamento de conversões do Google Ads.
• Os eventos no Google Analytics 4 são configurados pela tag Google Analytics: evento do GA4.
• Os eventos para tags do Universal Analytics são configurados na tag Google Analytics: Universal Analytics usando a configuração Tipo de acompanhamento.
• Os eventos do Floodlight são configurados com as tags Contador do Floodlight ou Vendas do Floodlight.

O Gerenciador de tags usa acionadores para especificar quais eventos acompanhar e detectar quando eles ocorrerem na sua página da Web ou app para dispositivos móveis. Quando o evento ocorre, a tag é disparada e envia os dados para o produto especificado.

Conversões do Google Ads

Os eventos de conversão do Google Ads medem a atividade depois que um usuário interage com um anúncio. Essas conversões podem representar eventos que resultam em ações como novas assinaturas, compras ou downloads de apps. Antes de começar a usar essa tag, recomendamos que você conheça melhor o recurso na Central de Ajuda do Google Ads.

Para configurar suas tags de conversão do Google Ads, você precisa inserir o ID e o rótulo da conversão. Também é possível adicionar o valor da conversão, o código da moeda e/ou ID da transação.

gtag.js

Para implementações da tag do Google, os eventos são enviados com gtag('event', 'conversion'...). Exemplo:

  gtag('event', 'conversion', {
    'send_to': 'AW-CONVERSION_ID/CONVERSION_LABEL',
    'value': 1.0,
    'currency': 'USD',
    'transaction_id': '12345',
  });

Atenção: para evitar conversões duplicadas nos relatórios, adicione o transaction_id à sua tag.

Gerenciador de tags

1. No Gerenciador de tags, crie uma nova tag do Google Ads. Na tela inicial, selecione Nova tag > Configuração da tag > Acompanhamento de conversões do Google Ads.
2. Faça login na sua conta do Google Ads para reunir os valores necessários e terminar de configurar a tag:
   • Na sua conta do Google Ads, clique no menu Ferramentas e configurações ().
   • Selecione a opção Medição: conversões, que abre a tabela Ações de conversão.
   • Selecione o nome da conversão que você quer usar na coluna Ação de conversão.
   • Abra a guia "Configuração da tag" para ver os detalhes.
   • Selecione Usar o Gerenciador de tags do Google.
   • Copie o ID de conversão e o Rótulo de conversão.

3. No Gerenciador de tags, informe os valores obrigatórios de ID de conversão e rótulo de conversão, fornecidos na etapa 2, nos respectivos campos. Também é possível adicionar o valor da conversão, o ID da transação e o código da moeda. Use variáveis do Gerenciador de tags para definir esses valores de campo sempre que aplicável. Por exemplo, uma variável do ID da transação é usada na maioria dos casos.

   Observação: no caso do ID da transação, você precisa configurar seu app ou site para gerar esse ID, adicionar o valor dele à camada de dados e criar uma variável do Gerenciador de tags para recuperar esse valor.

4. Escolha um ou mais acionadores na seção "Acionamento" para especificar quando a tag será disparada.

5. Clique em "Salvar" para concluir a configuração da tag.

6. Importante: para ter a melhor compatibilidade possível com o navegador da Web, o Vinculador de conversões precisa estar ativado.

7. Veja a prévia com as mudanças e publique quando estiver tudo pronto.

Atenção: para evitar conversões duplicadas nos relatórios, adicione o ID da transação do seu app ou site como o valor de uma variável da camada de dados.

Saiba mais sobre como configurar as conversões do Google Ads.

Eventos do Google Analytics 4

Nas propriedades do Google Analytics 4, todas as ações mensuráveis do usuário são consideradas um evento. Eles podem ser carregamentos de página, cliques em links, preenchimentos de formulário, adição de itens a um carrinho de compras, finalização de compras, rolagens de página, exibições de vídeos, instalações de apps etc. Os eventos do Google Analytics 4 têm suporte para propriedades do usuário e parâmetros personalizados. Isso flexibiliza a medição de atividades no GA4.

Há quatro tipos principais de evento representados na plataforma de tags do Google. Eles variam entre diferentes produtos, mas geralmente podem ser categorizados da seguinte forma:

• Os eventos coletados automaticamente são aqueles enviados pelas tags gtag.js ou do Gerenciador de tags sem outra instrumentação da sua parte. Exemplos comuns de eventos coletados automaticamente incluem ad_click, page_view e video_progress. Saiba mais.

• Os eventos de medição otimizada são aqueles enviados pela gtag.js ou pelo Gerenciador de tags quando você ativa os eventos no Google Analytics. Exemplos comuns de eventos de medição otimizada incluem scroll, click e file_download. Saiba mais.

• Os eventos recomendados são usados em cenários de medição comuns que exigem um contexto mais detalhado para serem considerados. Exemplos comuns de eventos recomendados: login, purchase e search. Como exigem mais contexto, eles não são enviados automaticamente. Saiba mais.

• Os eventos personalizados são aqueles que você define. Esses eventos não são coletados ou recomendados automaticamente. Na prática, use os eventos recomendados ou os coletados automaticamente sempre que possível, e os tipos personalizados só quando os outros dois não atenderem aos seus requisitos. Saiba mais.

Para saber como configurar um evento da gtag.js ou do Gerenciador de tags do Google, consulte Configurar eventos.

Eventos do Universal Analytics

Os eventos do Universal Analytics se baseiam no modelo de evento/categoria/rótulo/valor legado.

gtag.js

Use o comando gtag('event') com a seguinte sintaxe:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});

Veja a seguir um evento com uma ação 'Downloads', uma categoria 'MP3' e um rótulo "Debussy - Clair de lune":

gtag('event', 'Downloads', {
  'event_category' : 'MP3',
  'event_label' : 'Debussy - Clair de lune'
});

Se <category> ou <label> forem omitidos, eles serão definidos como os valores padrão de (not set).

Gerenciador de tags

Para enviar um evento do Universal Analytics no Gerenciador de tags do Google, você precisa de dois componentes:

1. Uma tag Google Analytics: Universal Analytics
2. Um acionador que faz com que a tag seja disparada.

Para saber mais, leia a documentação da Central de Ajuda sobre a tag do Universal Analytics.

As informações do evento do Universal Analytics são estruturadas da seguinte maneira:

Nome	Tipo	Valor padrão	Descrição
<action>	string		O valor que aparece como a ação do evento nos relatórios de eventos do Google Analytics.
<category>	string	"(not set)"	A categoria do evento.
<label>	string	"(not set)"	O rótulo do evento.
<value>	number		Um número inteiro não negativo que aparece como o valor do evento.

Leia a anatomia dos parâmetros de evento do Google Analytics para mais informações sobre como a estrutura dos eventos é interpretada pelo Google Analytics.

Atividades do Floodlight

As "atividades do Floodlight" são conversões que correspondem a eventos específicos que você quer avaliar, como a finalização de uma compra ou a visita a uma página da Web. Uma conversão é uma ação realizada por um usuário após ver um dos seus anúncios. Saiba mais.

gtag.js

As atividades do Floodlight são enviadas da tag do Google usando gtag('event','conversion'). Para ter a melhor performance, insira esse código depois de definir a função gtag(), de preferência na seção <head>.

Os campos de dados são enviados como uma string de parâmetros na propriedade send_to. Os campos são diferentes dependendo do tipo de tag, do método de contagem e de outros dados transmitidos para a tag.

Confira um exemplo de uma atividade de conversão do Floodlight:

  gtag('event', 'conversion', {
    'allow_custom_scripts': true,
    'u1': '[variable]', // custom Floodlight variable
    'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
  });

Saiba mais sobre como usar a tag do Google com as atividades do Floodlight.

Observação: as variáveis personalizadas do Floodlight usam chaves u<N> (u1, u2 etc.) e podem receber qualquer valor que você escolher transmitir para elas. Saiba mais.

Gerenciador de tags

O Gerenciador de tags do Google pode ser usado para configurar as atividades do Floodlight. Para mais informações, leia a documentação da Central de Ajuda.