Despacho: SDK de Android v2 (heredado)

En este documento, se describe cómo puedes administrar el envío de datos a Google Analytics con el SDK de Google Analytics para Android v2.

Descripción general

En el SDK de Google Analytics para Android, los datos recopilados, como las visitas a una pantalla o los eventos, se almacenan de forma local en una cola antes de enviarlos a los servidores de Google Analytics. El proceso mediante el cual se envían estos datos (denominados aquí “hits”) desde el SDK a Google Analytics se conoce como despacho.

El envío es exclusivo de las bibliotecas de colecciones para dispositivos móviles y está diseñado a fin de mitigar los desafíos de un acceso poco confiable a la red y una duración de batería limitada.

Existen dos tipos de envío:

  • Envío periódico: Destina automáticamente los hits a un intervalo recurrente que especifiques de manera programática o en tu archivo analytics.xml.
  • Envío manual: Destina de forma manual las hits para enviar datos cuando te resulte conveniente (por ejemplo, cuando hay una conexión HTTP existente).

Ambos tipos de despacho se realizan fuera del subproceso principal de la IU en la versión 2 del SDK.

En el resto de este documento, se proporcionará una visión más detallada de cada tipo de envío y de cómo implementarlo en tu app.

Despacho periódico

A medida que tu app recopila datos de Google Analytics, esos datos se agregan a una cola y se envían periódicamente a Google Analytics. El despacho periódico puede ocurrir cuando tu app se ejecuta en primer o segundo plano.

El período de envío predeterminado es de 30 minutos. Puedes proporcionar tu propio intervalo en segundos si usas el parámetro ga_dispatchPeriod en tu archivo analytics.xml o si llamas a setDispatchPeriod(int dispatchPeriodInSeconds), como en este ejemplo:

En el archivo analytics.xml, incluye lo siguiente:

<integer name="ga_dispatchPeriod">60</integer>

De manera programática:

GAServiceManager.getInstance().setDispatchPeriod(60);

Si configuras un valor negativo, se inhabilitará el envío periódico y deberás usar el envío manual si quieres enviar datos a Google Analytics. Por otro lado, configurar un valor de 0 enviará cada hit de inmediato si hay una conexión de red disponible.

Una vez que se despachan todos los hits, el envío periódico entrará en un modo de ahorro de energía y se inhabilitará hasta que se realice otra llamada de envío.

Si un usuario pierde el acceso a la red o cierra la app mientras aún hay hits que esperan despacharse, esos hits se conservan en el almacenamiento local. Se enviarán la próxima vez que se ejecute tu app y se llame al envío.

Despacho manual

Además de depender del envío periódico, puede haber ocasiones en las que desees despachar los hits de forma manual. Por ejemplo, puedes empaquetar tus envíos con otras solicitudes HTTP que realiza tu aplicación para reducir la sobrecarga.

Los hits se pueden enviar de forma manual mediante la instancia de GAServiceManager:

GAServiceManager.getInstance().dispatch();