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

Este codelab tem como foco a implementação de eventos com o GAPF e a importação deles no Google Ads. Se você quiser aprender a criar um app Android com o Firebase, consulte Firebase Android Codelab-Build 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
• Lance campanhas de ação do Google Ads com eventos personalizados.

O que é necessário

• Android Studio 3.6 ou 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, é 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 dê o nome que quiser ao projeto do Firebase.

2. Clique nas opções de criação do projeto. Se solicitado, aceite os termos do Firebase. Ative o Google Analytics neste projeto, já que você precisa de eventos do Analytics para acompanhar conversões e eventos de ação.

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 tiver uma, escolha essa ou crie uma nova. Clique no botão "Criar projeto".

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

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, acesse o diretório do app no Android Studio e abra um arquivo com o nome build.gradle. No arquivo, pesquise 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ê pretenda usar o Login do Google ou o Firebase Dynamic Links. Eles 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 de 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 transferir 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 salvar por download 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 que foi gerado pelo Firebase.
2. 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
      ...
      }
   }
}

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'

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

4. Adicionar o SDK do Firebase ao seu app

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

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

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'

Ao especificar apenas a versão da BoM, não é necessário definir a versão da biblioteca do Firebase Analytics. No entanto, se você quiser usar a versão desejada da sua biblioteca do Firebase, seja qual for a versão designada na BoM, basta especificar a versão desejada da seguinte forma:

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. Sincronize o app clicando no botão Sync Now.

Você concluiu a adição do SDK do Firebase para 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ê 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 aplicativos, como jogos, varejo, viagens e e-commerce. Além disso, há alguns eventos sugeridos que exigem parâmetros prescritos e, com esses parâmetros, você pode maximizar os detalhes disponíveis nos seus relatórios do Firebase. ( Referência de eventos sugeridos)

1. Declare o objeto FirebaseAnalytics na parte superior 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 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 não cobertos pelos 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 ver relatórios e dados 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 aplicativo.

Para fins imediatos de teste e depuração, você pode usar o Firebase Debugview. O DebugView permite que você confira dados de eventos registrados pelo seu app em dispositivos de desenvolvimento quase em tempo real. Para o DebugView, consulte a seção Depuração de eventos.

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 aprendem mais sobre os públicos-alvo e aprimoram os aprendizados delas, o que geralmente melhora a performance e as 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ê verá 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 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 estiver marcado como conversão, o Google Ads não poderá importá-lo. Verifique se o evento está marcado corretamente como uma conversão.

2. Agora, acesse o Google Ads e faça login na conta que você vinculou 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 conferir todos os eventos de análise marcados como conversões. Encontre o evento que você quer importar. Nesse caso, escolha o evento delete_item que já foi implementado. 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 lançar uma campanha de ação com o evento que acabou de importar.

7. Lançamento de campanhas de ação para apps com eventos importados

Importante:para lançar uma campanha para apps, é necessário ter um app em nível de produção no Google Play. Se você não estiver pronto para publicar o app, saia desta 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. Lançaremos uma campanha de promoção de aplicativos com a opção "Instalações de aplicativos". Na parte de baixo da tela, 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 ser possível ver os eventos. Escolha os eventos que você quer focar.

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

8. Parabéns

Parabéns! Você integrou o Firebase ao Google Ads. Isso ajuda a impulsionar a performance da 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.