1. Introdução

Última atualização:14/12/2020

O que você vai criar

Neste codelab, você vai aprender a implementar eventos com o Google Analytics para Firebase(GA4F) e a lançar campanhas de ação no Google Ads.

Este codelab se concentra na implementação de eventos com o GA4F e na importação deles no Google Ads. Se você quiser saber como criar um app Android com o Firebase, consulte o Firebase Android Codelab: criar um chat amigável.

O que você aprenderá

• Como criar um projeto do Firebase
• Como implementar o SDK do Firebase em um app Android
• Como criar eventos e parâmetros.
• Como importar eventos do Firebase para o Google Ads
• Lançar campanhas de ação do Google Ads com eventos personalizados.

O que é necessário

• Android Studio 3.6 ou mais recente
• Conta do Firebase
• Conta do Google Ads

2. Criar e configurar um projeto do Firebase

Para começar a usar o Firebase, você precisa criar e configurar um projeto do Firebase.

Criar um projeto do Firebase

1. Faça login no Firebase.

No console do Firebase, clique em "Adicionar projeto" ou "Criar um projeto" e nomeie seu projeto do Firebase como quiser.

2. Clique nas opções de criação do projeto. Se for solicitado, aceite os termos do Firebase. Você precisa ativar o Google Analytics para esse projeto, porque são necessários eventos dele para rastrear os eventos de ação e analisar as conversões.

Para saber mais sobre os projetos do Firebase, consulte Noções básicas sobre projetos do Firebase.

3. Escolha a conta do Google Analytics. Se você tiver um, escolha-o ou crie um novo. Clique no botão "Criar projeto".

4. Agora o build do projeto do Firebase foi concluído.

Na próxima etapa, você vai aprender a adicionar o Firebase ao seu app Android.

3. Adicionar o Firebase ao seu app Android

Registrar o app

1. No Console do Firebase, selecione "Visão geral do projeto" no painel de navegação à esquerda e clique no botão "Android" em "Comece adicionando o Firebase ao seu aplicativo".

2. Preencha as informações necessárias.

Para o nome do pacote Android, no Android Studio, acesse o diretório do app e abra um arquivo chamado build.gradle. No arquivo, pesquise applicationId. Esse valor é o nome do pacote do Android. Copie e cole esse valor.

Não é necessário ter a chave SHA-1 aqui, a menos que você pretenda usar o Login do Google ou os Firebase Dynamic Links, que não fazem parte deste codelab. Para mais informações sobre a chave SHA-1, consulte este documento.

3. Clique no botão "Registrar app".

Fazer o download do arquivo de configuração

1. Clique no botão "Fazer o download do google-services.json" para fazer o download do arquivo de configuração google-services.json.

2. No Android Studio, acesse o diretório app e mova o arquivo google-services.json (que você acabou de salvar acima) para o diretório app. No Console do Firebase, clique no botão "Avançar".

Ativar o Firebase no seu app

1. Você precisa do plug-in do Google Services para Gradle para ler o arquivo google-services.json gerado pelo Firebase.
2. No Android Studio, abra <project>/build.gradle e adicione as seguintes linhas ao arquivo:

buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}

3. Abra <project>/<app-module>/build.gradle e adicione as seguintes linhas ao arquivo:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Pronto. Você adicionou o Firebase ao seu app Android.

Na próxima etapa, você vai aprender a adicionar o SDK do Firebase ao seu app.

4. Adicionar o SDK do Firebase ao app

Nesta etapa, você vai adicionar o SDK do Firebase, especificamente o SDK do Firebase para Google Analytics.

Vamos usar a BoM do Firebase para Android, que permite gerenciar as versões da biblioteca do Firebase que você está usando no app especificando a versão da BoM. Para saber quais versões das bibliotecas do Firebase estão mapeadas para uma versão específica da BoM, confira as notas da versão.

1. Abra <project>/<app-module>/build.gradle e adicione as seguintes linhas ao arquivo:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

Como você pode ver, ao especificar apenas a versão da BoM, não é necessário especificar a versão da biblioteca do Google Analytics do Firebase. No entanto, se você quiser usar a versão desejada da biblioteca do Firebase, independente da versão designada na BoM, basta especificar a versão desejada assim:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'

2. Agora, sincronize seu app clicando no botão Sync Now.

Agora você já adicionou o SDK do Firebase para Google Analytics ao seu app Android.

Na próxima etapa, você vai aprender a registrar eventos do Firebase no seu app Android.

5. Registrar eventos com o Firebase Analytics

Nesta etapa, você vai aprender a registrar eventos com o Firebase Analytics no app Android.

Há duas maneiras de registrar eventos: usando eventos sugeridos ou personalizados.

Como usar eventos sugeridos

O SDK do Firebase Analytics define vários eventos sugeridos que podem ser usados em vários tipos de apps, como jogos, varejo, viagens e e-commerce. Além disso, há alguns eventos sugeridos que exigem parâmetros prescritos. Com esses parâmetros, você pode maximizar os detalhes disponíveis nos relatórios do Firebase. ( Referência de eventos sugeridos)

1. Declare o objeto FirebaseAnalytics na parte de cima da atividade:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Inicialize o objeto no método onCreate():

firebaseAnalytics = Firebase.analytics

3. Comece a registrar eventos com o método logEvent(). O código a seguir registra um evento PURCHASE quando um usuário compra itens no app:

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

Como usar eventos personalizados

Se você precisar de eventos não cobertos por eventos sugeridos, registre seus próprios eventos personalizados com parâmetros personalizados:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

Depurar eventos

É possível conferir dados e relatórios agregados sobre seus eventos no Console do Firebase. No entanto, as atualizações acontecem periodicamente ao longo do dia. Não é possível conferir esses eventos imediatamente após fazer login no app.

Para fins de teste e depuração imediata, você pode usar o DebugView do Firebase. Com o DebugView, você pode conferir dados de eventos registrados pelo seu app em dispositivos de desenvolvimento quase em tempo real. Para o DebugView, consulte a seção Depurar evento.

Agora você já terminou de registrar eventos no seu app Android.

Na próxima etapa, você vai aprender a importar esses eventos para o Google Ads.

6. Importar eventos do Firebase para o Google Ads

A configuração do Firebase para Android foi concluída, e você já pode lançar a campanha para apps com eventos de ação registrados. Comece vinculando o Firebase ao Google Ads. Ao vincular o Firebase ao Google Ads, as campanhas para apps vão poder aprender mais sobre os públicos-alvo e melhorar os aprendizados das campanhas para apps, o que geralmente resulta em melhor performance e conversões.

Vincular o Firebase e o Google Ads

1. Acesse as configurações do Firebase clicando no botão ao lado de "Visão geral do projeto".

2. Na guia "Integrações", você vai encontrar o Google Ads e o botão "Vincular". Clique em "Vincular e continuar".

3. Escolha a conta do Google Ads que você quer vincular.

Agora você já vinculou o Firebase e o Google Ads. Vamos importar eventos do Firebase para o Google Ads.

Importar eventos do Firebase

1. No console do Firebase, acesse o menu "Eventos" e marque o evento que você quer importar como uma conversão.

2. Agora, acesse o Google Ads e faça login na conta vinculada ao Firebase.
3. No Google Ads, acesse "Ferramentas > Medição > Conversões".
4. Clique no botão "+"
5. Escolha App → Propriedades do Google Analytics 4 (Firebase) e clique em "Continuar".
6. Você pode conferir todos os eventos do Google Analytics marcados como conversões. Encontre o evento que você quer importar. Neste caso, escolha o evento delete_item que implementamos antes. Clique no botão "Importar e continuar".
7. Você importou um evento de conversão do Firebase.

Agora você concluiu a importação dos eventos do Firebase para o Google Ads.

Na próxima etapa, você vai aprender a iniciar uma campanha de ação com o evento que acabou de importar.

7. Como lançar campanhas de ação para apps com eventos importados

1. Acesse a guia "Campanhas para apps" na sua conta atual do Google Ads e inicie uma nova campanha clicando no botão +.

2. Vamos lançar uma campanha de promoção de app com a opção "Instalações de apps". Na parte de baixo, escolha o app que você quer promover e clique em "Continuar".
3. Na seção "Lances", se você selecionar "Ações no app" no menu suspenso, vai poder conferir os eventos. Escolha os eventos em que você quer se concentrar.

4. Defina o restante das configurações da campanha e pronto.

8. Parabéns

Parabéns! Você integrou o Firebase e o Google Ads. Isso vai ajudar a melhorar a performance da sua campanha.

Você aprendeu

• Como configurar o Firebase Analytics para Android
• Como registrar eventos com o Firebase Analytics em um app Android.
• Como importar eventos e usá-los em campanhas de ação.