Esta página foi traduzida pela API Cloud Translation.

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

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.

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.

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

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

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"

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.

Clique no botão "Registrar aplicativo".

Fazer o download do arquivo de configuração

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

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

Você precisa do plug-in do Gradle para Serviços do Google para ler o arquivo google-services.json que foi gerado pelo Firebase.
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
      ...
      }
   }
}

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.

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'

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)

Declare o objeto FirebaseAnalytics na parte de cima da atividade:

private lateinit var firebaseAnalytics: FirebaseAnalytics

Inicialize o objeto no método onCreate():

firebaseAnalytics = Firebase.analytics

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

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

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

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

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

Agora, acesse o Google Ads e faça login na conta vinculada ao Firebase.
No Google Ads, acesse Ferramentas → Medição → Conversões .
Clique no botão + .
Escolha App → Propriedades do Google Analytics 4 (Firebase) e clique em "Continuar".
É 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.
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

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

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

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.