Eventos

Neste artigo, damos orientações sobre como migrar eventos do Universal Analytics (UA) para o Google Analytics 4 (GA4).

Como os modelos de medição do UA e do GA4 são diferentes, é recomendável repensar a coleta de dados com relação ao modelo do GA4, em vez de transferir a estrutura de eventos do UA para o GA4.

Para saber mais sobre os eventos do GA4, leia o artigo Sobre os eventos.

Comparação de eventos do UA e do GA4

Universal Analytics

No Universal Analytics (UA), a medição é realizada com o envio de hits. A maioria dos tipos de hit é usada para medir interações específicas (por exemplo, pageview), mas o tipo event está disponível para medições personalizadas/gerais. Os dados enviados com um hit de event incluem Category, Action e Label.

Veja abaixo exemplos de eventos do Universal Analytics para bibliotecas analytics.js e gtag.js:

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics 4

No Google Analytics 4 (GA4), a medição é realizada com o envio de eventos. Existem eventos coletados automaticamente, predefinidos e recomendados para você enviar quando apropriado, e eventos personalizados que podem ser enviados quando os eventos automáticos ou recomendados não atendem ao seu caso de uso.

Veja a seguir um exemplo de evento personalizado no GA4:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

Mapeamento de um evento do UA para o GA4

Para migrar o evento do UA para o GA4, você precisa identificar se há um evento equivalente do GA4. Se quiser mapear um evento do UA para o GA4, use a seguinte abordagem em etapas:

1. Analise a lista de eventos coletados automaticamente. Se um evento do GA4 coletado de forma automática corresponder ao evento do UA, remova o evento do UA e use o coletado automaticamente.

2. Se não houver uma correspondência na etapa anterior, analise os eventos coletados pela medição otimizada. Se um evento de medição otimizada do GA4 corresponder aproximadamente à finalidade do evento do UA, não migre o evento do UA. Em vez disso, use a medição otimizada para enviá-lo. Confirme se a medição otimizada está configurada corretamente na sua propriedade do GA4 para coletar o evento.

3. Se não houver uma correspondência na etapa anterior, analise a lista de eventos recomendados. Se um evento recomendado do GA4 corresponder à finalidade do evento do UA, use o evento recomendado e defina todos os parâmetros aplicáveis ao enviá-lo.

4. Se não houver uma correspondência na etapa anterior, envie um evento personalizado.

Cenários e exemplos de migração

Eventos coletados automaticamente

Os eventos coletados de forma automática sempre são enviados e geralmente não podem ser desativados, a menos que sejam configuráveis pela medição otimizada. De modo geral, não é recomendável migrar eventos do UA que têm um evento coletado automaticamente equivalente.

Por exemplo, um evento do UA enviado para medir uma interação de download de arquivo provavelmente não precisará ser migrado para o GA4, já que o evento file_download no GA4 é coletado de forma automática.

Medição otimizada

De modo geral, não é necessário migrar os eventos do UA para o GA4 quando um evento equivalente do GA4 é coletado pela medição otimizada. Por exemplo, os seguintes eventos do UA provavelmente não precisariam ser migrados para o GA4 porque eles já são avaliados no GA4 com a medição otimizada:

• Um evento do UA para medir os cliques de saída equivale a um evento click no GA4.
• Um evento do UA para medir os downloads de arquivos equivale a um evento file_download no GA4.

Substituição da medição otimizada

Se um evento de medição otimizada for equivalente ao evento do UA, mas não capturar todos os dados necessários, você poderá enviá-lo manualmente com outros parâmetros personalizados. Para isso, é preciso configurar/desativar a medição otimizada do evento correspondente e enviar manualmente o evento do GA4.

Por exemplo, o evento file_download coletado pela medição otimizada corresponde ao evento do UA, mas não tem informações sobre o tamanho do arquivo. Para substituir o evento de medição otimizada e incluir detalhes sobre o tamanho do arquivo, faça o seguinte:

1. Desative a opção Downloads de arquivo na medição otimizada.
2. Quando apropriado, envie manualmente o evento file_download com parâmetros personalizados.
   • Como o evento coletado de forma automática é desativado pela medição otimizada, você precisará definir manualmente os parâmetros que seriam coletados com o evento (por exemplo: file_extension, file_name etc.).
3. Crie uma dimensão/métrica personalizada para ver os valores dos parâmetros personalizados nos relatórios.

O exemplo da gtag.js a seguir envia um evento file_download do GA4 com um parâmetro personalizado file_size.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

Evento recomendado

Se o seu evento do UA tiver um evento recomendado equivalente do GA4, migre o evento do UA para o recomendado.

O exemplo a seguir é um evento do UA da analytics.js para medir um login:

ga('send', 'event', 'login', 'google-sso');

O evento login do GA4 pode ser usado para migrar o evento do UA para o GA4. O equivalente à gtag.js do GA4 é o seguinte:

gtag('event', 'login', {
  method: 'google-sso'
});

Evento personalizado

Se o evento do UA não tiver a opção Coletado automaticamente, Medição otimizada ou Evento recomendado correspondente, migre o evento do UA para um evento personalizado e crie dimensões e métricas personalizadas conforme necessário.

O exemplo a seguir mostra um evento do UA da analytics.js que mede as mudanças nas opções de orientação da IU:

ga('send', 'event', 'orientation', 'layout', 'wide');

Não há um evento do GA4 predefinido para medir o evento do UA acima. O exemplo de gtag.js a seguir mostra como um evento personalizado é usado para medir a mesma interação no GA4:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

Para incluir ui_element e configuration nos seus relatórios, você precisará criar dimensões correspondentes com base nesses parâmetros de evento. Para saber mais, consulte o artigo Dimensões e métricas personalizadas.