Esta página foi traduzida pela API Cloud Translation.

Eventos personalizados do Google Ads com Google Analytics para Firebase – Android

1. Introdução

Última atualização: 14/12/2020

O que você 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 de eventos no Google Ads. Se você quiser aprender como construir um aplicativo Android com Firebase, consulte Firebase Android Codelab-Build Friendly Chat .

O que você aprenderá

Como criar um projeto Firebase
Como implementar o SDK do Firebase em um 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 Firebase

Para começar a usar o Firebase, você precisará criar e configurar um projeto do Firebase.

Crie 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 aquele ou crie um novo. Clique no botão Criar projeto.

Agora a construçã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 Firebase Console, selecione Visão geral do projeto no painel de navegação esquerdo 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, vá para o diretório do aplicativo e abra um nome de arquivo build.gradle . No arquivo, pesquise applicationId . Este 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 Login do Google ou o 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 Android Studio, vá para o diretório app e mova o arquivo google-services.json (que você acabou de baixar acima) para o diretório app . De volta ao console do Firebase, clique no botão Avançar.

Ative o Firebase no seu aplicativo

Você precisa do plugin Google Services Gradle para ler o arquivo google-services.json que foi gerado pelo Firebase.
No Android Studio, 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 SDK do Firebase ao seu aplicativo.

4. Adicione o SDK do Firebase ao seu aplicativo

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

Usaremos a BoM do Firebase Android, que permite gerenciar as versões da biblioteca do Firebase que você está usando em seu aplicativo, especificando a versão da BoM. Para saber quais versões da biblioteca do Firebase estão mapeadas para uma versão específica do BoM, verifique 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, ao especificar apenas a versão do BoM, você não precisa especificar a versão da biblioteca do Firebase Analytics. Mas se você quiser usar a versão desejada para sua biblioteca Firebase, independentemente da versão 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'

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 duas maneiras de registrar eventos: Usando eventos sugeridos ou eventos personalizados.

Usando 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 comércio eletrônico. Além disso, existem alguns eventos sugeridos que requerem 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 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 aplicativo:

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

Usando eventos personalizados

Se precisar de eventos não cobertos pelos eventos sugeridos, você poderá registrar seus próprios eventos personalizados com parâmetros personalizados:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

Eventos de depuração

Você pode visualizar dados agregados e relatórios sobre seus eventos no Console do Firebase. 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 dados de eventos registrados pelo seu aplicativo em dispositivos de desenvolvimento quase em tempo real. Para DebugView, consulte a seção de eventos 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

A configuração do Firebase-Android foi concluída e você está pronto para lançar a campanha de aplicativos com eventos de ação registrados. Você começará vinculando o Firebase ao Google Ads. Ao vincular o Firebase ao Google Ads, as campanhas para aplicativos poderão aprender mais sobre o público-alvo e aumentar o aprendizado das campanhas para aplicativos, o que geralmente leva a melhores desempenhos e conversões.

Vincular Firebase e Google Ads

Vá para Configurações do Firebase clicando no botão ao lado de Visão geral do projeto.

Na guia Integrações, você verá o Google Ads e um botão Link. Clique em Vincular e continuar.

Escolha a conta do Google Ads que você 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, acesse o Google Ads e faça login na conta que você vincula 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

Vá para a guia Campanhas para aplicativos 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 eventos. Escolha um(s) evento(s) em que você deseja se concentrar.

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 o ajudará a aumentar o desempenho de sua campanha.

Você aprendeu

Como configurar o Firebase Analytics para Android
Como registrar eventos com Firebase Analytics em um aplicativo Android.
Como importar eventos e utilizá-los para campanhas de ação.