Android için Google Analytics SDK'sı, geliştiricilerin uygulamalardan kullanıcı etkileşimi verilerini toplamalarını kolaylaştırır. Bu belgede, SDK'nın değerine genel bir bakışın yanı sıra tek bir mülk kimliği ve EasyTracker kullanarak uygulamanızı ölçmeye başlama hakkında bir kılavuz yer alır.
Giriş
Android için Google Analytics SDK'sı, geliştiricilerin uygulamalarından kullanıcı etkileşimi verilerini toplamasını kolaylaştırır. Geliştiriciler daha sonra Google Analytics raporlarını kullanarak:
- Uygulamalarını kullanan etkin kullanıcı sayısı.
- Uygulamanın dünyanın neresinden kullanıldığı.
- Belirli özelliklerin benimsenmesi ve kullanımı.
- Uygulama içi satın alma ve işlemler.
- Uygulama kilitlenmelerinin sayısı ve türü.
- ve daha birçok faydalı metrik.
Buna ek olarak, Android için Google Analytics SDK'sı, Google Play yüklemelerinden uygulama içi satın almalara ve işlemlere kadar pazarlama kanallarınızın performansına ilişkin uçtan uca görünürlük sağlayarak mobil pazarlama kampanyalarının başarısını izlemenize yardımcı olacak araçlar sunar.
Başlamadan önce
SDK'yı uygulamaya başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
- Android geliştirici SDK'sı (Windows, Mac OS X ve Linux'ta kullanılabilir)
- Android v2 için Google Analytics SDK'sı (projenizin
/libs
dizinine ve derleme yolunalibGoogleAnalyticsV2.jar
eklenmiş olarak) - Android v2 için Google Analytics SDK'sını uygulamak üzere kullanabileceğiniz bir Android uygulaması
- Yeni bir Google Analytics uygulama mülkü ve görünümü (profil).
Başlarken
SDK'yı üç adımda kullanmaya başlayabilirsiniz:
- AndroidManifest.xml dosyasını güncelleyin
- EasyTracker yöntemleri ekleme
- analytics.xml dosyanızı oluşturma
Bu adımları tamamladıktan sonra Google Analytics ile aşağıdakileri ölçebilirsiniz:
- Uygulama yüklemeleri
- Etkin kullanıcılar ve demografi
- Ekranlar ve kullanıcı etkileşimi
- Kilitlenmeler ve istisnalar
1. AndroidManifest.xml dosyası güncelleniyor
Aşağıdaki izinleri ekleyerek AndroidManifest.xml dosyanızı güncelleyin:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. EasyTracker yöntemleri ekleme
Gönderme yöntemlerini, aşağıdaki örnekte gösterildiği gibi her bir Activities
öğesinin onStart()
ve onStop()
yöntemlerine ekleyin:
/** * An example Activity in your app with Analytics * implemented. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance().activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance().activityStop(this); // Add this method. } }
EasyTracker'ın yöntemlerini çağırabilmeniz için önce Context
gerektirir. Yukarıdaki örnekte şu satır:
EasyTracker.getInstance.activityStart(this);
bağ kurma işini üstlenir. Ancak başka sınıflarda veya yöntemlerde EasyTracker çağrıları yapmanız gerekirse önce EasyTracker'ın setContext(Context ctx)
yöntemini çağırmanız gerekir:
// Set Context before using EasyTracker. Note that the SDK will // use the application context. EasyTracker.getInstance().setContext(this); // EasyTracker is now ready for use.
3. analytics.xml dosyanızı oluşturma
Android için Google Analytics SDK'sının 2. sürümünde, yapılandırma seçenekleri bu kılavuzda
analytics.xml
adı verilen bir xml kaynak dosyasından
yönetilir. Bu dosyayı projenizin res/values
dizininde oluşturmanız ve izleme kimliğinizi eklemeniz gerekir. Aşağıdaki örnekte, izleme kimliğinizi nasıl ekleyeceğiniz ve Activity
ile istisna ölçümünü nasıl etkinleştirebileceğiniz gösterilmektedir:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
Hata analizi denetleyiciniz, izleme kimliğinizde kısa çizgi ("-") kullanımıyla ilgili sizi uyarabilir. <resources>
etiketinize ek özellikler ekleyerek bu uyarıyı gizleyebilirsiniz:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Uygulamanızı yapılandırmak üzere kullanabileceğiniz parametrelerin tam listesi için analytics.xml parametre referansı sayfasına bakın.
Tebrikler! Uygulamanız artık Google Analytics'e veri gönderecek şekilde ayarlandı.
Sonraki adımlar
Google Analytics ile kampanyaları, uygulama içi ödemeleri ve işlemleri, kullanıcı etkileşimi etkinliklerini ölçmek dahil çok daha fazlasını yapabilirsiniz. Bu özellikleri uygulamanıza nasıl ekleyeceğinizi öğrenmek için aşağıdaki geliştirici kılavuzlarını inceleyin:
- Gelişmiş Yapılandırma: Birden fazla izleyici kullanma da dahil olmak üzere gelişmiş yapılandırma seçenekleri hakkında daha fazla bilgi edinin.
- Kampanyaları Ölçme – Hangi kanalların ve kampanyaların uygulama yüklemelerini artırdığını anlamak için kampanya ölçümünü nasıl uygulayacağınızı öğrenin.
- Etkinlikleri Ölçme – Etkinlikler'i kullanarak kullanıcıların düğmeler, videolar ve diğer medyalar gibi etkileşimli içeriklerle etkileşimini nasıl ölçeceğinizi öğrenin.
- Uygulama İçi Ödemeleri Ölçme – Uygulama içi ödemeleri ve işlemleri nasıl ölçeceğinizi öğrenin.
- Kullanıcı zamanlamaları: Yükleme sürelerini, medyayla etkileşimi ve daha fazlasını ölçmek için uygulamanızda kullanıcı zamanlamalarını nasıl ölçeceğinizi öğrenin.
- Analytics.xml parametreleri –
analytics.xml
yapılandırma parametrelerinin tam listesini inceleyin.