Google Tag Manager para iOS

Como desarrollador, puedes usar Google Tag Manager para implementar y administrar etiquetas y píxeles de medición en tus aplicaciones para dispositivos móviles sin tener que volver a compilar y enviar los archivos binarios de la aplicación a los mercados de aplicaciones. Los desarrolladores que trabajan con el SDK de Google Analytics para Firebase pueden agregar fácilmente Tag Manager para ayudar a administrar y realizar cambios en la implementación, incluso después de que se haya enviado la app.

Los desarrolladores pueden registrar eventos importantes y decidir más adelante qué etiquetas o píxeles se deben activar.

Requisitos previos

En las siguientes secciones, se te guiará por los pasos para configurar y usar Google Tag Manager en tu aplicación para iOS.

1. Agrega Tag Manager a tu proyecto

  1. Agrega el paquete de Tag Manager:

    CocoaPods

    Para agregar Tag Manager a través de CocoaPods, haz lo siguiente:

    1. En una terminal, ejecuta el siguiente comando:

      $ sudo gem install cocoapods

    2. Cambia al directorio de tu proyecto.

    3. Ejecuta el siguiente comando para crear un archivo llamado Podfile:

      $ pod init

    4. En Podfile, agrega lo siguiente:

      pod 'GoogleTagManager', '~> 6.0'

    5. Ejecuta el siguiente comando para descargar e instalar las dependencias de Tag Manager en tu proyecto:

      $ pod install

    Swift Package Manager

    Para agregar Tag Manager a través de Swift Package Manager, haz lo siguiente:

    1. Si migras desde un proyecto basado en CocoaPods, ejecuta pod deintegrate para quitar CocoaPods de tu proyecto de Xcode. El archivo .xcworkspace generado por CocoaPods se puede borrar después de forma segura. Si es la primera vez que agregas Firebase a un proyecto, puedes omitir este paso.
    2. En Xcode 12, instala la biblioteca de Tag Manager. Para ello, navega a File > Tag Manager Packages > Add Package Dependency…

    3. En el mensaje que aparece, ingresa el siguiente repositorio de Tag Manager en GitHub:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git

    4. Selecciona la versión de Tag Manager que deseas usar. Para los proyectos nuevos, te recomendamos que uses la versión más reciente de Tag Manager.

    5. Agrega -ObjC a Other Linker Flags en la Build Settings de tu proyecto.

  2. Crea un contenedor de iOS si tu cuenta de Tag Manager no tiene uno:

    1. Accede a tu cuenta de Tag Manager.
    2. En la pestaña Cuentas, selecciona tu contenedor de iOS.
    3. Haz clic en Administrador en la barra de navegación superior.
    4. En la columna CONTENEDOR, haz clic en el ícono "+" para crear un contenedor.
    5. Ingresa un nombre para el contenedor.
    6. Selecciona el contenedor iOS.
    7. Haz clic en Crear.

  3. Descarga tu contenedor:

    1. Accede a tu cuenta de Tag Manager.
    2. En la pestaña Cuentas, selecciona tu contenedor de iOS.
    3. Haz clic en Versiones en la barra de navegación superior.
    4. Selecciona la versión del contenedor que deseas descargar.

    5. Haz clic en Descargar.

  4. Agrega el contenedor descargado a tu proyecto:

    1. Copia el archivo descargado en una carpeta llamada container en la raíz del proyecto de XCode (por lo general, PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. Abre Xcode.
    3. En el menú Archivo, elige Agregar archivos a...
    4. Selecciona la carpeta container.
    5. Haz clic en Opciones y asegúrate de que esté seleccionada la opción Crear referencias de carpetas.
    6. Haz clic en Finalizar.

2. Registra eventos y variables

Tag Manager usa eventos, parámetros y propiedades del usuario registrados por el SDK de Google Analytics para Firebase para activar y compilar las etiquetas que configuraste en Google Tag Manager.

Lee la documentación para desarrolladores de Firebase para obtener instrucciones sobre cómo registrar eventos y configurar las propiedades del usuario.

Configura variables en Tag Manager

Para capturar el valor de los parámetros de eventos y las propiedades del usuario para usarlos en Google Tag Manager, puedes configurar variables en la interfaz de Tag Manager.

Por ejemplo, puedes registrar el siguiente evento personalizado en tu app:

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

Luego, puedes configurar nuevas variables de parámetros de eventos en Tag Manager de la siguiente manera para capturar los valores de image_name y full_text parameter:

  • Nombre de la variable: Image Name
  • Tipo de variable: Parámetro del evento
  • Nombre de clave del parámetro del evento: image_name

y:

  • Nombre de la variable: Full Text
  • Tipo de variable: Parámetro del evento
  • Nombre de clave del parámetro del evento: full_text

De manera similar, puedes configurar la siguiente propiedad del usuario en tu app:

Analytics.setUserProperty(food, forName: "favorite_food")

Luego, puedes configurar una nueva variable de propiedad del usuario de Firebase en Google Tag Manager para capturar el valor de favorite_food:

  • Nombre de la variable: Favorite Food
  • Tipo de variable: Propiedad del usuario de Firebase
  • Nombre de clave del parámetro del evento: favorite_food

Modifica y bloquea eventos

Tag Manager te permite modificar y bloquear eventos antes de que el SDK de Google Analytics para Firebase los registre. La modificación de eventos puede ayudarte a agregar, quitar o cambiar los valores de los parámetros de eventos o ajustar los nombres de los eventos sin actualizaciones de la app. El SDK de Google Analytics para Firebase registrará los eventos que no estén bloqueados.

El SDK de Google Analytics para Firebase también registra automáticamente algunos eventos y propiedades del usuario. Puedes usar eventos y propiedades recopilados automáticamente en Tag Manager sin necesidad de agregar código. Sin embargo, no puedes bloquearlos.

3. Envía eventos

Las variables de nombre de evento de Firebase, las variables de parámetros de eventos de Firebase y otras variables se usan para configurar activadores. Las condiciones de activación se evalúan cada vez que registras un evento de Firebase. De forma predeterminada, los eventos de Google Analytics para Firebase se activan automáticamente. Es posible agregar una etiqueta de Google Analytics para Firebase en Tag Manager para evitar que los eventos se envíen a Google Analytics.

4. Obtén una vista previa de tu contenedor, depúralo y publícalo

Antes de publicar una versión de tu contenedor, te recomendamos que obtengas una vista previa para asegurarte de que funcione según lo previsto. Tag Manager te permite obtener una vista previa de las versiones de tu contenedor generando vínculos y códigos QR en la interfaz web de Tag Manager y usándolos para abrir tu aplicación.

Obtén una vista previa del contenedor

Para obtener una vista previa de un contenedor, genera una URL de vista previa en la interfaz web de Tag Manager:

  1. Accede a tu cuenta de Tag Manager.
  2. Selecciona un contenedor para dispositivos móviles.
  3. Haz clic en Versiones en la barra de navegación superior.
  4. Haz clic en Acciones > Vista previa en la versión del contenedor de la que deseas obtener una vista previa.
  5. Ingresa el nombre del paquete de tu aplicación.

  6. Haz clic en Generar vínculo de vista previa inicial.

    Las URLs de vista previa están disponibles en la ventana de vista previa de la interfaz web de Tag Manager.

    Figura 1: Cómo obtener una URL de vista previa de la interfaz web de Tag Manager.

    Guarda esta URL de vista previa para los pasos posteriores.

Para habilitar las vistas previas del contenedor, debes definir el esquema de URL de vista previa de Tag Manager en la lista de propiedades de tu proyecto. En Tipos de URL del archivo de lista de propiedades de tu aplicación, registra el siguiente identificador de URL y esquema de URL:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Registra el esquema de URL de vista previa de Tag Manager en el archivo de lista de propiedades de tu aplicación.
Figura 2: Agrega el esquema de URL de vista previa de Tag Manager al archivo de lista de propiedades de tu aplicación.

Detén tu aplicación y abre la URL de vista previa en un emulador o dispositivo físico para obtener una vista previa del contenedor de borrador en tu aplicación.

Depura el contenedor

Cuando ejecutas tu app en un simulador o en el modo de vista previa, Tag Manager activa automáticamente el registro en modo detallado.

Publica el contenedor

Después de obtener una vista previa de tu contenedor y verificar que funciona, puedes publicarlo. Una vez que lo publiques, las configuraciones de etiquetas estarán disponibles para los usuarios de la app para dispositivos móviles.

Lee Configuración avanzada.