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 acción a través de Google Ads.

A lo largo de este codelab, podrás experimentar todo el proceso del negocio de las 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 + 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. Inicia un proyecto nuevo de Unity

Crea una app de Unity simple a partir de una plantilla. Luego, modifica la app inicial para crear la app final.

Inicia Unity

1. Si no tienes proyectos abiertos, selecciona crear un proyecto nuevo.
2. Selecciona plantillas en 3D en el diálogo.
3. Completa el nombre del proyecto, p.ej., Evento personalizado de Firebase en Unity.
4. Selecciona una ubicación para guardar tu proyecto y haz clic en CREAR.
5. Unity abrirá tu proyecto nuevo en la ventana del espacio 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 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 a tu proyecto de Firebase.

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 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 como iOS, puedes seleccionar la plataforma iOS y hacer clic en el botón Switch Platform).

3. Después de cambiar de plataforma, haz clic en el botón Player Settings para establecer el ID del paquete. Puedes ver el campo de texto alrededor del área Identificación.
4. El valor del campo Bundle Identifier es el ID del paquete de iOS (similar a com.yourcompany.yourproject). Copia este valor o establece tu valor y cópialo.
5. En el diálogo de Firebase, pega el ID del paquete copiado 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 Proyecto 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. Ve 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 qué destino de compilación del proyecto de Unity quieres registrar. Si quieres registrar ambos destinos a la vez, este es el momento de hacerlo.

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 el ID del proyecto de Unity específico de cada plataforma.

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

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

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

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

Agrega los SDKs de Firebase Analytics para Unity

1. En Firebase console, haz clic en Descargar el SDK de Firebase Unity y, luego, 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 Assets > Import Package > Custom Package.
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: FirebaseAuth.unitypackage y FirebaseDatabase.unitypackage

Unity 5.x y las versiones anteriores usan .NET Framework 3.x, por lo 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, por lo que debes importar el paquete dotnet4/.

4. En la ventana Import Unity Package, haz clic en Import.
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 esta función. Sin ella, las funciones clave de Firebase (como el control de tokens de FCM) no funcionan correctamente.

6. Registra eventos personalizados con Firebase Analytics

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

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 el evento registrado en Firebase console en unas 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

La configuración de Firebase-iOS está completa y puedes lanzar la campaña de aplicaciones con eventos de acción registrados. Primero, debes 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 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 conversiones.
2. Haz clic en el botón + para agregar una nueva acción de conversión.

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. Marca la casilla y haz clic en el botón Importar y continuar.

Después de establecer text_search como una acción de conversión, es momento de lanzar una campaña segmentada para los 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 app de nivel de producción en Google Play. Si no tienes todo listo para publicar la app, omite 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. Por el momento, 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 menú desplegable 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. Configura los parámetros de configuración de la campaña. Esto no se incluirá en el codelab, por lo que deberás consultar estos documentos o comunicarte a través de cualquier otro canal para optimizar la configuración.

9. Felicitaciones

¡Felicitaciones! Integraste correctamente Firebase en 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 iOS de Unity
• 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