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. Não é necessário adicionar códigos para recebê-los. Caso o app precise coletar outros dados, é possível registrar até 500 tipos diferentes de eventos do Analytics no app. 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 vai resultar na criação de dois eventos distintos.

Antes de começar

Antes de usar o Google Analytics, faça o seguinte:

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

    • Se o projeto do Unity já usa o Firebase, 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 exemplo.

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

Adicionar o Firebase ao 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 mover 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 recomendados, comuns entre diferentes tipos de apps, como os de varejo, e-commerce, viagem e jogos. Para saber mais sobre esses eventos e quando usá-los, consulte o artigo Eventos recomendados na Central de Ajuda do Google Analytics.

Encontre detalhes de implementação dos eventos recomendados 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(
    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 prescritos, é possível 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 serão incluídos nos dados exportados para o BigQuery, caso o app esteja vinculado a um projeto dessa ferramenta.

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

Caso seu aplicativo tenha necessidades específicas não cobertas por um tipo de evento sugerido 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

Android

Você pode ativar o registro detalhado 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 Firebase console. 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. No menu, selecione Analytics para visualizar o painel de relatórios do Analytics.

A guia Eventos mostra os relatórios de eventos criados automaticamente para cada tipo distinto de evento do Analytics registrado pelo seu aplicativo. Leia mais sobre o painel.