En este documento, se describe cómo puedes administrar el envío de datos a Google Analytics con el SDK de Google Analytics para iOS v2.
Descripción general
En el SDK de Google Analytics para iOS, los datos recopilados, como las visitas a una pantalla o los eventos, se almacenan de forma local en una cola antes de enviarse a los servidores de Google Analytics. El proceso por el cual estos datos (denominados aquí como “hits”) se envían desde el SDK a Google Analytics se conoce como despacho.
El despacho es exclusivo de las bibliotecas de colecciones para dispositivos móviles y está diseñado para mitigar los desafíos del acceso poco confiable a la red y la duración limitada de la batería.
Existen dos tipos de despacho:
- Despacho periódico : envía automáticamente los hits en el intervalo recurrente que especifiques.
- Despacho manual : Envía hits de forma manual para enviar datos cuando te resulte conveniente (por ejemplo, cuando hay una conexión HTTP existente).
En el resto de este documento, se proporcionará una descripción detallada de cada tipo de despacho y cómo implementarlos en tu app.
Despacho periódico
A medida que tu app recopila datos de Google Analytics, estos se agregan a una cola y se envían de forma periódica a Google Analytics. El envío periódico puede ocurrir cuando la app se ejecuta en primer o segundo plano.
El período de envío predeterminado es de 2 minutos.
Puedes proporcionar tu propio intervalo en segundos llamando a setDispatchPeriod:(NSTimeInterval), como en este ejemplo:
[[GAI sharedInstance] setDispatchPeriod:60];
Si estableces un valor negativo, se inhabilitarán los envíos periódicos, por lo que deberás usar el envío manual si deseas 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 envíen todos los hits, los envíos periódicos ingresarán en un modo de ahorro de energía y se inhabilitarán hasta que se realice otra llamada de envío.
Si un usuario pierde el acceso a la red o sale de tu app mientras aún hay hits en espera de despacho, esos hits persisten en el almacenamiento local. Se enviarán la próxima vez que se ejecute tu app y se llame al despacho.
Despacho manual
Además de depender de los envíos periódicos, puede haber ocasiones en las que desees despachar tus hits de forma manual. Por ejemplo, puedes empaquetar tus despachos con otras solicitudes HTTP que realice tu aplicación para reducir la sobrecarga.
Los hits se pueden enviar de forma manual llamando a dispatch, como se muestra a continuación:
[[GAI sharedTracker] dispatch];