Primeiros passos com o Google Analytics no Unity

O Google Analytics coleta dados de uso e comportamento do seu aplicativo. O SDK registra dois tipos principais de informações:

  • Eventos: o que acontece no seu app, como ações do usuário, eventos do sistema ou erros.
  • Propriedades do usuário: atributos que você define para descrever segmentos da sua base de usuários, como preferência de idioma ou localização geográfica.

O Analytics registra automaticamente alguns eventos e propriedades do usuário. Não é preciso adicionar códigos para ativá-los. Se o app precisar coletar outros dados, será possível configurar até 25 propriedades de usuário do Analytics e registrar até 500 tipos diferentes de eventos dessa plataforma no aplicativo. Não há limite para o volume total de eventos registrados pelo app.

Para acessar esses dados, siga estas etapas:

  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.

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, consulte os artigos da seção Eventos e propriedades na Central de Ajuda do Firebase. Para ter o máximo de detalhes nos relatórios, registre eventos sugeridos do Analytics que façam sentido para seu app e os parâmetros prescritos para ele. Isso também garante que você aproveite os recursos mais recentes do Google Analytics conforme eles são disponibilizados.

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

Comece a registrar eventos imediatamente com o método LogEvent().

O exemplo a seguir registra eventos com vários tipos de argumentos:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

Próximos passos