Google Ads con Google Analytics para eventos personalizados de Firebase - Android

1. Introducción

Última actualización: 2020-12-14

lo que vas a construir

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

Este codelab se enfoca en implementar eventos con GA4F e importar los eventos en Google Ads. Si desea obtener información sobre cómo crear una aplicación de Android con Firebase, consulte Firebase Android Codelab-Build Friendly Chat .

lo que aprenderás

• Cómo crear un proyecto de Firebase
• Cómo implementar Firebase SDK en la aplicación de Android
• Cómo crear eventos y parámetros.
• Cómo importar eventos de Firebase a Google Ads
• Lance campañas de acción de Google Ads con eventos personalizados.

Lo que necesitarás

• Android Studio 3.6 o superior
• Cuenta de base de fuego
• Cuenta de anuncios de Google

2. Crea y configura un proyecto de Firebase

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

Crear un proyecto de Firebase

1. Inicie sesión en Firebase .

En la consola de Firebase, haga clic en Agregar proyecto (o Crear un proyecto) y asigne el nombre que desee a su proyecto de Firebase.

2. Haga clic en las opciones de creación de proyectos. Acepte los términos de Firebase si se le solicita. Debe habilitar Google Analytics para este proyecto, ya que necesita eventos de Google Analytics para realizar un seguimiento de los eventos de acción y las conversiones.

Para obtener más información sobre los proyectos de Firebase, consulte Comprender los proyectos de Firebase .

3. Elija la cuenta de Google Analytics. Si tiene uno, elija ese o cree uno nuevo. Haga clic en el botón Crear proyecto.

4. ¡Ahora la compilación del proyecto Firebase ha terminado!

En el próximo paso, aprenderá cómo agregar Firebase a su aplicación de Android.

3. Agregue Firebase a su aplicación de Android

Registrar aplicación

1. En Firebase Console, seleccione Descripción general del proyecto en el panel de navegación izquierdo, luego haga clic en el botón de Android en "Comience agregando Firebase a su aplicación".

2. Complete la información necesaria.

Para el nombre del paquete de Android, en el estudio de Android, vaya al directorio de la aplicación, abra un nombre de archivo build.gradle . En el archivo, busque applicationId . Este valor es el nombre del paquete de Android. Copie este valor y péguelo.

No necesitamos la clave SHA-1 aquí, a menos que planee usar Google Sign In o Firebase Dynamic Links (tenga en cuenta que estos no son parte de este laboratorio de programación; para obtener más información sobre la clave SHA-1, consulte este documento ). .

Sugerencia : lea Establecer el ID de la aplicación para obtener más información sobre los ID de aplicaciones y paquetes.

3. Haga clic en el botón Registrar aplicación.

Descargar archivo de configuración

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

2. En el estudio de Android, vaya al directorio app y mueva el archivo google-services.json (que acaba de descargar arriba) al directorio de la app . Regrese a la consola Firebase, haga clic en el botón Siguiente.

Habilite Firebase en su aplicación

1. Necesita el complemento Gradle de Google Services para leer el archivo google-services.json que generó Firebase.
2. En Android Studio, abra <project>/build.gradle y luego agregue las siguientes líneas en el 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
      ...
      }
   }
}

3. Abra <project>/<app-module>/build.gradle , luego agregue las siguientes líneas en el archivo:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Ahora, ha completado la adición de Firebase a su aplicación de Android.

En el siguiente paso, aprenderá a agregar el SDK de Firebase a su aplicación.

4. Agregue Firebase SDK a su aplicación

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

Usaremos la BoM de Android de Firebase, que le permite administrar las versiones de la biblioteca de Firebase que está usando en su aplicación especificando la versión de la BoM. Para saber qué versiones de la biblioteca de Firebase están asignadas a una versión de BoM específica, consulte las notas de la versión de esa versión de BoM.

1. Abra <project>/<app-module>/build.gradle , luego agregue las siguientes líneas en el 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 puede ver, al especificar solo la versión de BoM, no necesita especificar la versión de la biblioteca de análisis de firebase. Pero si desea utilizar la versión deseada para su biblioteca de Firebase, independientemente de la versión designada en el BoM, solo necesita especificar la versión deseada de esta 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'

2. Ahora sincronice su aplicación haciendo clic en el botón Sync Now .

Ahora, ha completado la adición de Firebase SDK para Google Analytics a su aplicación de Android.

En el siguiente paso, aprenderá a registrar eventos de Firebase en su aplicación de Android.

5. Registrar eventos con Firebase Analytics

En este paso, aprenderá a registrar eventos con Firebase Analytics en la aplicación de Android.

Hay 2 formas de registrar eventos: Usar eventos sugeridos o eventos personalizados.

Uso de eventos sugeridos

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

1. Declare el objeto FirebaseAnalytics en la parte superior de la actividad:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Inicializa el objeto en el método onCreate() :

firebaseAnalytics = Firebase.analytics

3. Comience a registrar eventos con el método logEvent() . El siguiente código registra un evento de COMPRA cuando un usuario compra un artículo en la aplicación:

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

Uso de eventos personalizados

Si necesita eventos que no están cubiertos por los eventos sugeridos, puede registrar sus propios eventos personalizados con parámetros personalizados:

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

Eventos de depuración

Puede ver datos agregados e informes sobre sus eventos en la consola de Firebase. Pero las actualizaciones se realizan periódicamente a lo largo del día, no puede ver esos eventos inmediatamente después de iniciar sesión en su aplicación.

Para fines inmediatos de prueba y depuración, puede usar Firebase Debugview. DebugView le permite ver los datos de eventos registrados por su aplicación en dispositivos de desarrollo casi en tiempo real. Para DebugView, consulte la sección de eventos de depuración .

¡Ahora ha completado el registro de eventos en su aplicación de Android!

En el próximo paso, aprenderá a importar esos eventos a Google Ads.

6. Importa eventos de Firebase a Google Ads

Su configuración de Firebase-Android ha finalizado y está listo para lanzar la campaña de aplicaciones con eventos de acción registrados. Comenzará vinculando Firebase con Google Ads. Al vincular Firebase con Google Ads, las campañas de aplicaciones podrán obtener más información sobre las audiencias y aumentar el aprendizaje de las campañas de aplicaciones, lo que generalmente conduce a un mejor rendimiento y conversiones.

Vincular Firebase y Google Ads

1. Vaya a Configuración de Firebase haciendo clic en el botón junto a Descripción general del proyecto.

2. En la pestaña Integraciones, verá Google Ads y un botón de enlace. Haga clic en Vincular y continuar.

3. Elija la cuenta de Google Ads que desea vincular.

Ahora ha completado la vinculación de Firebase y Google Ads. Importemos eventos de Firebase a Google Ads.

Importar eventos de Firebase

1. En la consola de Firebase, vaya al menú Eventos y marque el evento que desea importar como una conversión.

Precaución: si el evento objetivo no está marcado como conversión, Google Ads no podrá importarlo. Asegúrate de que el evento esté correctamente marcado como conversión.

2. Ahora, vaya a Google Ads e inicie sesión en la cuenta que vincula con Firebase.
3. En Google Ads, ve a Herramientas → Medición → Conversiones
4. Haga clic en el botón +
5. Elija Aplicación → Propiedades de Google Analytics 4 (Firebase) y haga clic en continuar.
6. Puede ver todos los eventos de análisis que están marcados como conversiones. Busque el evento que desea importar. En este caso, elija el evento delete_item que hemos implementado antes. Haga clic en el botón Importar y continuar.
7. Ha importado correctamente un evento de conversión de Firebase.

Ahora ha completado la importación de eventos de Firebase a Google Ads.

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

7. Lanzamiento de campañas de acción de aplicaciones con eventos importados

Importante: para lanzar una campaña de aplicaciones, necesita una aplicación de nivel de producción en Google Play. Si no está listo para publicar la aplicación, deje este paso por ahora.

1. Vaya a la pestaña Campañas de aplicaciones en su cuenta actual de Google Ads e inicie una nueva campaña haciendo clic en el botón +.

2. Lanzaremos una campaña de promoción de aplicaciones con la opción de instalación de aplicaciones. En la parte inferior, elija la aplicación que desea promocionar y haga clic en continuar.
3. En la sección Ofertas, si selecciona Acciones en la aplicación en el menú desplegable, puede ver los eventos. Elija un evento o eventos en los que desee centrarse.

4. Establece el resto de ajustes de la campaña y listo.

8. Felicitaciones

Felicitaciones, ha integrado con éxito su Firebase y Google Ads. Esto le ayudará a aumentar el rendimiento de su campaña.

has aprendido

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