Envio – SDK para Android

Este documento descreve como você pode gerenciar o envio de dados ao Google Analytics por meio do SDK do Google Analytics para Android v3.

Visão geral

Os dados coletados por meio do SDK do Google Analytics para Android são armazenados localmente antes de serem enviados em uma sequência diferente ao Google Analytics.

Os dados precisam ser enviados e recebidos até as 4h do dia seguinte, no fuso horário local de cada Vista. Todos os dados recebidos após esse horário não serão exibidos nos relatórios. Por exemplo, se um hit entrar na fila localmente às 23h59, ele precisará ser enviado em até 4 horas, até às 3h59, para ser exibido nos relatórios. Por outro lado, um hit na fila às 12h precisa ser enviado dentro de 28 horas, ou seja, às 3h59 do dia seguinte para aparecer nos relatórios.

Envios periódicos

Por padrão, os dados são enviados do SDK do Google Analytics para Android a cada 30 minutos.

Para definir o período de envio programaticamente:

// Set the dispatch period in seconds.
GAServiceManager.getInstance().setLocalDispatchPeriod(15);

Para definir o período de envio em XML usando o EasyTracker:

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

Definir um valor negativo desativa o envio periódico, exigindo que você use o envio manual para transmitir dados ao Google Analytics.

// Disable periodic dispatch by setting dispatch period to a value less than 1.
GoogleAnalytics.getInstance(this).setDispatchPeriod(0);

Se um usuário perder acesso à rede ou sair do aplicativo enquanto ainda houver hits aguardando o envio, esses hits permanecerão no armazenamento local. Eles serão enviados na próxima vez que seu aplicativo for executado e que o envio for chamado.

Envios manuais

Para enviar hits manualmente, por exemplo, quando você sabe que o rádio do dispositivo já está sendo usado para enviar outros dados:

GAServiceManager.getInstance().dispatchLocalHits();