Google Ads com eventos personalizados do Google Analytics para Firebase: Android

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 aprender a criar um app Android com o Firebase, consulte o Codelab do Firebase para Android: criar um chat amigável.

O que você aprenderá

• Como criar um projeto do Firebase
• Como implementar o SDK do Firebase no app Android
• Como criar eventos e parâmetros.
• Como importar eventos do Firebase para o Google Ads
• Lance 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 os projetos do Firebase.

3. Escolha a conta do Google Analytics. Se houver, escolha essa opção ou crie uma nova. Clique no botão "Criar projeto".

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

Na próxima etapa, você 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" na 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 com o nome build.gradle. No arquivo, pesquise por applicationId. Esse valor é o nome do pacote 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.

Dica: leia Definir o ID do aplicativo para mais informações sobre IDs de pacotes e aplicativos.

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

Fazer o download do arquivo de configuração

1. Clique no botão "Fazer o download do google-services.json" para salvar o 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 baixar 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 Gradle para Serviços do Google para ler o arquivo google-services.json que foi 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 estas 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 seu app

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

Usaremos a BoM do Firebase para Android, que permite gerenciar as versões das bibliotecas do Firebase usadas no seu app especificando a versão da BoM. Para saber quais versões das bibliotecas do Firebase são associadas a uma versão específica da BoM, consulte as notas dessa versão.

1. Abra <project>/<app-module>/build.gradle e adicione estas 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 na sua biblioteca do Firebase, seja qual for a versão designada na BoM, basta especificar a versão desejada da seguinte maneira:

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.

Você acabou de adicionar o SDK do Firebase para o 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 uma série de eventos sugeridos que podem ser usados em vários tipos de aplicativos, 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 que não são abordados pelos sugeridos, registre seus próprios eventos personalizados com parâmetros personalizados:

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

Eventos de depuração

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

Para testes e depuração imediatos, use o Firebase Debugview. O DebugView permite que você veja dados de eventos registrados pelo seu aplicativo em dispositivos de desenvolvimento quase em tempo real. Para o DebugView, consulte a seção Evento de depuração.

Agora você concluiu o registro de eventos no 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 os eventos de ação registrados. Para começar, vincule o Firebase ao Google Ads. Ao vincular o Firebase ao Google Ads, as campanhas para apps podem aprender mais sobre os públicos-alvo e impulsionar os aprendizados das campanhas para apps, o que geralmente leva a melhor performance e conversões.

Vincular o Firebase ao 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.

Você concluiu a vinculação do Firebase ao 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.

Atenção:se o evento de destino não for marcado como conversão, o Google Ads não poderá importá-lo. Verifique se ele está marcado corretamente como 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. É possível ver todos os eventos do Analytics marcados como conversões. Localize o evento que você quer importar. Nesse caso, escolha um evento delete_item que já 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

Importante: para lançar uma campanha para apps, é necessário ter um app em fase de produção no Google Play. Se você não quiser publicar o app, deixe esta etapa por enquanto.

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.