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 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 para o Google Ads. Se quiser saber como criar um app Android com o Firebase, consulte o codelab do Firebase para Android: crie o Friendly Chat.

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
• Como lançar campanhas de ação do Google Ads com eventos personalizados.

O que é necessário

• Android Studio 3.6 ou uma versão mais recente
• Conta do Firebase
• Conta do Google Ads

2. Criar e configurar um projeto do Firebase

Para começar a usar o Firebase, será necessário 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 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 uma, escolha essa opção ou crie uma nova. Clique no botão "Criar projeto".

4. Agora a build do projeto do Firebase foi concluída.

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

3. Adicionar o Firebase ao seu app Android

Registrar 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 app".

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.

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

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 baixar 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. Volte ao Console do Firebase e clique no botão "Próxima".

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'

Agora você concluiu a adição do 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 usadas 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 para Firebase. Mas se você quiser usar a versão desejada para sua biblioteca do Firebase, não importa qual versão esteja 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, clique no botão Sync Now para sincronizar seu app.

Agora, você concluiu a adição do 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 eles, 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 um ou mais itens no app:

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

Usar eventos personalizados

Se você precisar de eventos não cobertos pelos 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 agregados e relatórios sobre seus eventos no Console do Firebase. No entanto, as atualizações acontecem periodicamente ao longo do dia, e não é possível ver esses eventos imediatamente após o registro no app.

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

Agora você concluiu o registro de 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-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 podem aprender mais sobre os públicos-alvo e aumentar os aprendizados das campanhas para apps, o que geralmente resulta em melhor performance e mais 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 um botão "Vincular". Clique em "Vincular e continuar".

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

Agora você concluiu a vinculação do Firebase e do 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 alvo não for marcado como conversão, o Google Ads não conseguirá importá-lo. Confira se ele foi marcado corretamente 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 → Avaliação → Conversões
4. Clique no botão + .
5. Escolha "App" → "Propriedades do Google Analytics 4 (Firebase)" e clique em "Continuar".
6. Você verá todos os eventos do Analytics que foram marcados como conversões. Encontre o evento que você quer importar. Nesse 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 de 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 estiver pronto para publicar o app, deixe essa etapa para depois.

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, poderá ver os eventos. Escolha um ou mais 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.