Eventos de registro

Este guia mostra como registrar eventos em seu aplicativo.

Os eventos fornecem informações sobre o que está acontecendo no seu aplicativo, como ações do usuário, eventos do sistema ou erros.

O Analytics registra automaticamente alguns eventos para você; você não precisa adicionar nenhum código para recebê-los. Se seu aplicativo precisar coletar dados adicionais, você poderá registrar até 500 tipos diferentes de eventos do Analytics em seu aplicativo. Não há limite para o volume total de eventos registrados pelo seu aplicativo. Observe que os nomes dos eventos diferenciam maiúsculas de minúsculas e que registrar dois eventos cujos nomes diferem apenas em maiúsculas e minúsculas resulta em dois eventos distintos.

Antes de você começar

Certifique-se de ter configurado seu projeto e de poder acessar o Analytics conforme descrito em Primeiros passos com o Analytics .

Registrar eventos

Depois de configurar a instância firebase.analytics() , você poderá começar a registrar eventos com o método logEvent() . Se você já conhece o Google Analytics, esse método equivale a usar o comando event em gtag.js .

Para ajudar você a começar, o SDK do Analytics define vários eventos recomendados que são comuns entre diferentes tipos de aplicativos, incluindo aplicativos de varejo e comércio eletrônico, viagens e jogos. Para saber mais sobre esses eventos e quando usá-los, consulte Eventos recomendados .

Observação: para obter o máximo de detalhes nos relatórios, registre os eventos recomendados que fazem sentido para seu aplicativo e seus parâmetros prescritos. Isso também garante que você se beneficie dos recursos mais recentes do Google Analytics assim que estiverem disponíveis.

Você pode encontrar detalhes de implementação de vários eventos e seus parâmetros na referência de evento gtag.js.

O exemplo a seguir demonstra como registrar um evento select_content :

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});

Web namespaced API

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Além dos parâmetros prescritos, você pode adicionar os seguintes parâmetros a qualquer evento:

  • Parâmetros personalizados: os parâmetros personalizados podem ser usados ​​como dimensões ou métricas em relatórios do Google Analytics . Você pode usar dimensões personalizadas para dados de parâmetros de eventos não numéricos e métricas personalizadas para quaisquer dados de parâmetros melhor representados numericamente. Depois de registrar um parâmetro personalizado usando o SDK, registre a dimensão ou métrica para garantir que esses parâmetros personalizados apareçam nos relatórios do Analytics. Faça isso em: Analytics > Eventos > Gerenciar definições personalizadas > Criar dimensões personalizadas

    Parâmetros personalizados podem ser usados ​​em definições de público que podem ser aplicadas a todos os relatórios. Os parâmetros personalizados também serão incluídos nos dados exportados para o BigQuery se o seu aplicativo estiver vinculado a um projeto do BigQuery. Encontre exemplos de consultas e muito mais no Google Analytics 4 BigQuery Export .

  • parâmetro value : value é um parâmetro de propósito geral útil para acumular uma métrica principal pertencente a um evento. Os exemplos incluem receita, distância, tempo e pontos.

Se seu aplicativo tiver necessidades específicas não cobertas por um tipo de evento recomendado, você poderá registrar seus próprios eventos personalizados. Por exemplo, se você estiver desenvolvendo um jogo e quiser acompanhar quando um jogador completa uma meta específica, você poderá registrar um evento semelhante ao exemplo a seguir:

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web namespaced API

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

Ver eventos no painel

Você pode visualizar estatísticas agregadas sobre seus eventos nos painéis do Console do Firebase. Esses painéis são atualizados periodicamente ao longo do dia. Para testes imediatos, use a saída do logcat conforme descrito na seção anterior.

Você pode acessar esses dados no painel de eventos no console do Firebase. Este painel mostra os relatórios de eventos criados automaticamente para cada tipo distinto de evento registrado pelo seu aplicativo.