O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

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 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 amostra.

  • 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 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 diferentes tipos de apps, como os de varejo, e-commerce, viagem e jogos. Para saber quando usar esses eventos e acessar mais informações sobre eles, consulte os artigos de Eventos e propriedades na Central de Ajuda do Firebase.

Os 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(
    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 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. No menu, selecione Analytics para visualizar 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 app. Leia mais sobre o painel de relatórios do Analytics na Central de Ajuda do Firebase.