Etiquetado del servidor para aplicaciones para dispositivos móviles

Puedes configurar tus aplicaciones para dispositivos móviles con el SDK de Google Analytics para Firebase para que funcionen con el etiquetado del servidor en Google Tag Manager.

El etiquetado del servidor te permite preparar, ocultar y aumentar tus datos antes de enviarlos a productos de destino, como Google Analytics. Obtén más información sobre el etiquetado del servidor.

Para configurar el etiquetado del servidor para apps para dispositivos móviles, sigue estos pasos:

1. Prepara tu app para el etiquetado del servidor
2. Configura tu contenedor de servidor para admitir el tráfico móvil
3. Habilita el etiquetado del servidor en tu propiedad GA4

Requisitos previos

• Debes incluir el SDK de Google Analytics para Firebase en tu app y conéctalo a tu propiedad de Google Analytics 4. Obtén más información sobre el SDK de Google Analytics para Firebase.
• Necesitas una cuenta de Google Tag Manager y un contenedor de servidor. Si no tienes una, crea una cuenta y un contenedor de Tag Manager.
• Debes configurar un servidor de etiquetado.

Paso 1: Prepara tu app para el etiquetado del servidor

iOSAndroid

1. Habilita la función de carga de etiquetado del servidor y configura el esquema de URL personalizado para el modo de depuración de etiquetado del servidor en el archivo Info.plist. Reemplaza el BUNDLE_ID en el siguiente código por el identificador del paquete de la app.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. Para habilitar el modo de depuración o de vista previa, agrega una llamada a Analytics.handleOpen(_:) en un método de ciclo de vida para pasar la URL de lanzamiento.

   SwiftUIUIScene
   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   En el caso de las apps que no usan SwiftUI ni UIScene, no se requiere ninguna acción. El SDK recibe la URL de lanzamiento de ApplicationDidFinishLaunchingNotification.

1. Instala la versión más reciente del SDK de Google Analytics para Firebase.

2. Para habilitar sGTM, agrega lo siguiente al archivo AndroidManifest.xml de la aplicación.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

Paso 2: Configura el contenedor de servidor para admitir tráfico móvil

En la siguiente sección, se supone que tienes una implementación de etiquetado del servidor existente y que conoces sus conceptos. Si es la primera vez que usas el etiquetado del servidor, puedes realizar el curso sobre los conceptos básicos del etiquetado del servidor.

Configura el cliente de Google Analytics: GA4 (aplicación)

Un cliente es un tipo de recurso de Tag Manager que intercepta ciertos tipos de solicitudes entrantes y genera eventos que se pueden pasar a un destino, como Google Analytics 4. En este caso, la solicitud HTTP es un evento de Google Analytics 4, por lo que debes configurar el cliente integrado de Google Analytics: GA4 (app). Solo necesitas un cliente de GA4 por fuente de datos, como el SDK de GA y el sitio web. Obtén más información sobre cómo funcionan los clientes.

1. En el contenedor de tu servidor, ve a Clientes y haz clic en Nuevo.

2. Haz clic en Configuración del cliente y, luego, selecciona Google Analytics: GA4 (aplicación).

   

3. Ingresa un nombre para tu cliente y haz clic en Guardar.

Configura tu etiqueta de Google Analytics: GA4

Para enviar datos a Google Analytics, deberás crear una etiqueta Google Analytics: GA4 en el contenedor de servidor. El cliente analiza la solicitud HTTP entrante en un objeto de datos de evento. La etiqueta tomará este objeto de datos de evento, lo asignará al formato correcto y, luego, lo enviará a Google Analytics 4.

1. En el contenedor de servidor, ve a Etiquetas y haz clic en Nueva.

2. Haz clic en Configuración de la etiqueta y, luego, elige Google Analytics: GA4.

   

De forma predeterminada, la etiqueta heredará todos los campos y parámetros relevantes del objeto de datos de eventos que creó el cliente:

• Si la solicitud entrante de Google Analytics 4 pasa por el cliente Google Analytics: GA4 (aplicación), la etiqueta hereda el ID de aplicación y los parámetros de evento.
• Si las solicitudes entrantes de Google Analytics 4 pasan por el cliente Google Analytics: GA4 (Web), la etiqueta hereda el ID de medición y los parámetros de evento.

Sugerencia: De manera opcional, puedes usar transformaciones para incluir, excluir o modificar el resultado de los parámetros de eventos de tu cliente antes de que se expongan a las etiquetas. Con las transformaciones, puedes proteger la información sensible y tener un control detallado sobre qué parámetros de eventos están disponibles para un procesamiento adicional.

Configura activadores para el tráfico móvil

Luego, debes establecer cuándo se debe activar la etiqueta de GA4. El cliente de Google Analytics: GA4 (aplicación) analiza la solicitud entrante en un objeto de datos de evento, y la etiqueta heredará sus valores. Por lo tanto, por lo general, querrás que la etiqueta se active cada vez que el cliente de GA4 reclame la solicitud.

Para configurar los activadores, sigue estos pasos:

1. En la configuración de la etiqueta, haz clic en Activación.
2. Para crear un activador nuevo, haz clic en el ícono + en la esquina superior derecha.
3. Haz clic en Configuración del activador para elegir el tipo de activador.

4. Elige Personalizado o Evento personalizado en la lista.

   • De forma predeterminada, el tipo Activador personalizado activa la etiqueta cuando un cliente del servidor genera cualquier evento.
   • El tipo de activador Evento personalizado se puede usar para activar la etiqueta en un nombre de evento específico o en un evento que coincida con un patrón de expresión regular.

5. Para habilitar la lista de condiciones de activación de este activador, por ejemplo, para que se active únicamente en los datos de eventos web o para dispositivos móviles, selecciona Algunos eventos.

   1. Verás que la opción Nombre del evento está preseleccionada. Haz clic en ese selector y selecciona Elegir variable integrada en la lista.
   2. Para mostrar automáticamente el nombre del cliente que generó el evento, selecciona Nombre del cliente.

   3. Usa el nombre del cliente que configuraste antes para establecer la condición según corresponda. El activador debería verse de la siguiente manera:

      

      Nota: El nombre del cliente es el que especificaste en el paso anterior. El tipo de cliente es Google Analytics: GA4 (aplicación). La variable Nombre del cliente muestra el nombre y no el tipo del cliente.

6. Guarda el activador y, luego, ingresa un nombre descriptivo. Por ejemplo, puedes usar "Todos los eventos de aplicación de GA4".

7. Deberías volver a la configuración de la etiqueta con el nuevo activador en su lugar. Guarda la etiqueta y, luego, ingresa un nombre descriptivo, por ejemplo, "GA4". Tu etiqueta debería verse de la siguiente manera:

   

Sugerencia: Para omitir que ciertos eventos se envíen, puedes usar activadores personalizados con lógica condicional basada en el nombre del evento (o alguna otra variable) o agregar excepciones de activadores. Obtén más información sobre cómo activar activadores y excepciones.

Obtén una vista previa de tu contenedor

Puedes usar Google Tag Manager para obtener una vista previa de tu contenedor de servidor y depurarlo antes de publicar los cambios. Ten en cuenta que la vista previa no funcionará hasta que habilites el etiquetado del servidor en tu propiedad GA4.

Para que las solicitudes de tu app activen la configuración de la versión preliminar, debes hacer lo siguiente:

1. Selecciona Vista previa en el contenedor de servidor de Google Tag Manager.
2. Haz clic en el ícono Más acciones ⋮ en la esquina superior derecha y selecciona Enviar solicitudes desde una app.

3. Ingresa el ID de tu app y haz clic en Generate QR Code.

   

4. Escanea el código QR con la app de cámara del teléfono. Continúa interactuando con la app como lo harías normalmente para generar eventos de vista previa.

5. Haz clic en Aceptar para cerrar el cuadro de diálogo.

Publica tu contenedor

Después de verificar los cambios, publica el contenedor para que se publiquen para todo el tráfico. Obtén más información sobre publicaciones, versiones y aprobaciones.

Paso 3: Habilita el etiquetado del servidor en tu propiedad GA4

1. En tu propiedad Google Analytics 4, ve a Administrador.
2. Abre Flujos de datos.

3. Selecciona la configuración de transmisión de tu aplicación en la pestaña iOS o Android.

   

4. Haz clic en Configurar la configuración del SDK y, luego, en Configurar Tag Manager del servidor.

   

5. Para permitir que el SDK envíe datos de medición a la URL del contenedor de servidor, haz lo siguiente:

   1. Activa la opción Enviar datos a un contenedor de Tag Manager del servidor.
   2. Copia la URL del contenedor de servidor. Puedes encontrar esta información en Google Tag Manager. Para ello, ve a Administrador > Configuración del contenedor > URLs del contenedor del servidor.

   3. Selecciona el porcentaje de tráfico que deseas enrutar al contenedor del servidor. Puedes elegir una opción inferior al 100% para validar la configuración del servidor antes de usar el etiquetado del servidor para todo tu tráfico.

      Nota: Usa la opción Solo dispositivos de depuración para permitir que solo las apps que se abren con el modo de vista previa envíen datos a tu servidor.

   

6. Haz clic en Guardar. El SDK recuperará la URL del contenedor de servidor actualizada y le dirigirá los datos de medición.

Limitaciones conocidas

• En el caso de las aplicaciones para Android:

  • Las compras directas desde la aplicación registradas automáticamente dependen de la integración con el backend de Google Play y no se enviarán al contenedor de servidores.
  • No se informará el evento app_remove en Android.

• Aún es necesario conectar tus flujos de datos de aplicación de Google Analytics a tu cuenta de Google Ads para garantizar que tus conversiones y datos del SDK se importen a Google Ads. La etiquetación del servidor no ofrece ninguna integración inherente entre tu SDK y Google Ads.

Nota: El SDK de Google Analytics para Firebase está diseñado y optimizado para enviar datos a Google Analytics 4. Luego, Google Analytics 4 se puede vincular a Google Ads para generar informes de conversiones, crear públicos, optimizar campañas y realizar modelado. Esto incluye el etiquetado del servidor para aplicaciones, y recomendamos a los clientes que aprovechen la integración entre Google Analytics y el etiquetado del servidor en Google Tag Manager.

API

Puedes usar la API de REST de Tag Manager para acceder a los datos de configuración de Tag Manager. Para obtener más información sobre la API, consulta lo siguiente:

• Consulta la Guía para desarrolladores para aprender a trabajar con la API.
• Revisa la referencia de la API de Tag Manager para familiarizarte con los recursos y las operaciones disponibles de Tag Manager.