Primeiros passos com o Google Analytics para Firebase em C++

O Google Analytics para Firebase coleta dados de uso e comportamento para 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 seja necessário que seu aplicativo colete dados adicionais, você pode configurar até 25 propriedades diferentes do usuário e registrar até 500 tipos distintos de eventos do Analytics no seu aplicativo. Não há limite para o volume total de eventos que seu aplicativo registra.

Para acessar estes dados, siga estas etapas:

  1. No Console do Firebase, abra seu projeto.
  2. Selecione Analytics no menu para ver 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 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 que são comuns entre tipos diferentes de aplicativos, incluindo aplicativos 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 para Firebase conforme eles são disponibilizados.

Conectar o app ao Console do Firebase

  1. Instale o SDK do Firebase.
  2. No Console do Firebase, adicione seu app ao projeto do Firebase.

Adicionar o Analytics ao app

Para usar as bibliotecas do Analytics no seu projeto para C++, é necessário adicioná-lo aos arquivos de criação para que as bibliotecas adequadas sejam vinculadas.

Android

  1. Adicione o componente de Java do Firebase ao arquivo build.gradle:

    implementation 'com.google.firebase:firebase-analytics:16.3.0'

  2. Vincule as seguintes bibliotecas ao compilar o componente C++:

    libapp.a
    libanalytics.a
    

iOS

Antes de iniciar a criação para iOS, será necessário adicionar as bibliotecas do Firebase ao projeto do Xcode:

  1. Adicione as dependências a seguir ao Podfile:
    pod 'Firebase/Core'
    pod 'Firebase/Analytics'
  2. Execute $pod install.
  3. Adicione firebase.framework e firebase_analytics.framework ao projeto do Xcode.

Criar e inicializar o app do Firebase

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

Android

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

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

Depois de configurar a instância firebase::App, comece a 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

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.