Ir para o console

Registrar eventos

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

O Google Analytics registra alguns eventos automaticamente, sem precisar de código adicional para o recebimento. Se o app precisar coletar outros dados, será possível registrar até 500 tipos diferentes de eventos do Analytics no aplicativo. Não há limite para o volume total de eventos registrados pelo app. 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, realize estas ações:

  • Registre seu projeto do Unity e configure-o para usar o Firebase.

    • Se o projeto já usa o Firebase, então ele já está registrado e configurado para essa plataforma.

    • Se você não tiver um projeto do Unity, faça o download de um app de amostra (em inglês).

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

Adicionar o Firebase ao seu projeto do Unity envolve tarefas no Console do Firebase e no projeto aberto do Unity. Por exemplo, fazer o download dos arquivos de configuração do Firebase no console e movê-los para o projeto do Unity.

Registrar eventos

Depois de inicializar o módulo Firebase.Analytics.FirebaseAnalytics, será possível 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, adicione 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 serão incluídos nos dados exportados para o BigQuery caso seu app esteja vinculado a um projeto dessa ferramenta.

  • Parâmetro 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 que um tipo de evento sugerido do Analytics não cobre, registre eventos personalizados próprios do Analytics, conforme mostrado neste exemplo:

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

Visualizar eventos na saída de registro

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.

É possível usar uma série de comandos adb para ativar o registro detalhado:

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, o que ajuda a verificar imediatamente se os eventos estão sendo enviados.

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. Abra seu projeto no Console do Firebase.
  2. Selecione Analytics no menu para ver o painel de relatórios dessa plataforma.

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