Google Tag Manager para Android

Como desarrollador, puedes usar Google Tag Manager a fin de implementar y administrar etiquetas y píxeles de medición en tus aplicaciones para dispositivos móviles, sin tener que recompilar y volver a enviar los objetos binarios de aplicaciones a los mercados de apps. Los desarrolladores que trabajan con el SDK de Google Analytics para Firebase pueden agregar Tag Manager con facilidad a fin de ayudar a administrar y realizar cambios en la implementación, incluso después de que se envíe la app.

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

Requisitos previos

Antes de comenzar:

• 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.
• Cree una cuenta de Tag Manager.
• Configura un contenedor de Google Tag Manager.

En las siguientes secciones, se explican los pasos para configurar y usar Google Tag Manager en tu aplicación para Android.

1. Agrega Google Tag Manager a tu proyecto

1. En el archivo Gradle de tu módulo (por lo general, app/build.gradle), agrega la siguiente dependencia a la biblioteca de Tag Manager:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.0.2'
   }
   

2. Acceda a su cuenta de Tag Manager.

3. Selecciona un contenedor para dispositivos móviles.

4. Haz clic en Versiones en la barra de navegación superior.

5. Haz clic en Acciones > Descargar en la versión del contenedor seleccionado.

   

6. Crea la carpeta app/src/main/assets/containers si no existe. Copia el contenedor descargado en la carpeta.

2. Registra eventos y variables

Tag Manager usa eventos, parámetros y propiedades del usuario que registra el SDK de Google Analytics para Firebase para activar y compilar etiquetas que hayas configurado en Google Tag Manager.

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

Cómo configurar variables en Tag Manager

Si deseas capturar el valor de los parámetros de evento 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:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Luego, puedes configurar nuevas variables de parámetros de eventos en Tag Manager de la siguiente manera 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 del parámetro de evento: image_name

y:

• Nombre de la variable: Texto completo
• Tipo de variable: Parámetro del evento
• Nombre de la clave del parámetro de evento: full_text

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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

• Variable Name: Comida favorita
• Tipo de variable: Propiedad del usuario de Firebase
• Nombre de la clave del parámetro de evento: favorite_food

Cómo modificar y bloquear eventos

Tag Manager te permite modificar y bloquear eventos antes de que se registren en 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 a ajustar los nombres de los eventos sin actualizar 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. Enviar eventos

Las variables de nombre del evento de Firebase, las variables del parámetro de evento de Firebase y otras variables se usan para configurar los activadores. Las condiciones del activador 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 a fin de bloquear el envío de eventos a Google Analytics.

4. Obtén una vista previa, depura y publica tu contenedor

Antes de publicar una versión de tu contenedor, te recomendamos obtener una vista previa para asegurarte de que funcione según lo previsto. Google Tag Manager te ofrece la capacidad de 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, y los usa para abrir tu aplicación. También puedes habilitar un modo de registro detallado para depurar cualquier comportamiento inesperado.

Obtener vista previa del contenedor

Antes de obtener una vista previa de un contenedor, genera una URL de vista previa en la interfaz web de Google Tag Manager. Para ello, selecciona la versión del contenedor del que deseas obtener la vista previa y, luego, Vista previa. Guarda esta URL de vista previa para usarla en los próximos pasos.

Figura 1: Obtén una URL de vista previa desde la interfaz web de Tag Manager.

Para obtener una vista previa de tu contenedor (si usas Android Studio, ve al paso 3):

1. Agrega esta actividad de vista previa a tu archivo AndroidManifest:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. Cambia esta línea para incluir el nombre del paquete de tu aplicación:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. En la interfaz web de Google Tag Manager, genere un vínculo de vista previa:

   1. Acceda a su 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 la aplicación.
   6. Haz clic en Generar vínculo de vista previa de inicio.

4. Detén la aplicación y usa el vínculo de vista previa o el código QR generados para iniciarla.

5. Para salir del modo de vista previa, haz clic en un vínculo que generó la opción Generate end preview link en la interfaz web.

Contenedor de depuración

Para solucionar problemas en la implementación de tu contenedor, habilita el registro detallado:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Publicar contenedor

Después de obtener una vista previa del contenedor y verificar que funcione, puedes publicarlo. Después de que publiques el contenedor, las opciones de configuración de etiquetas estarán disponibles para los usuarios de apps para dispositivos móviles.

Nota: En los contenedores para dispositivos móviles, se usa un contenedor predeterminado con el fin de establecer la configuración inicial de las etiquetas hasta la primera vez que se descarga un contenedor. Una vez que la app se haya conectado a Internet y haya descargado un contenedor, nunca volverá a usar el contenedor predeterminado. Las aplicaciones verifican de forma periódica si hay actualizaciones del contenedor, por lo general, cada 12 horas.

Próximos pasos

Lee Configuración avanzada.