Eventos de registro

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

O Google 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 registrados pelo seu aplicativo. Observe que os nomes dos eventos diferenciam maiúsculas de minúsculas e que registrar dois eventos cujos nomes diferem apenas em maiúsculas e minúsculas resulta em dois eventos distintos.

Antes de você começar

Antes de poder usar o Google Analytics , você precisa:

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

    • Se o seu 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á baixar um aplicativo de exemplo .

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

Observe que adicionar o Firebase ao seu projeto do Unity envolve tarefas no console do Firebase e no seu projeto aberto do Unity (por exemplo, você baixa os arquivos de configuração do Firebase do console e os move para o seu projeto do Unity).

Registrar eventos

Depois de inicializar o módulo Firebase.Analytics.FirebaseAnalytics , você poderá 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 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 os artigos sobre eventos recomendados na Central de Ajuda do Google Analytics.

Você pode encontrar detalhes de implementação para eventos recomendados nos seguintes locais:

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

O exemplo a seguir demonstra 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 parâmetros prescritos, você pode adicionar os seguintes parâmetros a qualquer evento:

  • Parâmetros personalizados: os parâmetros personalizados não são representados diretamente nos seus relatórios do Analytics, mas podem ser usados ​​como filtros nas definições de público que podem ser aplicados a todos os relatórios. Os parâmetros personalizados também serão incluídos nos dados exportados para o BigQuery se o seu aplicativo estiver vinculado a um projeto do BigQuery.

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

Se seu aplicativo tiver necessidades específicas não atendidas por um tipo de evento do Analytics sugerido, você poderá registrar seus próprios eventos do Analytics personalizados, conforme mostrado neste exemplo:

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

Ver eventos na saída do log

Android

Você pode ativar o registro detalhado no log de depuração do Android Studio para ajudar a verificar se os eventos estão sendo registrados corretamente pelo SDK. Isso inclui eventos registrados automática e manualmente.

Você pode ativar o registro detalhado 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

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

iOS+

Os eventos são registrados no console e podem ser visualizados durante a execução do aplicativo por meio do XCode.

Visualize eventos analíticos no painel

Você pode visualizar estatísticas agregadas sobre seus eventos do Analytics nos painéis do Firebase Console. 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.

Para acessar esses dados no console do Firebase:

  1. No console do Firebase , abra seu projeto.
  2. Selecione Analytics no menu 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 .