Registrar eventos

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

O Google Analytics registra automaticamente alguns eventos para você. 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, 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 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 do Unity.

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 útil para coletar uma métrica principal pertencente a 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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

Visualizar eventos do Analytics no painel

Você pode encontrar estatísticas agregadas sobre os eventos do Analytics nos painéis de controle 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 Firebase:

1. Abra o projeto no console de Firebase.
2. Selecione Analytics no menu para acessar o painel de relatórios 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.