Bu geçiş kılavuzunda, SDK'nın 2. sürümündeki yenilikler açıklanmakta ve geliştiricilere v1.x uygulamasından geçiş yapmaları için ipuçları sağlanmaktadır. v1.x uygulamasından geçiş yapması gerekmeyen geliştiriciler, hemen Sürüm 2'yi Kullanmaya Başlama sayfasını ziyaret edebilirler.
Giriş
Google Analytics kısa süre önce Android için güncellenmiş Google Analytics SDK sürüm 2'yi kullanıma sundu. SDK'nın 2 sürümü, yeni özellikler için destek içerir ve uygulama geliştiriciler için özel olarak tasarlanmış yeni bir raporlama arayüzü sunar.
Mevcut tüm Google Analytics geliştiricilerinin yeni özelliklerden ve raporlardan yararlanmak amacıyla Android için Google Analytics SDK'sının 2. sürümüne geçmelerini öneririz.
Sürüm 2'deki Yenilikler
Android için Google Analytics SDK'sı sürüm 2, uygulama geliştiricileri için tasarlanmış yeni bir raporlama deneyimi, güçlü yeni boyutlar, metrikler ve çok daha fazlasını sunuyor. Geliştiricilerin sürüm 2 ile elde edebilecekleri özelliklere göz atın:
- Uygulama geliştiriciler için daha güçlü raporlar
- Standart raporlar, uygulama geliştiriciler için yeniden tasarlandı. Bu amaçla Etkileşim Akışı ve Google Play Kaynakları gibi yeni raporlar eklendi. Bu yeni raporlar, geliştiricilerin kullanıcı edinme ve deneyimle ilgili yeni bilgiler edinmesine yardımcı olacak. Mülkünüzü sürüm 2 için en iyi şekilde nasıl yapılandırabileceğiniz hakkında daha fazla bilgi edinmek istiyorsanız Hesap Yapılandırmasıyla İlgili En İyi Uygulamalar'ı okuyun.
- Yeni uygulama boyutları ve metrikleri
- SDK'nın 2. sürümünde Ekran Adı, Ekran Görüntülenme Sayısı, Uygulama Adı ve Uygulama sürümü gibi yeni, uygulamaya özel boyut ve metrikler kullanıma sunulmuştur.
- Kilitlenmeleri ve istisnaları ölçme
- Android için Google Analytics SDK'sı, istisna ölçümünü ve istisna isabet türünü kullanıma sunar. İstisna ölçümünü kullanarak kilitlenmelerin ve önemli olmayan istisnaların sayısını ve türünü ölçebilirsiniz. İstisna ölçümünün nasıl uygulanacağını öğrenmek için İstisnalar Geliştirici Kılavuzu'na bakın.
- Özel boyutlar ve metrikler
- Verilerinizi yeni yollarla segmentlere ayırmak için özel boyutlar oluşturun. Özel Boyutlar ve Metrikler hakkında daha fazla bilgi edinin.
- Sosyal medya etkileşimlerini ölçme
- Kullanıcıların yerleşik sosyal medya eklentileri ve widget'larla etkileşimlerini ölçerek uygulamanızdaki sosyal medyanın değeriyle ilgili yeni bilgiler edinin. Sosyal Medya Etkileşimleri'ni ölçme hakkında daha fazla bilgi edinin.
Başlamadan önce
Tüm geliştiriciler taşıma işlemlerine başlamadan önce şu iki adımı atmalıdır:
- Android v2 için Google Analytics SDK'sını indirin
- Yeni uygulama raporlarınıza ve verilerinize erişmek için kullanacağınız bir uygulama görünümü (profil) oluşturun.
Yukarıdaki adımları tamamladıktan sonra taşıma yolunuz için aşağıdaki adımları uygulayın.
EasyTracker'dan taşıma
Uygulamanızı EasyTracker kitaplığının v1'den v2'sine taşımak için uygulamanız gereken üç adım vardır:
- GoogleAnalytics.xml kaynak dosyanızdaki parametreleri güncelleyin
- Yöntem adlarını güncelleme
- Yayın alıcınızı güncelleme (Google Play Kampanya İzleme)
1. GoogleAnalytics.xml dosyasındaki Parametreleri güncelleme
Sürüm 2'ye taşıma işlemi yaparken GoogleAnalytics.xml kaynak dosyanızdaki parametreleri güncelleyin. Bunlardan bazıları v1.x sürümünden sonra değişmiştir ve sürüm 2'de yeni parametreler eklenmiştir.
Aşağıdaki tabloda, sürüm 2'de güncellenen parametreler gösterilmektedir:
| v1.x parametre adı | v2.x parametre adı |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | desteği sonlandırıldı |
Daha fazla bilgi edinmek için yeni ve güncellenmiş EasyTracker Parametrelerine bakın.
2. Yöntem Adlarını Güncelleme
Söz diziminin büyük kısmı EasyTracker'ın sürüm 2'sinde aynı kalsa da, yöntem adları ve söz diziminde, uygulamanızı güncellemenizi gerektiren bazı önemli farklılıklar vardır:
trackPageView(), sürüm 2'desendView(). Daha fazla bilgi için Ekran İzleme Geliştirici Kılavuzu'na bakın- E-ticaret uygulaması basitleştirildi. Sürüm 2'de e-ticaret ölçümünü nasıl uygulayacağınızı öğrenin.
- Özelleştirilebilen değişkenlerin yerini Özel Boyutlar ve Metrikler almıştır. Yeni özellikten yararlanmak için
setCustomVar()öğesine yapılan tüm çağrılar güncellenmelidir. Özel Boyutlar ve Metrikleri nasıl uygulayacağınızı öğrenin.
3. Yayın Alıcısını Güncelleme (Google Play Kampanya İzleme)
v1.x sürümünü kullanarak Google Play Kampanya İzleme'yi uygulayan geliştiriciler, alıcının sınıf yolunun değiştiğini dikkate almalıdır. Daha fazla bilgi için Google Play Kampanya İzleme Kılavuzu'na bakın.
Özel Uygulamadan Taşıma
Android için Analytics SDK'sının v1.x sürümünde EasyTracker kitaplığını kullanmıyorsanız EasyTracker'ı sürüm 2'de kullanmaya başlamanızı öneririz.
EasyTracker kitaplığı artık SDK'ya dahildir ve tüm geliştiriciler için önerilir. Google Analytics SDK v2'de EasyTracker'ı kullanmaya başlayın.
Tek bir uygulamada birden çok mülk kimliği kullanmak gibi gelişmiş veri toplama ihtiyaçlarınız varsa SDK v2.x sürümünün gelişmiş özelliklerini kullanma hakkında daha fazla bilgi edinmek için Gelişmiş Yapılandırma Kılavuzu'nu okuyun.