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

1. Introducción

Última actualización: 14 de diciembre de 2020

Qué compilarás

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

Con este codelab, puedes experimentar todo el proceso de negocios de aplicaciones que enfrentan nuestros clientes. Si quieres una introducción más sencilla a Firebase para iOS, comienza con el Codelab de Firebase para iOS en Swift.

Qué aprenderás

• Cómo inicializar GA4F (Google Analytics para Firebase) en iOS Swift
• 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
• Cuenta de Firebase
• Cuenta de Google Ads

2. Inicia un nuevo proyecto de iOS Swift

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

Primero, inicia Xcode.

1. Si no tienes proyectos abiertos, selecciona Create a new Xcode project en la página de bienvenida.
2. Selecciona iOS en la parte superior del diálogo.
3. En la sección Application, selecciona App y, luego, haz clic en Next.
4. En el diálogo que aparece, usa los siguientes valores para nombrar tu app y elegir opciones adicionales para tu proyecto, y haz clic en Next :
5. Product Name: Por ejemplo, ios-app

Xcode usa el nombre del producto que ingresaste para nombrar tu proyecto y la app.

2. Team: Si no se completa automáticamente, establece el equipo en None.
3. Organization Name: El nombre de tu organización o tu propio nombre.
4. Bundle Identifier: Este valor se genera automáticamente en función del nombre del producto y el identificador de la organización.
5. Language: Swift
6. Selecciona una ubicación para guardar tu proyecto y haz clic en Create.
7. Xcode abre 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.

Crea 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 Add proyect(o Create a proyect) y, luego, 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 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 Firebase

1. En Firebase console, selecciona Descripción general del proyecto > Configuración del proyecto en el panel de navegación izquierdo y, luego, haz clic en el botón de iOS en General > Tus apps.

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

2. El valor importante que se debe proporcionar es el ID del paquete de iOS, que obtendrás en el siguiente paso.
3. En tu proyecto de Xcode para la app para iOS, selecciona la app de nivel superior en el navegador del proyecto y, luego, accede a la pestaña General.
4. El valor del campo Bundle Identifier es el ID del paquete de iOS (algo como com.yourcompany.yourproject). Copia este valor.
5. En el diálogo de Firebase, pega el ID del paquete copiado en el campo iOS bundle ID.
6. Haz clic en Registrar app.
7. En Firebase, sigue las instrucciones para descargar el archivo de configuración GoogleService-Info.plist.

8. Ve a tu proyecto de Xcode y, luego, mueve el archivo GoogleService-Info.plist (que acabas de descargar) al directorio raíz de tu proyecto de Xcode.
9. Omite los pasos restantes y regresa a la página principal de Firebase console.

5. Configura Firebase Analytics en Xcode

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

Nota: Los servicios de Google usan CocoaPods para instalar y administrar las dependencias. Si nunca usaste CocoaPods, primero debes instalarlo ejecutando este comando en tu terminal:

$ sudo gem install cocoapods

1. Abre una ventana de la terminal y navega a la ubicación del proyecto Xcode de tu app.
2. Crear un Podfile si no tienes uno:

$ pod init

3. Abre tu Podfile y agrega lo siguiente :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Guarda el archivo y ejecuta lo siguiente :

$ pod install

5. Agrega el código de inicialización :

Para conectar Firebase cuando se inicie la app, agrega el siguiente código de inicialización a tu clase AppDelegate principal.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. ¡Listo! Ir a la consola

Ahora, estás listo para activar algunos registros de eventos personalizados.

6. Registra eventos personalizados con Firebase Analytics

En este paso, aprenderás a registrar eventos personalizados con Firebase Analytics en la app 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().

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Configura parámetros de eventos predeterminados

Puedes registrar parámetros en los eventos mediante setDefaultEventParameters. Los parámetros predeterminados se asocian con todos los eventos futuros que se registran.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

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 (Argumentos pasados al inicio), 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 ayuda 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 a través de 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á lista y puedes lanzar la campaña de aplicaciones con 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 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 a tu cuenta.

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 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 Importar y continuar.

Después de establecer text_search como una acción de conversión, es el momento de lanzar una campaña orientada a 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 estás 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, escribe el nombre de la app, el nombre del paquete o el publicador.
9. En la sección de 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 la campaña. Esto no está dentro del alcance del codelab, por lo que debes consultar estos documentos o comunicarte a través de cualquier otro canal para optimizar la configuración.

9. Felicitaciones

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

Instalaste la secuencia de comandos, creaste y organizaste una nueva lista de cambios del codelab, actualizaste y organizaste la lista de cambios pendiente del codelab, revisaste y aprobaste la lista de cambios del codelab, y enviaste y publicaste la lista de cambios del codelab.

Aprendiste lo siguiente:

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