Bu dokümanda, Android v3 için Google Analytics SDK'sını kullanmaya nasıl başlayacağınız açıklanmaktadır.
Başlamadan önce
SDK'yı uygulamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
- Android geliştirici SDK'sı (Windows, Mac OS X ve Linux'ta kullanılabilir)
- Android v3 için Google Analytics SDK'sı (projenizin
/libs
dizinine ve derleme yolunalibGoogleAnalyticsServices.jar
eklenmiş olarak) - Google Analytics'i uygulamak için kullanabileceğiniz bir Android uygulaması
- Uygulamanızdan veri gönderilecek en az bir Google Analytics mülkü ve uygulama 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:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ 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(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. analytics.xml dosyanızı oluşturma
EasyTracker'ı kullandığınızda, global yapılandırma ayarları XML'de tanımlanan kaynaklar kullanılarak yönetilir. Projenizin res/values
dizininde analytics.xml
adında bir dosya oluşturun ve aşağıdaki kaynakları ekleyin:
<?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 aracınız, 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. Uygulama gereksinimlerinize bağlı olarak, isabetleri düzgün şekilde gönderdiğinizi doğrulamak için gönderim süresini değiştirmek isteyebilirsiniz. Örneğin, gerçek zamanlı verileri görmek istiyorsanız bunu 5 sn gibi düşük bir değere ayarlayabilirsiniz.
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.
Aşağıdaki geliştirici kılavuzlarında, Google Analytics özelliklerini uygulamanıza nasıl ekleyeceğiniz hakkında ek bilgiler verilmektedir:
- 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.
- 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.
- 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.
- 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.
-
Analytics.xml parametreleri –
analytics.xml
yapılandırma parametrelerinin tam listesini inceleyin.