Ir para o console

Registrar eventos

Os eventos apresentam insights sobre o que está acontecendo em seu app, como ações do usuário, eventos do sistema ou erros.

O Google Analytics para Firebase registra alguns eventos para você automaticamente, sem precisar de código adicional para o recebimento. Caso seu app precise coletar dados adicionais, você pode registrar até 500 tipos diferentes de eventos do Analytics nele. Não há limite do volume total de eventos que seu app registra. Como os nomes de eventos diferenciam letras maiúsculas e minúsculas, registrar dois eventos com nomes que diferem apenas no uso de caixa baixa/alta resultará na criação de dois eventos distintos.

Antes de começar

Antes de usar o Google Analytics para Firebase, você precisa:

  • registrar seu projeto do Unity e configurá-lo para usar o Firebase.

    • Se o projeto do Unity já usa o Firebase, ele já está registrado e configurado para o Firebase.

    • Se você não tiver um projeto do Unity, poderá fazer o download de um aplicativo de amostra.

  • adicionar o SDK para Unity do Firebase (especificamente, FirebaseAnalytics.unitypackage) ao seu projeto do Unity.

A adição do Firebase ao seu projeto do Unity envolve tarefas no Console do Firebase e no projeto do Unity aberto (por exemplo, você faz o download dos arquivos de configuração do Firebase no Console e os move para o projeto do Unity).

Registrar eventos

Depois de inicializar o módulo Firebase.Analytics.FirebaseAnalytics, você pode usá-lo para registrar eventos com o método LogEvent().

Para ajudar você a começar, o SDK do Analytics define vários eventos sugeridos comuns entre tipos diferentes de apps, como os de varejo, comércio eletrônico, viagem e jogos. Para saber mais sobre esses eventos e quando usá-los, leia os artigos sobre Eventos e propriedades na Central de Ajuda do Firebase.

O detalhes de implementação dos tipos de eventos sugeridos podem ser encontrados nos seguintes locais:

  • Eventos sugeridos: veja a lista de constantes de Event.
  • Parâmetros prescritos: veja a lista de constantes de Parameters.

Veja no exemplo a seguir como registrar um evento SELECT_CONTENT sugerido:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter[] {
      new Firebase.Analytics.Parameter(
        Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
      new Firebase.Analytics.Parameter(
        Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
      new Firebase.Analytics.Parameter(
        Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
      new Firebase.Analytics.Parameter(
        "favorite_food", mFavoriteFood),
      new Firebase.Analytics.Parameter(
        "user_id", mUserId),
  }
);

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

  • Parâmetros personalizados: não são representados diretamente no seu relatório do Analytics, mas podem ser usados como filtros nas definições de Público que podem ser aplicadas a todos os relatórios. Os parâmetros personalizados também estão incluídos nos dados exportados para o BigQuery caso seu app seja vinculado a um projeto do BigQuery.

  • Parâmetro VALUE: VALUE é um parâmetro de uso geral, útil para coletar uma métrica principal pertencente a um evento do Analytics. Os exemplos incluem receita, distância, tempo e pontos.

Caso seu aplicativo tenha necessidades específicas não cobertas por um tipo de evento do Analytics, registre seus próprios eventos personalizados do Analytics, conforme mostrado neste exemplo:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Visualizar eventos na saída de registro

No Android

Você pode ativar um registro mais longo no registro de depuração do Android Studio para ajudar a verificar se os eventos estão sendo registrados adequadamente pelo SDK. Isso inclui os eventos registrados manual e automaticamente.

Você pode ativar o registro mais longo com uma série de comandos adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Esse comando exibe os eventos no logcat do Android Studio, ajudando você a verificar imediatamente se os eventos estão sendo enviados.

No iOS

Os eventos são registrados no console e podem ser visualizados ao executar o aplicativo pelo XCode.

Visualizar eventos do Analytics no painel

É possível ver estatísticas agregadas sobre os seus eventos do Analytics nos painéis do Console do Firebase. Eles são atualizados periodicamente ao longo do dia. Para fazer testes imediatos, use a saída do logcat conforme descrito na seção anterior.

Para acessar esses dados no Console do Firebase:

  1. No Console do Firebase, abra seu projeto.
  2. Selecione Analytics no menu para ver o painel de relatórios do Analytics.

Na guia Eventos, você encontra os relatórios de eventos criados automaticamente para cada tipo diferente de evento do Analytics registrado pelo seu app. Saiba mais sobre o painel de relatórios do Analytics na Central de Ajuda do Firebase.