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

1. Introducción

Última actualización: 2020-12-14

lo que construirás

En este codelab, 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 centra en implementar eventos con GA4F e importar los eventos en Google Ads. Si desea aprender cómo crear una aplicación para 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
• Lanza campañas de acción de Google Ads con eventos personalizados.

Lo que necesitarás

• Android Estudio 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. Inicia sesión en Firebase .

En Firebase console, haga clic en Agregar proyecto (o Crear un proyecto) y nombre su proyecto de Firebase como desee.

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 las acciones 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 finalizado!

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

3. Agrega Firebase a tu aplicación de Android

Registrar aplicación

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

2. Complete la información necesaria.

Para el nombre del paquete de Android, en Android Studio, vaya al directorio de la aplicación y abra un archivo llamado 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 utilizar el inicio de sesión de Google o los enlaces dinámicos de Firebase (tenga en cuenta que estos no forman parte de este codelab; para obtener más información sobre la clave SHA-1, consulte este documento ). .

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

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 Android Studio, vaya al directorio app y mueva el archivo google-services.json (que acaba de descargar arriba) al directorio de la app . De regreso a la consola de Firebase, haga clic en el botón Siguiente.

Habilite Firebase en su aplicación

1. Necesita el complemento Google Services Gradle para leer el archivo google-services.json generado por 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 y 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 has completado la adición de Firebase a tu aplicación de Android!

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

4. Agregue el SDK de Firebase a su aplicación

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

Usaremos la BoM de Firebase para Android, 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 y 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 la 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, sin importar qué versión esté designada en la lista de materiales, 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á cómo registrar eventos de Firebase en su aplicación de Android.

5. Registre eventos con Firebase Analytics

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

Hay dos formas de registrar eventos: mediante eventos sugeridos o eventos personalizados.

Usar eventos sugeridos

El SDK de Firebase Analytics define una serie de eventos sugeridos que se pueden usar en varios tipos de aplicaciones, como juegos, venta 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. Inicialice 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")
}

Usando 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

Puedes ver datos agregados e informes sobre tus eventos en Firebase console. 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 de prueba y depuración inmediatas, puede utilizar 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 Evento de depuración .

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

En el siguiente paso, aprenderá cómo importar esos eventos a Google Ads.

6. Importe eventos de Firebase a Google Ads

La configuración de Firebase-Android finalizó y está listo para lanzar la campaña de aplicaciones con eventos de acción registrados. Comenzarás vinculando Firebase a Google Ads. Al vincular Firebase con Google Ads, las campañas de aplicaciones podrán obtener más información sobre las audiencias y mejorar 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 justo al lado de 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 Firebase console, vaya al menú Eventos y marque el evento que desea importar como conversión.

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

2. Ahora, vaya a Google Ads e inicie sesión en la cuenta que vinculó con Firebase.
3. En Google Ads, vaya 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. Has importado correctamente un evento de conversión desde Firebase.

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

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

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

Importante: Para lanzar una campaña de aplicaciones, necesitas una aplicación de nivel de producción en Google Play. Si no estás listo para publicar la aplicación, deja 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 Instalaciones de aplicaciones. En la parte inferior, elija la aplicación que desea promocionar y haga clic en continuar.
3. En la sección Oferta, si selecciona Acciones en la aplicación en el menú desplegable, puede ver eventos. Elija un evento en el que desee centrarse.

4. Establezca el resto de la configuración de la campaña y listo.

8. Felicitaciones

¡Felicitaciones, ha integrado exitosamente Firebase y Google Ads! Esto le ayudará a mejorar 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 utilizarlos para campañas de acción.