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 de eventos Analytics 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 o projeto no console de Firebase.
  2. Selecione Analytics no menu para acessar o painel de relatórios 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.

Para ajudar você a começar, o SDK do Analytics define vários eventos recomendados, comuns entre diferentes tipos de apps, como os de varejo, e-commerce, viagem e jogos. Para saber mais sobre esses eventos e quando usar cada um, consulte Eventos recomendados. Observação: para criar relatórios mais detalhados, registre os eventos recomendados que se aplicam ao seu app e aos respectivos parâmetros prescritos. 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, você precisa:

  • Registrar seu projeto em C++ e configurá-lo para usar o Firebase.

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

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

Adicionar o Firebase ao projeto em C++ envolve tarefas no console do Firebase e no projeto em C++ aberto (por exemplo, fazer o download dos arquivos de configuração do Firebase pelo console e movê-los 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 Analytics: 

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

iOS+

Crie o app do Firebase:

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

Inicialize a biblioteca 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