Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Eventos de registro

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este guia mostra como registrar eventos em seu aplicativo.

Os eventos fornecem informações sobre o que está acontecendo em 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 que seu aplicativo registra. Observe que os nomes de eventos diferenciam maiúsculas de minúsculas e que registrar dois eventos cujos nomes diferem apenas em maiúsculas e minúsculas resultará em dois eventos distintos.

Antes de você começar

Verifique se você configurou seu projeto e pode acessar o Analytics conforme descrito em Introdução ao Analytics .

Eventos de registro

Depois de configurar a instância do FirebaseApp , você pode começar a registrar eventos com o método logEvent() .

Para ajudar você a começar, o SDK do Google 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 .

Você pode encontrar detalhes de implementação na referência de constantes para Swift e Objective-C .

O exemplo a seguir demonstra como registrar um evento kFIRSelectContent recomendado:

Rápido

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objetivo-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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 nos 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 Google Analytics. Faça isso por meio de: 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 são incluídos nos dados exportados para o BigQuery se seu aplicativo estiver vinculado a um projeto do BigQuery. Encontre exemplos de consultas e muito mais no Google Analytics 4 BigQuery Export .

  • Parâmetro kFIRParameterValue : kFIRParameterValue é um parâmetro de uso geral que é útil para acumular uma métrica chave que pertence 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 conforme mostrado neste exemplo:

Rápido

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Objetivo-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Definir parâmetros de evento padrão

Você pode registrar parâmetros em eventos usando setDefaultEventParameters . Os parâmetros padrão são associados a todos os eventos futuros registrados.

Assim como com os parâmetros personalizados, registre os parâmetros de evento padrão para garantir que esses parâmetros personalizados apareçam nos relatórios do Analytics.

Rápido

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objetivo-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Se um parâmetro for especificado no método logEvent() , esse valor será usado em vez do padrão.

Para limpar um parâmetro padrão, chame o método setDefaultEventParameters com o parâmetro definido como nil .

Exibir eventos no console de depuração do Xcode

Você pode habilitar o log detalhado para monitorar o log de eventos pelo SDK para ajudar a verificar se os eventos estão sendo registrados corretamente. Isso inclui eventos registrados automaticamente e manualmente.

Você pode habilitar o log detalhado da seguinte maneira:

  1. No Xcode, selecione Produto > Esquema > Editar esquema...
  2. Selecione Executar no menu esquerdo.
  3. Selecione a guia Argumentos .
  4. Na seção Argumentos passados ​​na inicialização , adicione -FIRAnalyticsVerboseLoggingEnabled .

Na próxima vez que você executar seu aplicativo, seus eventos serão exibidos no console de depuração do Xcode, ajudando você a verificar imediatamente se os eventos estão sendo enviados.

Visualizar eventos no painel

Você pode ver 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 Eventos no console do Firebase. Este painel mostra os relatórios de eventos que são criados automaticamente para cada tipo distinto de evento registrado pelo seu aplicativo.