1. Introdução
Última atualização: 2020-12-14
O que você vai construir
Neste codelab, você aprenderá como implementar eventos com o Google Analytics para Firebase (GA4F) e lançar campanhas de ação por meio do Google Ads.
Este codelab se concentra na implementação de eventos com GA4F e na importação dos eventos no Google Ads. Se você quiser aprender como criar um aplicativo Android com o Firebase, consulte Firebase Android Codelab-Build Friendly Chat .
O que você aprenderá
- Como criar um projeto Firebase
- Como implementar o Firebase SDK no aplicativo 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 você precisará
- Android Studio 3.6 ou superior
- Conta do Firebase
- Conta do Google Ads
2. Crie e configure 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 desejar.
- Clique nas opções de criação do projeto. Aceite os termos do Firebase, se solicitado. Você deve ativar o Google Analytics para este projeto, pois precisa de eventos do Google Analytics para rastrear eventos de ação e conversões.
Para saber mais sobre os projetos do Firebase, consulte Entender os projetos do Firebase .
- Escolha a conta do Google Analytics. Se você tiver um, escolha esse ou crie um novo. Clique no botão Criar projeto.
- Agora a compilação do projeto Firebase foi concluída!
Na próxima etapa, você aprenderá como adicionar o Firebase ao seu aplicativo Android.
3. Adicione o Firebase ao seu aplicativo Android
Registrar aplicativo
- 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 estúdio Android, vá para o diretório do aplicativo, abra um nome de arquivo build.gradle
. No arquivo, procure applicationId
. Esse valor é o nome do pacote Android. Copie este valor e cole-o.
Não precisamos da chave SHA-1 aqui, a menos que você planeje usar o Google Sign In ou Firebase Dynamic Links (observe que eles não fazem parte deste codelab. Para obter mais informações sobre a chave SHA-1, consulte este documento ). .
- Clique no botão Registrar aplicativo.
Baixar arquivo de configuração
- Clique no botão Baixar google-services.json para baixar o arquivo de configuração
google-services.json
.
- No estúdio Android, vá para o diretório
app
e mova o arquivogoogle-services.json
(que você acabou de baixar acima) para o diretórioapp
. De volta ao console do Firebase, clique no botão Avançar.
Ative o Firebase em seu aplicativo
- Você precisa do plugin Google Services Gradle para ler o arquivo
google-services.json
que foi gerado pelo Firebase. - No estúdio Android, abra
<project>/build.gradle
e adicione as seguintes linhas no 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 as seguintes linhas no 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 aplicativo Android!
Na próxima etapa, você aprenderá como adicionar o Firebase SDK ao seu aplicativo.
4. Adicione o Firebase SDK ao seu aplicativo
Nesta etapa, você adicionará o SDK do Firebase, especificamente o SDK do Firebase para Google Analytics.
Usaremos o Firebase Android BoM, que permite gerenciar as versões da biblioteca do Firebase que você está usando em seu aplicativo, especificando a versão do BoM. Para saber quais versões da biblioteca do Firebase são mapeadas para uma versão específica do BoM, confira as notas de lançamento dessa versão do BoM.
- Abra
<project>/<app-module>/build.gradle
e adicione as seguintes linhas no 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, especificando apenas a versão do BoM, você não precisa especificar a versão da biblioteca de análise do firebase. Mas se você quiser usar a versão desejada para sua biblioteca Firebase, não importa qual versão seja designada no 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'
- Agora sincronize seu aplicativo clicando no botão
Sync Now
.
Agora você concluiu a adição do SDK do Firebase para Google Analytics ao seu aplicativo Android.
Na próxima etapa, você aprenderá como registrar eventos do Firebase em seu aplicativo Android.
5. Registrar eventos com Firebase Analytics
Nesta etapa, você aprenderá como registrar eventos com o Firebase Analytics no aplicativo Android.
Existem 2 maneiras de registrar eventos: usando eventos sugeridos ou eventos personalizados.
Usando eventos sugeridos
O Firebase Analytics SDK define uma série de eventos sugeridos que podem ser usados em vários tipos de aplicativos, como jogos, varejo, viagens e comércio eletrônico. Além disso, existem alguns eventos sugeridos que exigem seus parâmetros prescritos e, com esses parâmetros, você pode maximizar os detalhes disponíveis em seus 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 registrando eventos com o método
logEvent()
. O código a seguir registra um evento PURCHASE quando um usuário compra um(s) item(ns) no aplicativo:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
Usando eventos personalizados
Se você precisar de eventos não cobertos por eventos sugeridos, poderá registrar seus próprios eventos personalizados com parâmetros personalizados:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
Depurar eventos
Você pode visualizar dados agregados e relatórios sobre seus eventos no Firebase console. Mas as atualizações ocorrem periodicamente ao longo do dia, você não pode visualizar esses eventos imediatamente após registrá-los em seu aplicativo.
Para fins imediatos de teste e depuração, você pode usar o Firebase Debugview. O DebugView permite que você veja os dados de eventos registrados por seu aplicativo em dispositivos de desenvolvimento quase em tempo real. Para DebugView, consulte a seção Evento de depuração .
Agora você concluiu o registro de eventos em seu aplicativo Android!
Na próxima etapa, você aprenderá como importar esses eventos para o Google Ads.
6. Importe eventos do Firebase para o Google Ads
Sua configuração Firebase-Android foi concluída e você está pronto para lançar a campanha de aplicativo com eventos de ação registrados. Você começará vinculando o Firebase ao Google Ads. Ao vincular o Firebase ao Google Ads, as campanhas de aplicativos poderão aprender mais sobre o público e aumentar o aprendizado das campanhas de aplicativos, o que geralmente leva a um melhor desempenho e conversões.
Vincule o Firebase e o Google Ads
- Acesse Configurações do Firebase clicando no botão ao lado de Visão geral do projeto.
- Na guia Integrações, você verá Google Ads e um botão Link. Clique em Link e continue.
- Escolha a conta do Google Ads que deseja 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
- No console do Firebase, acesse o menu Eventos e marque o evento que deseja importar como uma conversão.
- Agora, vá para o Google Ads e faça login na conta vinculada ao Firebase.
- No Google Ads, vá para Ferramentas → Medição → Conversões
- Clique no botão +
- Escolha Aplicativo → Propriedades do Google Analytics 4 (Firebase) e clique em continuar.
- Você pode ver todos os eventos analíticos marcados como conversões. Encontre o evento que deseja importar. Neste caso, escolha o evento
delete_item
que implementamos antes. Clique no botão Importar e Continuar. - Você importou com sucesso 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ê aprenderá como lançar uma campanha de ação com o evento que acabou de importar.
7. Lançamento de campanhas de ação no aplicativo com eventos importados
- Acesse a guia Campanhas para apps em sua conta atual do Google Ads e inicie uma nova campanha clicando no botão +.
- Lançaremos uma campanha de promoção de aplicativos com a opção de instalações de aplicativos. Na parte inferior, escolha o aplicativo que deseja promover e clique em continuar.
- Na seção Lances, se você selecionar Ações no aplicativo no menu suspenso, poderá visualizar os eventos. Escolha um evento(s) que você deseja focar.
- Defina o restante das configurações da campanha e pronto.
8. Parabéns
Parabéns, você integrou com sucesso seu Firebase e Google Ads! Isso ajudará você a aumentar o desempenho da sua campanha.
você aprendeu
- Como configurar o Firebase Analytics para Android
- Como registrar eventos com o Firebase Analytics em um aplicativo Android.
- Como importar eventos e usá-los para campanhas de ação.