Dyspozycje – pakiet SDK na Androida

W tym dokumencie opisujemy, jak zarządzać przesyłaniem danych do Google Analytics za pomocą pakietu SDK Google Analytics na Androida w wersji 3.

Przegląd

Dane zbierane za pomocą pakietu SDK Google Analytics na Androida są przechowywane lokalnie, a następnie wysyłane w osobnym wątku do Google Analytics.

Dane należy wysłać i odebrać do 4:00 następnego dnia według lokalnej strefy czasowej każdego widoku. Dane odebrane później nie będą widoczne w raportach. Jeśli np. działanie jest umieszczone w kolejce o godzinie 23:59, musi zostać wysłane w ciągu 4 godzin, do 3:59, by pojawiło się w raportach. Natomiast działanie ustawione w kolejce o godzinie 00:00 musi zostać wysłane w ciągu 28 godzin, o 3:59 następnego dnia, aby dane mogły być uwzględniane w raportach.

Okresowa dostawa

Domyślnie dane są wysyłane z pakietu SDK Google Analytics na Androida co 30 minut.

Aby ustawić okres dostawy automatycznie:

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

Aby ustawić okres wysyłki w pliku XML za pomocą EasyTracker:

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

Ustawienie wartości ujemnej spowoduje wyłączenie okresowej wysyłki, co będzie wymagało wysyłki ręcznej, jeśli chcesz wysyłać dane do Google Analytics.

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

Jeśli użytkownik utraci dostęp do sieci lub zamknie aplikację, gdy są jeszcze działania oczekujące na wysłanie, te działania zostaną zachowane w pamięci lokalnej. Zostaną one wysłane przy następnym uruchomieniu aplikacji i wywołaniu metody wysyłania.

Wysyłanie ręczne

Aby ręcznie wysyłać działania, np. gdy wiesz, że radio urządzenia jest już używane do wysyłania innych danych:

GAServiceManager.getInstance().dispatchLocalHits();