Confira os destaques do Firebase no Google I/O 2023. Saiba mais

Introdução ao Google Analytics em C++

O Google Analytics coleta dados de uso e comportamento do seu app. 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. Caso o app precise coletar outros dados, é possível configurar até 25 propriedades de usuário do Analytics e registrar até 500 tipos diferentes de eventos dessa plataforma no app. 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. 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 que são comuns entre tipos diferentes de apps, como os de varejo, comércio eletrônico, viagens 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. Para criar relatórios mais detalhados, registre os eventos sugeridos do Analytics que se aplicam ao seu app e os parâmetros prescritos para eles. 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, faça o seguinte:

  • 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