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 los productos de destino, como Google Analytics. Obtén más información sobre el etiquetado del servidor.

Para configurar el etiquetado del servidor para aplicaciones para dispositivos móviles, haz lo siguiente:

1. Prepara tu app para el etiquetado del servidor
2. Configura tu contenedor del servidor para admitir el tráfico de dispositivos móviles
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 conectarlo 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 del 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

iOS

1. Habilita la función de carga de etiquetado del servidor y configura el esquema de URL personalizado para el modo de depuración del etiquetado del servidor en el archivo Info.plist. Reemplaza BUNDLE_ID en lo siguiente 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 inicio.

   SwiftUI

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

   UIScene

   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)
       }
     }
   }
   

   No se requiere ninguna acción para las apps que no usan SwiftUI o UIScene. El SDK recibe la URL de lanzamiento de ApplicationDidFinishLaunchingNotification.

Android

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" />
   

   Nota: <APP_PACKAGE_ID> debe estar en letras minúsculas. La verificación de coincidencia de esquemas en el framework de Android distingue entre mayúsculas y minúsculas, a diferencia del RFC.

Paso 2: Configura tu contenedor de servidor para que admita el tráfico de dispositivos móviles

En la siguiente sección, se supone que tienes una implementación existente del etiquetado del servidor y que conoces sus conceptos. Si no conoces el etiquetado del servidor, puedes completar el curso sobre 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 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 tu contenedor del 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 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 del evento. La etiqueta tomará este objeto de datos del evento, lo asignará al formato correcto y, luego, lo enviará a Google Analytics 4.

1. En tu contenedor del 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 pertinentes del objeto de datos del evento creado por el cliente:

• Si la solicitud entrante de Google Analytics 4 pasa por el cliente Google Analytics: GA4 (App), la etiqueta hereda el ID de la aplicación y los parámetros del 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 del evento.

Sugerencia: De manera opcional, puedes usar transformaciones para incluir, excluir o modificar los parámetros de eventos que genera 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 posterior procesamiento.

Configura activadores para el tráfico de dispositivos móviles

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 eventos, 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.

   • El tipo Activador personalizado, de forma predeterminada, 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, como activarse solo en datos de eventos web o para dispositivos móviles, selecciona Algunos eventos.

   1. Verás Nombre del evento preseleccionado. Haz clic en ese selector y elige Elegir variable integrada en la lista.
   2. Para devolver 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 Client Name devuelve el nombre y no el tipo de cliente.

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

7. Ahora deberías haber regresado 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 el envío de ciertos eventos, 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 los activadores y las excepciones de activación.

Obtén una vista previa de tu contenedor

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

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

1. Selecciona Vista previa en tu contenedor del servidor de Google Tag Manager.
2. Haz clic en el ícono de 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 Generar código QR.

   Nota: El ID de la app debe comenzar con una letra. Como alternativa, puedes usar cualquier ID único que comience con una letra, siempre y cuando coincida con el ID que se usa en el archivo Info.plist o AndroidManifest.xml.

   

4. Escanea el código QR con la app de cámara del teléfono. Luego, interactúa 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 apliquen a 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 parámetros 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 del 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 del servidor. Puedes encontrarlo en Google Tag Manager en 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 habilitar solo las apps que se abren con el modo de vista previa para enviar datos a tu servidor.

   

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

Limitaciones conocidas

• En el caso de las aplicaciones para Android, haz lo siguiente:

  • 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 del servidor.
  • No se registrará el evento app_remove en Android.

• Aún es necesario conectar tus flujos de datos de aplicación en Google Analytics a tu cuenta de Google Ads para garantizar que tus datos y conversiones del SDK se importen a Google Ads. El etiquetado 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 alentamos a los clientes a aprovechar 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 los siguientes recursos:

• Consulta la Guía para desarrolladores para obtener información sobre cómo trabajar con la API.
• Revisa la referencia de la API de Tag Manager para familiarizarte con los recursos de Tag Manager y las operaciones disponibles.