Bu dokümanda, Android v2 için Google Analytics SDK'sını kullanarak Google Analytics'e dağıtım verilerini nasıl yönetebileceğiniz açıklanmaktadır.
Genel bakış
Android için Google Analytics SDK'sında, ekran görüntülenmeleri veya etkinlikler gibi toplanan veriler, Google Analytics sunucularına gönderilmeden önce bir sırada yerel olarak depolanır. Bu veri parçalarının (burada "isabetler" olarak anılacaktır) SDK'dan Google Analytics'e gönderilme sürecine gönderme olarak da bilinir.
Gönderme, mobil koleksiyon kitaplıklarına özgü bir özelliktir ve güvenilir olmayan ağ erişimi ve sınırlı pil ömrü sorunlarını azaltmak için tasarlanmıştır.
İki tür gönderme vardır:
- Periyodik dağıtım : İsabetleri programatik olarak veya
analytics.xmldosyanızda belirttiğiniz yinelenen bir aralıklarla otomatik olarak dağıtır. - Manuel dağıtım : Sizin için uygun olduğunda (örneğin, mevcut bir HTTP bağlantısı olduğunda) veri göndermek için isabetleri manuel olarak dağıtın.
Her iki dağıtım türü de SDK'nın 2. sürümündeki ana kullanıcı arayüzü iş parçacığının dışında gerçekleşir
Bu belgenin geri kalanında, her bir dağıtım türü ve bunların uygulamanıza nasıl uygulanacağı ayrıntılı olarak açıklanmıştır.
Periyodik Sevkiyat
Uygulamanız GA verilerini topladıkça bu veriler bir sıraya eklenir ve düzenli olarak Google Analytics'e gönderilir. Periyodik dağıtım, uygulamanız ön planda veya arka planda çalışırken gerçekleşebilir.
Varsayılan dağıtım süresi 30 dakikadır.
analytics.xml dosyanızda ga_dispatchPeriod parametresini kullanarak veya bu örnekte olduğu gibi setDispatchPeriod(int dispatchPeriodInSeconds) yöntemini çağırarak saniye cinsinden kendi aralığınızı sağlayabilirsiniz:
analytics.xml dosyanızda:
<integer name="ga_dispatchPeriod">60</integer>
Programlı olarak:
GAServiceManager.getInstance().setDispatchPeriod(60);
Negatif bir değer ayarlanırsa düzenli dağıtım devre dışı bırakılır ve Google Analytics'e veri göndermek istiyorsanız manuel dağıtım kullanmanız gerekir. Öte yandan, 0 değeri ayarlanırsa ağ bağlantısı varsa her isabet hemen gönderilir.
Tüm isabetler gönderildikten sonra, periyodik dağıtım bir güç tasarrufu moduna girer ve başka bir gönderme çağrısı yapılana kadar devre dışı bırakılır.
Bir kullanıcı ağ erişimini kaybederse veya dağıtılmasını bekleyen isabetler varken uygulamanızdan çıkarsa bu isabetler yerel depolama alanında saklanır. Uygulamanız tekrar çalıştırıldığında ve dağıtım çağrıldığında gönderilir.
Manuel Gönderme
Düzenli dağıtıma güvenmenin dışında, isabetlerinizi manuel olarak dağıtmak istediğiniz zamanlar olabilir. Örneğin, ek yükü azaltmak için dağıtımlarınızı uygulamanız tarafından yapılan diğer HTTP istekleriyle gruplandırabilirsiniz.
İsabetler, GAServiceManager örneği kullanılarak manuel olarak dağıtılabilir:
GAServiceManager.getInstance().dispatch();