Check out what’s new from Firebase at Google I/O 2022. Learn more

Primeiros passos com o Google Analytics em C++

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

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 se aplicam ao 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 C++ e configure-o para usar o Firebase:

    Se o projeto em C++ já usa o Firebase, então ele já está registrado e configurado para o Firebase.

  • Adicionar o SDK do Firebase para C++ ao seu projeto em C ++.

A adição do Firebase ao projeto em C++ envolve tarefas no Console do Firebase e no projeto em C++ aberto. Por exemplo, você faz o download dos arquivos de configuração do Firebase no console e os move para o projeto em C++.

Criar e inicializar o app do Firebase

Antes de começar, você precisa criar e inicializar o app do Firebase:

Android

Para criar o app do Firebase, transmita como argumentos à atividade Java o ambiente JNI e uma referência de jobject:

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

Inicialize a biblioteca do Analytics:

::firebase::analytics::Initialize(app);

iOS+

Crie o app do Firebase:

app = ::firebase::App::Create(::firebase::AppOptions());

Inicialize a biblioteca do Analytics: 

::firebase::analytics::Initialize(app);

Registrar eventos

Após configurar a instância do firebase::App, será possível registrar eventos com o método LogEvent().

No exemplo a seguir, você verá a atualização da pontuação do usuário:

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

Próximas etapas