Android v2 (Eski) için Google Analytics SDK'sı - Genel Bakış

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:

Başlarken

SDK'yı üç adımda kullanmaya başlayabilirsiniz:

  1. AndroidManifest.xml dosyasını güncelleyin
  2. EasyTracker yöntemleri ekleme
  3. 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.