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

1. Introducción

Última actualización: 14/12/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 acción a través de Google Ads.

A través de este codelab, puedes experimentar todo el proceso de negocio de apps que enfrentan nuestros clientes. Si quieres obtener una introducción más breve 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. Iniciar un nuevo proyecto de Swift en iOS

Crea una app de iOS Swift simple a partir de una plantilla. Modificarás esta app inicial para crear la app final.

Primero, inicia Xcode.

1. Si no tienes proyectos abiertos, selecciona Crear un proyecto de Xcode nuevo en la página de bienvenida.
2. Selecciona iOS en la parte superior del diálogo.
3. En la sección Aplicación, selecciona App y, luego, haz clic en Siguiente.
4. En el diálogo que aparece, usa los siguientes valores para nombrar tu app y elegir opciones adicionales para tu proyecto. Luego, haz clic en Siguiente:
5. Nombre del producto: p.ej., ios-app

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

2. Equipo: Si este campo no se completa automáticamente, establezca el equipo en None.
3. Nombre de la organización: El nombre de tu organización o el tuyo propio.
4. Identificador del paquete: Este valor se genera automáticamente en función del nombre del producto y el identificador de la organización.
5. Idioma: Swift
6. Selecciona una ubicación para guardar el proyecto y haz clic en Crear.
7. Xcode abre tu 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.

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 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 asigna 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 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 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 iOS en General > Tus apps

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

2. El valor importante que debes proporcionar es el ID del paquete de iOS, que obtendrás en el siguiente paso.
3. En el proyecto de Xcode para la app para iOS, selecciona la app de nivel superior en el navegador del proyecto y, luego, la pestaña General.
4. El valor del campo del identificador del paquete es el ID del paquete de iOS (similar a com.yourcompany.yourproject). Copia este valor.
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. Ve al proyecto de Xcode y 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 dependencias. Si nunca usaste CocoaPods, primero debes instalarlo ejecutando este comando en la terminal:

$ sudo gem install cocoapods

1. Abre una ventana de terminal y navega hasta 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 la clase principal AppDelegate.

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
  ])

Establece 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
])

Cómo ver 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 y, así, 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 tu app, tus eventos se mostrarán en la consola de depuración de Xcode, lo que te ayudará a verificar de inmediato que se envíen los eventos.

Visualiza eventos en el panel

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

Marcarás "text_search" como conversión deslizando el interruptor "Marcar como conversión" a la derecha.

Puedes comprobar 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

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, vaya a Google Ads y acceda a su 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 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 cuadro desplegable para que Google Ads se enfoque 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 y Google Ads. Esto te ayudará a mejorar el rendimiento de tu campaña.

Instalaste la secuencia de comandos, creaste y preparaste una nueva lista de cambios del codelab, actualizaste y preparaste 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.