Como desarrollador, puedes usar Google Tag Manager para implementar y administrar etiquetas de medición y píxeles 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. Desarrolladores que con el SDK de Google Analytics para Firebase pueden agregar fácilmente Tag Manager ayudar a administrar y realizar cambios en la implementación, incluso después de que la app se haya enviado.
Los desarrolladores pueden registrar eventos importantes y decidir luego qué etiquetas o píxeles despedirse.
Requisitos previos
Antes de comenzar:
- En Firebase console, agrega la app al proyecto de Firebase.
- Configura Google Analytics para tu app, incluida la habilitación de Google Analytics. en tu proyecto de Firebase y agregar el SDK de Google Analytics para Firebase tu app.
- Crea 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
En el archivo Gradle de tu módulo (por lo general,
app/build.gradle
), agrega lo siguiente: de la biblioteca de Tag Manager:dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.1.0' }
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 la versión del contenedor que deseas usar.
Haz clic en Descargar.
Crea la carpeta
app/src/main/assets/containers
si no existe. Copiar el contenedor descargado en la carpeta.
2. Registra eventos y variables
Tag Manager utiliza eventos, parámetros y propiedades del usuario que registra el servicio SDK de Analytics para Firebase para activar y compilar las etiquetas que configuraste Google Tag Manager
Lee la documentación para desarrolladores de Firebase a fin de obtener instrucciones para hacer lo siguiente: registrar eventos y establecer propiedades del usuario.
Cómo configurar variables en Tag Manager
Para captar 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:
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 como
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 clave del parámetro del evento:
image_name
y:
- Nombre de la variable: texto completo
- 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:
mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);
Luego, podrías configurar una nueva variable de propiedad del usuario de Firebase en la etiqueta de Google.
Administrador para capturar el valor favorite_food
:
- Nombre de la variable: Comida favorita
- Tipo de variable: Propiedad del usuario de Firebase
- Nombre de clave del 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. Modificar eventos puede ayudarte a agregar, quitar cambiar los valores de los parámetros de eventos o ajustar los nombres de los eventos sin actualizaciones de apps Google Analytics para Firebase registrará los eventos que no estén bloqueados. de Google Cloud.
El SDK de Google Analytics para Firebase también registra automáticamente algunos eventos y propiedades del usuario. Puedes usar propiedades y eventos recopilados automáticamente en Tag Manager sin necesidad de agregar ningún código. Sin embargo, no puedes bloquearlos.
3. Envía eventos
Variables de nombre de evento de Firebase, variables de parámetros de evento de Firebase y otras se usan para configurar activadores. Se evalúan las condiciones de activación cada vez que registras un evento de Firebase. De forma predeterminada, Google Analytics para Firebase eventos se activan automáticamente. Puedes agregar una cuenta de Google Analytics para Firebase etiqueta en Tag Manager para bloquear el envío de eventos a Google Analytics.
4. Cómo obtener una vista previa de tu contenedor, depurarlo y publicarlo
Antes de publicar una versión de tu contenedor, deseas obtener una vista previa para hacer para asegurarte de que funcione según lo previsto. Google Tag Manager te permite obtener una vista previa de tu contenedor generando vínculos y códigos QR en la interfaz web y usarlos para abrir tu aplicación. También puedes habilitar un registro detallado para depurar cualquier comportamiento inesperado.
Vista previa del contenedor
Antes de obtener una vista previa de un contenedor, genera una URL de vista previa en Google Tag Manager interfaz web seleccionando la versión del contenedor del que deseas obtener una vista previa y, luego, selecciona Vista previa. Guarda esta URL de vista previa para pasos posteriores.
![Las URLs de vista previa están disponibles en la ventana de vista previa de la etiqueta
Interfaz web del administrador](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/images/preview_example.png?authuser=3&hl=es-419)
Para obtener una vista previa del contenedor (si usas Android Studio, ve al paso 3):
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>
Cambia esta línea para que incluya el nombre del paquete de tu aplicación:
<data android:scheme="tagmanager.c.com.example.app"/>
En la interfaz web de Google Tag Manager, genera un vínculo de vista previa:
- 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 que deseas vista previa.
- Ingresa el nombre del paquete de tu aplicación.
- Haz clic en Generate start preview link.
Detén la solicitud y usa el vínculo o el código QR de vista previa generado para lo siguiente: iniciar la aplicación.
Puede salir del modo de vista previa haciendo clic en un vínculo generado por el Generate end preview link en la interfaz web.
Contenedor de depuración
Para solucionar problemas en la implementación del 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 funciona, puedes publicarla. Después de publicar tu contenedor, los parámetros de configuración de tu etiqueta estarán disponibles para los usuarios de aplicaciones para dispositivos móviles.