Eventos personalizados de Google Ads con Google Analytics para Firebase - Unity

1. Introducción

Última actualización: 19/02/2021

Qué compilarás

En este codelab, aprenderás a implementar eventos personalizados con GA4F para iOS en el entorno de Unity y a lanzar campañas de acciones a través de Google Ads.

A lo largo de este codelab, podrás experimentar todo el proceso de negocio de apps al que se enfrentan nuestros clientes. Si quieres obtener una introducción más sencilla a Firebase y AdMob en iOS, comienza con AdMob+Firebase 101 Unity: Configuración y conceptos básicos de Analytics.

Qué aprenderás

• Cómo inicializar GA4F (Google Analytics para Firebase) en Unity y iOS
• Cómo crear eventos y parámetros personalizados
• Cómo importar eventos de Firebase a Google Ads
• Cómo lanzar campañas de acciones con eventos personalizados.

Requisitos

• Xcode
• Unity
• Cuenta de Firebase
• Cuenta de Google Ads

2. Cómo iniciar un nuevo proyecto de Unity

Crea una app de Unity simple con plantilla. Luego, modifica esta app simple para crear la app final.

Inicia Unity

1. Si no tienes proyectos abiertos, selecciona la opción para crear uno nuevo.
2. Selecciona plantillas 3D en el cuadro de diálogo.
3. Completa el nombre del proyecto: p. ej., Unity Firebase Custom Event.
4. Selecciona una ubicación para guardar tu proyecto y haz clic en CREAR.
5. Unity abrirá el proyecto nuevo en la ventana del lugar de trabajo.

3. Crea y configura un proyecto de Firebase

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

Si ya tienes un proyecto de Firebase que no tiene habilitado Google Analytics, puedes habilitarlo en la pestaña Integraciones de la configuración > Configuración del proyecto. Continúa con el paso de configuración de Firebase.

1. Accede a Firebase.

En Firebase console, haz clic en Agregar proyecto (o Crear un proyecto) y asígnale el nombre Firebase-iOS-Ads.

2. Haz clic en las opciones de creación del proyecto. 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.

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

4. Configuración de Unity

1. En Unity > File > Build Settings. El valor importante es establecer el ID del paquete de iOS, que obtendrás en el siguiente paso.

Verás el diálogo que se muestra en la siguiente pantalla:

2. En tu proyecto de Unity para la app para iOS, abre el diálogo Build Settings, File > Build Settings (si la plataforma no está configurada en iOS, puedes seleccionar la plataforma iOS y hacer clic en el botón Switch Platform).

3. Después del cambio de plataforma, haz clic en el botón Configuración del reproductor para establecer el ID del paquete. Puedes ver el campo de texto en el área de Identification.
4. El valor del campo Bundle Identifier es el ID del paquete de iOS (similar a com.yourcompany.yourproject). Copia este valor o configura el tuyo y cópialo.
5. En el diálogo de Firebase, pega el ID del paquete que copiaste en el campo iOS bundle ID.
6. Haga clic en Registrar app.
7. En Firebase, sigue las instrucciones para descargar el archivo de configuración GoogleService-Info.plist.
8. Abre la ventana Project de tu proyecto de Unity y transfiere los archivos de configuración a la carpeta Assets.
9. Omite los pasos restantes y regresa a la página principal de Firebase console.

5. Configura Firebase Analytics en Unity

En este paso, comenzarás a agregar el SDK de Firebase a tu proyecto de Unity.

1. Dirígete a Firebase console.
2. En el centro de la página de descripción general del proyecto, haz clic en el ícono de Unity ( ) para iniciar el flujo de trabajo de configuración. Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de plataforma.
3. Selecciona el destino de compilación de tu proyecto de Unity que quieres registrar. También puedes registrar ambos destinos a la vez.

Nota: Si solo registras un destino de compilación de tu proyecto de Unity ahora, puedes volver al flujo de trabajo de configuración más adelante para registrar el otro.

4. Ingresa los IDs específicos de la plataforma del proyecto de Unity.

• iOS: Ingresa el ID de iOS de tu proyecto de Unity en el campo ID del paquete de iOS.
• Para Android: Ingresa el ID de Android de tu proyecto de Unity en el campo Nombre del paquete de Android. En general, los términos ID de la aplicación y nombre del paquete se utilizan de manera indistinta.

5. ¿Dónde se encuentra el ID de tu proyecto de Unity?

Nota: Asegúrate de ingresar el ID que usa tu proyecto realmente. En estas apps de Firebase, el valor del ID distingue mayúsculas de minúsculas, y no se puede cambiar después de registrarlas en el proyecto de Firebase.

6. Ingresa el sobrenombre específico de cada plataforma para tu proyecto de Unity (opcional). Los sobrenombres son identificadores internos y convenientes que solo tú puedes ver en Firebase console.
7. Haz clic en Registrar app.

Agrega los SDK de Firebase Analytics para Unity

1. En Firebase console, haz clic en Descargar el SDK de Firebase Unity y descomprímelo en el lugar que prefieras.

• Puedes volver a descargar el SDK de Firebase Unity cuando quieras.
• El SDK de Firebase Unity no es específico para cada plataforma.

2. Abre tu proyecto de Unity, ve a Recursos > Importar paquete > Paquete personalizado.
3. En el SDK descomprimido, selecciona los productos de Firebase admitidos que deseas usar en tu app.

• Agrega el paquete de Firebase para Google Analytics: FirebaseAnalytics.unitypackage.
• Agrega los paquetes de cualquier otro producto de Firebase que quieras usar en tu app. Por ejemplo, para usar Firebase Authentication y Firebase Realtime Database, agrega FirebaseAuth.unitypackage y FirebaseDatabase.unitypackage.

Unity 5.x y las versiones anteriores usan .NET Framework 3.x, de modo que debes importar el paquete dotnet3/. Unity 2017.x y las versiones posteriores permiten usar .NET Framework 4.x. Si tu proyecto de Unity usa .NET 4.x, importa el paquete dotnet4/. Unity 2019 y las versiones posteriores ya no son compatibles con .NET Framework 3.x, de modo que debes importar el paquete dotnet4/.

4. En la ventana Importar paquete de Unity, haz clic en Importar.
5. Vuelve a Firebase console y, en el flujo de trabajo de configuración, haz clic en Siguiente.

Importante: No inhabilites el swizzling de métodos con el SDK de Firebase Unity para iOS. El SDK requiere el swizzling. Sin él, las funciones clave de Firebase (como el control de token de FCM) no se ejecutan correctamente.

6. Registra eventos personalizados con Firebase Analytics

En este paso, aprenderás a registrar eventos personalizados con Firebase Analytics en la app de Unity para iOS.

Firebase Analytics registra automáticamente algunos eventos. No es necesario que agregues código para recibirlos. Si tu app debe recopilar datos adicionales, puedes registrar hasta 500 tipos de eventos personalizados de Analytics diferentes en ella.

Registra eventos

Después de configurar la instancia de FirebaseApp, puedes comenzar a registrar eventos con el método logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Visualiza eventos en la consola de depuración de Xcode

Puedes habilitar el registro detallado para supervisar el registro de eventos a través del SDK a fin de verificar que se registren correctamente. Esto incluye eventos registrados de manera automática y manual.

Puedes habilitar el registro detallado de la siguiente manera:

1. En Xcode, selecciona Product > Scheme > Edit scheme...
2. Selecciona Run en el menú de la izquierda.
3. Selecciona la pestaña Arguments.
4. En la sección Arguments Passed On Launch, agrega -FIRAnalyticsDebugEnabled.

La próxima vez que ejecutes la app, se mostrarán los eventos en la consola de depuración de Xcode, lo que te ayudará a verificar de inmediato que los eventos se están enviando.

Visualiza eventos en el panel

Verás tu evento registrado en Firebase console después de varias horas. Se encuentra en Analytics → Eventos. También puedes hacer clic en el evento para encontrar los valores de los parámetros.

Para marcar "text_search" como conversión, desliza el interruptor para marcar como conversión a la derecha.

Puedes verificar si el evento se marcó correctamente como conversión en la pestaña Conversiones de Firebase Analytics. Si marcas el evento como conversión, Google Ads también podrá importarlo como una conversión.

7. Importa eventos de estadísticas en Google Ads

Finalizó la configuración de Firebase para iOS, y está todo listo para que lances la campaña de aplicaciones con los eventos de acción registrados. Para comenzar, vincula 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 mejorar los aprendizajes de las campañas de aplicaciones, lo que suele generar un mejor rendimiento y más 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.
2. En la pestaña Integraciones, verás Google Ads y un botón de vinculación. Haz clic en Vincular y continuar.

3. Elige la cuenta de Google Ads.

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

Ya terminaste con Firebase.

Ahora, ve a Google Ads y accede.

1. Ve a Google Ads, accede a tu cuenta y ve a Herramientas y configuración → Medición → Conversiones para importar eventos personalizados como conversión.
2. Haz clic en el botón + para agregar una acción de conversión nueva.

3. Elige las propiedades de Google Analytics 4 (Firebase) y haz clic en Continuar.

4. Puedes ver todos los eventos de Analytics que están marcados como conversiones. Encuentra el evento clicked_counter que implementamos antes.

5. Haz clic en el botón Importar y continuar.

Después de configurar text_search como una acción de conversión, ahora es el momento de lanzar una campaña segmentada para usuarios que probablemente activarán eventos text_search.

8. Lanzamiento de las campañas de acciones de la app con eventos importados

Importante: Para lanzar una campaña de aplicaciones, necesitas una aplicación de nivel de producción en Google Play. Si aún no tienes todo listo para publicar la app, deja este paso por el momento.

6. Ve a la pestaña Campaña de tu cuenta actual y haz clic en el botón + para iniciar una campaña nueva. Haz clic en la campaña nueva y continúa.
7. Esta vez, lanzaremos una campaña de promoción de aplicación con la opción de instalaciones de aplicaciones.

8. Para encontrar tu app, proporciona el nombre de la app, el nombre del paquete o el publicador.
9. En la sección Ofertas, selecciona Acciones en la aplicación en el dropbox para que Google Ads se centre en las acciones.
10. Puedes encontrar tus eventos personalizados en la lista proporcionada. Establece el costo por acción objetivo y completa otras opciones.

11. Establece la configuración de la campaña. Esto estará fuera del alcance del codelab, así que consulta estos documentos o comunícate a través de cualquier otro canal para optimizar la configuración.

9. Felicitaciones

¡Felicitaciones! Integraste correctamente Firebase a Unity y Google Ads. Esto te ayudará a mejorar el rendimiento de tu campaña.

Aprendiste lo siguiente:

• Cómo configurar Firebase para la plataforma Unity iOS
• Cómo registrar eventos personalizados con Unity y Firebase Analytics
• Cómo importar eventos y usarlos para campañas de acción

Documentos de referencia

• Agrega Firebase a tu proyecto de Unity
• GitHub: firebase/quickstart-unity