Como desarrollador, puedes usar Google Tag Manager para implementar y administrar píxeles y etiquetas de medición en tus aplicaciones para dispositivos móviles, sin tener que volver a compilar y volver a enviar los objetos binarios de la aplicación a los mercados de apps. Los desarrolladores que trabajan con el SDK de Google Analytics para Firebase pueden agregar fácilmente Tag Manager para administrar la implementación y realizar cambios en ella, 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 deben activarse.
Requisitos previos
- En Firebase console, agrega la app al proyecto de Firebase.
- Configura Google Analytics para tu app, lo que incluye habilitar Google Analytics en tu proyecto de Firebase y agregar el SDK de Google Analytics para Firebase a tu app.
- Crea una cuenta de Tag Manager.
- Configure un contenedor de Tag Manager.
En las siguientes secciones, se explican los pasos para configurar y usar Google Tag Manager en tu aplicación para iOS.
1. Agrega Tag Manager a tu proyecto
Agrega el paquete de Tag Manager:
CocoaPods
Para agregar Tag Manager mediante CocoaPods, haz lo siguiente:
En una terminal, ejecuta el siguiente comando:
$ sudo gem install cocoapods
Cambia al directorio de tu proyecto.
Ejecuta el siguiente comando para crear un archivo llamado
Podfile
:$ pod init
En
Podfile
, agrega el siguiente código:pod 'GoogleTagManager', '~> 6.0'
Ejecuta el siguiente comando para descargar y, luego, 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:
- 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 ignorar este paso. - En Xcode 12, instala la biblioteca de Tag Manager. Para ello, navega a File > Tag Manager Packages > Add Package Dependency....
En el mensaje que aparece, ingresa el repositorio de GitHub de Tag Manager:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Selecciona la versión de Tag Manager que deseas utilizar. Para proyectos nuevos, te recomendamos usar la versión más reciente de Tag Manager.
Agrega
-ObjC
a Other Linker Flags en Build Settings (Configuración de compilación) de tu proyecto.
Crea un contenedor de iOS si tu cuenta de Tag Manager no tiene uno:
- Accede a tu cuenta de Tag Manager.
- Haz clic en ADMINISTRADOR en la barra de navegación superior.
- En la columna CONTAINER, haz clic en el menú desplegable y selecciona CREATE CONTAINER.
- Ingresa un nombre para el contenedor.
- Selecciona el contenedor de iOS.
- Selecciona el SDK de Firebase (iOS).
- Haz clic en CREAR.
Descarga el contenedor:
- Accede a tu cuenta de Tag Manager.
- Selecciona tu contenedor de iOS.
- Haz clic en Versiones en la barra de navegación superior.
Haz clic en Acciones > Descargar en la versión del contenedor seleccionada.
Agrega el contenedor descargado a tu proyecto:
- 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
). - Abre Xcode.
- En el menú Archivo, seleccione Agregar archivos a....
- Selecciona la carpeta
container
. - Haz clic en Options (Opciones) y asegúrate de que la opción Create folder reference (Crear referencias de carpetas) esté seleccionada.
- Haz clic en Finish.
- Copia el archivo descargado en una carpeta llamada
2. Registra eventos y variables
Tag Manager usa los eventos, los parámetros y las propiedades del usuario que registra el SDK de Google Analytics para Firebase para activar y compilar las etiquetas que configuraste en Google Tag Manager.
Consulta la documentación para desarrolladores de Firebase y obtén instrucciones para registrar eventos y establecer propiedades del usuario.
Cómo configurar variables en Tag Manager
Si deseas 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, podrías 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 para
capturar los valores image_name
y full_text parameter
:
- Nombre de la variable: Nombre de la imagen
- Tipo de variable: Parámetro del evento
- Nombre de la clave de parámetro del evento:
image_name
y:
- Nombre de la variable: Texto completo
- Tipo de variable: Parámetro del evento
- Nombre de la clave de parámetro del evento:
full_text
Del mismo modo, 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 favorite_food
:
- Nombre de la variable: Alimento favorito
- Tipo de variable: Propiedad de usuario de Firebase
- Nombre de la clave de parámetro del evento:
favorite_food
Cómo modificar y bloquear eventos
Tag Manager te permite modificar y bloquear eventos antes de que los registre el SDK de Google Analytics para Firebase. 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 bloquearlo.
3. Enviar 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 del activador se evalúan cada vez que registras un evento de Firebase. Según la configuración 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 a fin de bloquear el envío de eventos a Google Analytics.
4. Obtén una vista previa de tu contenedor, depura y publícalo
Antes de publicar una versión de tu contenedor, te recomendamos obtener 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 mediante la generación de vínculos y códigos QR en la interfaz web de Tag Manager y su uso para abrir tu aplicación.
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:
- Accede a tu cuenta de Tag Manager.
- Selecciona un contenedor para dispositivos móviles.
- Haz clic en Versiones en la barra de navegación superior.
- Haz clic en Acciones > Vista previa en la versión del contenedor de la que deseas obtener una vista previa.
- Ingresa el nombre del paquete de tu aplicación.
Haz clic en Generar vínculo para comenzar la vista previa.
Guarda esta URL de vista previa para los pasos posteriores.
Para habilitar las vistas previas de contenedores, 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_
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 la aplicación.
Contenedor de depuración
Cuando ejecutas tu app en un simulador o en modo de vista previa, Tag Manager cambia automáticamente el registro detallado.
Publicar contenedor
Después de obtener una vista previa del contenedor y verificar que funciona, puedes publicarlo. Después de publicar el contenedor, los parámetros de configuración de tus etiquetas estarán disponibles para los usuarios de la app para dispositivos móviles.