Integra Google Analytics

La plataforma de Google Analytics te permite medir las interacciones de los usuarios con tu empresa en diversos dispositivos y entornos. Google Analytics proporciona los recursos para recopilar, almacenar, procesar e informar estas interacciones de usuarios.

Puedes recopilar estadísticas del cliente y del servidor.

Recopilación de estadísticas del cliente

Usa los SDK y las API de Google Analytics para medir cómo interactúan los usuarios con tu contenido y tus iniciativas de marketing. Puedes ver los datos sobre la interacción de los usuarios en la interfaz de usuario de Google Analytics o usar las API de informes para buscar los datos. Para obtener más información sobre la recopilación de estadísticas del cliente, selecciona el siguiente vínculo según el tipo de cliente:

  • Seguimiento web (analytics.js): Mide la interacción de los usuarios con las aplicaciones o los sitios web.
  • Android: Mide la interacción de los usuarios con las aplicaciones para Android.
  • iOS: Mide la interacción de los usuarios con las aplicaciones para iOS.
  • Protocolo de medición: Mide la interacción de los usuarios en cualquier entorno con este protocolo de nivel bajo.

Recopilación de estadísticas del servidor

Si bien App Engine brinda un mecanismo que permite registrar eventos en tu aplicación, puedes usar Google Analytics para realizar el seguimiento de los eventos específicos del servidor y hacer lo siguiente:

  • Analizar datos históricos: App Engine te permite configurar la cantidad máxima de días o de tamaño para tus archivos de registro. Tras superar ese límite, ya no tendrás acceso a esos archivos de registro. El seguimiento de eventos en Google Analytics te permite una visibilidad más prolongada de los eventos pasados.
  • Realizar seguimiento de eventos clave: Los archivos de registro pueden ser detallados y recibir datos de varios componentes de la aplicación. Si usas el seguimiento de eventos, puedes identificar los eventos clave y seguirlos, junto con algunos metadatos.
  • Trabajar en la interfaz de usuario: Aprovecha la amplia interfaz de usuario que proporciona Google Analytics para visualizar, informar y exportar estos eventos del servidor.

Para habilitar la recopilación de estadísticas del servidor, puedes usar un cliente HTTP y realizar solicitudes HTTP con el Protocolo de medición de Google Analytics. Si deseas obtener más información, consulta la guía para desarrolladores de Google Analytics sobre el seguimiento de eventos.

Aplicación de muestra

La siguiente aplicación de muestra te enseña a realizar el seguimiento de eventos en tu aplicación de App Engine. La aplicación realiza una solicitud HTTP y publica datos sobre el evento en Google Analytics.

Antes de usar el Protocolo de medición de Google Analytics en App Engine, sigue estos pasos:

  1. Crea una propiedad Universal Analytics y obtén el ID de seguimiento.

  2. Incluye las variables de entorno en app.flexible.yaml con el ID de seguimiento. Por ejemplo, en la aplicación de muestra que se presenta a continuación, se usa la siguiente variable:

    env_variables:
      GA_TRACKING_ID: YOUR_TRACKING_ID
  3. Antes de ejecutar la aplicación de muestra de manera local, configura las variables de entorno siguientes que requiere la aplicación:

    export GA_TRACKING_ID=YOUR_TRACKING_ID
    npm install
    
  4. Ejecuta el código de muestra de manera local con la línea de comandos; Por ejemplo:

    npm start
    

  5. Integra el siguiente código en tu aplicación de App Engine para publicar datos del seguimiento de eventos en Google Analytics:

    const express = require('express');
    const fetch = require('node-fetch');
    
    const app = express();
    app.enable('trust proxy');
    
    // The following environment variable is set by app.yaml when running on App
    // Engine, but will need to be set manually when running locally. See README.md.
    const {GA_TRACKING_ID} = process.env;
    
    const trackEvent = (category, action, label, value) => {
      const data = {
        // API Version.
        v: '1',
        // Tracking ID / Property ID.
        tid: GA_TRACKING_ID,
        // Anonymous Client Identifier. Ideally, this should be a UUID that
        // is associated with particular user, device, or browser instance.
        cid: '555',
        // Event hit type.
        t: 'event',
        // Event category.
        ec: category,
        // Event action.
        ea: action,
        // Event label.
        el: label,
        // Event value.
        ev: value,
      };
    
      return fetch('http://www.google-analytics.com/debug/collect', {
        params: data,
      });
    };
    
    app.get('/', async (req, res, next) => {
      // Event value must be numeric.
      try {
        await trackEvent(
          'Example category',
          'Example action',
          'Example label',
          '100'
        );
        res.status(200).send('Event tracked.').end();
      } catch (error) {
        // This sample treats an event tracking error as a fatal error. Depending
        // on your application's needs, failing to track an event may not be
        // considered an error.
        next(error);
      }
    });
    
    const PORT = parseInt(process.env.PORT) || 8080;
    app.listen(PORT, () => {
      console.log(`App listening on port ${PORT}`);
      console.log('Press Ctrl+C to quit.');
    });
    

Si habilitaste la configuración en tu Consola del administrador de Google Analytics para excluir el tráfico de arañas y bots, o si usas Google Analytics 4 (que filtra este tráfico automáticamente), es posible que no veas resultados de Analytics de clientes de App Engine. Estas situaciones filtran el usuario-agente predeterminado de App Engine. Para ver los resultados de App Engine, incluye el parámetro ua en tus datos de seguimiento y configúralo en un valor personalizado.