Eventos personalizados de Google Ads con Google Analytics para Firebase: Android

1. Introducción

Última actualización: 14/12/2020

Qué compilarás

En este codelab, aprenderás a implementar eventos con Google Analytics para Firebase (GA4F) y a lanzar campañas de acción a través de Google Ads.

Este codelab se enfoca en la implementación de eventos con GA4F y en la importación de eventos en Google Ads. Si quieres aprender a compilar una app para Android con Firebase, consulta el codelab de Firebase para Android: compila un chat amigable.

Qué aprenderás

  • Cómo crear un proyecto de Firebase
  • Cómo implementar el SDK de Firebase en una app para Android
  • Cómo crear eventos y parámetros
  • Cómo importar eventos de Firebase a Google Ads
  • Lanza campañas de acción de Google Ads con eventos personalizados.

Requisitos

  • Android Studio 3.6 o una versión posterior
  • Cuenta de Firebase
  • Cuenta de Google Ads

2. Crea y configura un proyecto de Firebase

Para comenzar con Firebase, deberás crear y configurar un proyecto de Firebase.

Crea un proyecto de Firebase

  1. Accede a Firebase.

En Firebase console, haz clic en Agregar proyecto(o Crear un proyecto) y asigna el nombre que desees a tu proyecto de Firebase.

8525e77df3536fbb.png

  1. Haz clic para avanzar por las opciones de creación de proyectos. Si se te solicita, acepta las condiciones de Firebase. Debes habilitar Google Analytics para este proyecto, ya que necesitas eventos de Google Analytics para realizar un seguimiento de los eventos de acción y analizar las conversiones.

e58151a081f0628.png

Para obtener más información sobre los proyectos de Firebase, consulta la Información sobre los proyectos de Firebase.

  1. Elige la cuenta de Google Analytics. Si tienes uno, elige ese o crea uno nuevo. Haz clic en el botón Crear proyecto.

ac928e5947ba7cbf.png

  1. Ya finalizó la compilación del proyecto de Firebase.

En el siguiente paso, aprenderás a agregar Firebase a tu app para Android.

3. Agrega Firebase a tu app para Android

Registra una app

  1. En Firebase console, selecciona Descripción general del proyecto en el panel de navegación izquierdo y, luego, haz clic en el botón de Android en “Comienza por agregar Firebase a tu app”.

6cbb33ad3e7c9132.png

  1. Completa la información necesaria.

3b7d3b33d81fe8ea.png

Como nombre del paquete de Android, en Android Studio, ve al directorio de la app y abre un archivo llamado build.gradle. En el archivo, busca applicationId. Este valor es el nombre del paquete de Android. Copia este valor y pégalo.

No necesitamos la clave SHA-1 en este caso, a menos que planees usar el Acceso con Google o Firebase Dynamic Links (ten en cuenta que estos vínculos no forman parte de este codelab; para obtener más información sobre la clave SHA-1, consulta este documento).

  1. Haz clic en el botón Registrar aplicación.

Descarga el archivo de configuración

  1. Haz clic en el botón Descargar google-services.json para descargar el archivo de configuración google-services.json.

52f08aa18c8d59d0.png

  1. En Android Studio, ve al directorio app y mueve el archivo google-services.json (que acabas de descargar) al directorio app. En Firebase console, haz clic en el botón Siguiente.

Habilita Firebase en tu app

  1. Necesitas el complemento de Gradle para los servicios de Google para leer el archivo google-services.json que generó Firebase.
  2. En Android Studio, abre <project>/build.gradle y, luego, agrega las siguientes líneas al archivo:
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
      ...
      }
   }
}
  1. Abre <project>/<app-module>/build.gradle y, luego, agrega las siguientes líneas al archivo:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Ya agregaste Firebase a tu app para Android.

En el siguiente paso, aprenderás a agregar el SDK de Firebase a tu app.

4. Agrega el SDK de Firebase a tu app

En este paso, agregarás el SDK de Firebase, específicamente el SDK de Firebase para Google Analytics.

Utilizaremos la BoM de Firebase para Android, que te permite administrar las versiones de las bibliotecas de Firebase que usas en tu app. Para ello, especifica la versión de la BoM. Para saber qué versiones de la biblioteca de Firebase se asignan a una versión específica de la BoM, consulta las notas de la versión de la BoM.

  1. Abre <project>/<app-module>/build.gradle y, luego, agrega las siguientes líneas al archivo:
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 puedes ver, cuando especificas solo la versión de la BoM, no es necesario que especifiques la versión de la biblioteca de Firebase Analytics. Sin embargo, si quieres usar la versión deseada para tu biblioteca de Firebase sin importar qué versión esté designada en la BoM, solo debes especificar la versión deseada de la siguiente manera:

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'
  1. Ahora, haz clic en el botón Sync Now para sincronizar tu app. 937206076c88ae5c.png

Ya agregaste el SDK de Firebase para Google Analytics a tu app para Android.

En el siguiente paso, aprenderás a registrar eventos de Firebase en tu app para Android.

5. Registra eventos con Firebase Analytics

En este paso, aprenderás a registrar eventos con Firebase Analytics en la app para Android.

Existen 2 maneras de registrar eventos: con eventos sugeridos o personalizados.

Cómo usar los eventos sugeridos

El SDK de Firebase Analytics define una cantidad de eventos sugeridos que se pueden usar en varios tipos de apps, como videojuegos, venta minorista, viajes y comercio electrónico. También hay algunos eventos sugeridos que requieren sus parámetros prescritos y, con esos parámetros, puedes maximizar los detalles disponibles en tus informes de Firebase. ( Referencia de eventos sugeridos)

  1. Declara el objeto FirebaseAnalytics en la parte superior de la actividad:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. Inicializa el objeto en el método onCreate():
firebaseAnalytics = Firebase.analytics
  1. Comienza a registrar eventos con el método logEvent(). El siguiente código registra un evento PURCHASE cuando un usuario compra artículos en la app:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

Cómo usar eventos personalizados

Si necesitas eventos que no están cubiertos por los eventos sugeridos, puedes registrar tus propios eventos personalizados con parámetros personalizados:

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

Eventos de depuración

Puedes ver informes y datos agregados sobre tus eventos en Firebase console. Sin embargo, las actualizaciones se realizan periódicamente a lo largo del día, por lo que no puedes ver esos eventos inmediatamente después de haber accedido a ellos en tu app.

Para la prueba y depuración inmediatas, puedes usar Firebase DebugView. DebugView te permite ver los datos de eventos registrados por la app en dispositivos de desarrollo casi en tiempo real. Para DebugView, consulta la sección Cómo depurar un evento.

Ya completaste el registro de eventos en tu app para Android.

En el siguiente paso, aprenderás a importar esos eventos a Google Ads.

6. Importar eventos de Firebase a Google Ads

Finalizó la configuración de Firebase para Android. Ya está todo listo para que lances la campaña de aplicaciones con los eventos de acción registrados. Comenzarás por vincular Firebase a Google Ads. Si vinculas Firebase a Google Ads, las campañas de aplicaciones podrán obtener más información sobre los públicos y potenciar el aprendizaje de las campañas de aplicaciones, lo que suele generar un mejor rendimiento y conversiones.

  1. Ve a la configuración de Firebase. Para ello, haz clic en el botón que se encuentra junto a Descripción general del proyecto.

412830708c61fdc0.png

  1. En la pestaña Integraciones, verás Google Ads y un botón para vincular. Haz clic en Vincular y continuar.

796c921fb2b873ae.png

  1. Elige la cuenta de Google Ads que deseas vincular.

Ya terminaste de vincular Firebase y Google Ads. Importemos los eventos de Firebase a Google Ads.

Importar eventos de Firebase

  1. En Firebase console, ve al menú Eventos y marca el evento que deseas importar como conversión.

A5f302ba01a1863c.png

  1. Ahora, ve a Google Ads y accede a la cuenta que vinculaste con Firebase.
  2. En Google Ads, ve a Herramientas → Medición → Conversiones. 8acf268d7e799a7e.png
  3. Haga clic en el botón + d0eed72946d038d8.png.
  4. Selecciona Aplicación → Propiedades Google Analytics 4 (Firebase) y haz clic en Continuar. 983f06edb15724de.png
  5. Puedes ver todos los eventos de Analytics que están marcados como conversiones. Busca el evento que quieres importar. En este caso, elige el evento delete_item que hayamos implementado antes. Haz clic en el botón Importar y continuar. f9bdee80c0d40999.png
  6. Importaste correctamente un evento de conversión desde Firebase. be75f6a11913236.png

Ahora ya completaste la importación de eventos de Firebase a Google Ads.

En el siguiente paso, aprenderás a iniciar una campaña de acción con el evento que acabas de importar.

7. Lanzamiento de campañas de acciones en la aplicación con eventos importados

  1. Ve a la pestaña Campañas de aplicaciones de tu cuenta actual de Google Ads y haz clic en el botón + para iniciar una campaña nueva.

19856a65ab999ad7.png

  1. Lanzaremos una campaña de promoción de aplicación con la opción de instalaciones de aplicaciones. En la parte inferior, elige la aplicación que deseas promocionar y haz clic en Continuar. 8146b5a7a4f961bd.png
  2. En la sección Ofertas, si seleccionas Acciones en la aplicación en el menú desplegable, puedes ver los eventos. Elige los eventos en los que deseas enfocarte.

b75e410c7dbdfec8.png

  1. Establece el resto de la configuración de la campaña y listo.

8. Felicitaciones

Felicitaciones, integraste correctamente Firebase y Google Ads. Esto te ayudará a mejorar el rendimiento de tu campaña.

Aprendiste lo siguiente:

  • Cómo configurar Firebase Analytics para Android
  • Cómo registrar eventos con Firebase Analytics en una app para Android
  • Cómo importar eventos y usarlos para campañas de acción.