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

A través 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 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 simple de Swift para iOS con plantillas. Modificas esta app de partida para crear la app finalizada.

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 cuadro de diálogo que aparece, usa los siguientes valores para asignar un nombre a tu aplicación y elegir opciones adicionales para tu proyecto. Luego, haz clic en Siguiente :
5. Nombre del producto: p.ej., app-para-ios

Xcode usa el nombre de producto que ingresaste para asignarle un nombre al proyecto y a 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 tu 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 hacer 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, 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 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 has usado CocoaPods antes, primero debes instalarlo ejecutando este comando en tu terminal:

$ sudo gem install cocoapods

1. Abre una ventana de 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 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 necesitas agregar ningún código para recibirlas. Si tu aplicación debe recopilar datos adicionales, puedes registrar hasta 500 tipos diferentes de eventos personalizados de Analytics 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 todos los eventos con 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 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 > Esquema > Editar esquema...
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 tu evento registrado en Firebase console después de varias horas. Se encuentra en Analytics → Eventos. También puedes encontrar los valores de los parámetros haciendo clic en el evento.

Marcarás "text_search" como conversión deslizando el dedo para marcar como conversión. cambia 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. 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 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. Vaya a Google Ads, acceda a su cuenta y vaya 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 no tienes todo listo para publicar la app, deja este paso por ahora.

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. Haga clic en la nueva campaña y continúe.
7. Durante este período, lanzaremos una campaña de promoción de aplicaciones con la opción de instalación de aplicación.

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 y Google Ads. Esto te ayudará a mejorar el rendimiento de tu campaña.

Instalaste la secuencia de comandos, creaste y almacenaste en etapa intermedia una nueva lista de cambios del codelab, actualizaste y por etapas la lista de cambios del codelab pendiente, 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.