Esta página foi traduzida pela API Cloud Translation.

Eventos personalizados do Google Ads com o 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(GAPF) e a lançar campanhas de ação pelo Google Ads.

Este codelab se concentra na implementação de eventos com o GAPF e na importação deles no Google Ads. Se você quiser aprender a criar um app Android com o Firebase, consulte Firebase Android Codelab: criação de chat fácil de usar.

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ê precisará 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 de projeto. Aceite os termos do Firebase se solicitado. Como você precisa dos eventos do Google Analytics para rastrear conversões e eventos de ação, ative o Google Analytics neste projeto.

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

A criação do projeto do Firebase foi concluída.

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

3. Adicionar o Firebase ao app Android

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

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 precisamos da chave SHA-1 aqui, a menos que você planeje usar o Login do Google ou o Firebase Dynamic Links. Esses recursos 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. Volte ao Console do Firebase e clique no botão "Próxima".

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 estas 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'

Você acabou de adicionar o Firebase ao app Android.

Na próxima etapa, você 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 notar, se você especificar apenas a versão da BoM, não será necessário definir a versão da biblioteca do Firebase Analytics. 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'

Sincronize o 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ê aprenderá a registrar eventos do Firebase no seu app Android.

5. Registrar eventos com o Firebase Analytics

Nesta etapa, você 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 os parâmetros prescritos e, com eles, é possível maximizar os detalhes disponíveis nos relatórios do Firebase. ( Referência de eventos sugeridos)

Declare o objeto FirebaseAnalytics na parte superior 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 um item 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 visualizar 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 ver esses eventos imediatamente depois de registrá-los 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

Clique no botão ao lado de "Visão geral do projeto" para acessar as configurações do Firebase.

Na guia "Integrações", você encontra o Google Ads e um botão "Vincular". Clique em "Vincular" e em "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.

Você concluiu a importação de eventos do Firebase para o Google Ads.

Na próxima etapa, você vai aprender a lançar 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 clique no botão + para iniciar uma nova campanha.

Lançaremos uma campanha de promoção de aplicativos com a opção "Instalações de aplicativos". 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 conseguir ver os eventos. Escolha os eventos em que você quer se concentrar.

Defina as configurações da campanha e pronto.

8. Parabéns

Parabéns! Você integrou o Firebase ao 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.