Standart Universal Analytics (UA) mülkleri 1 Temmuz 2023'te veri işlemeyi durdurdu. UA 360 mülkleri 1 Temmuz 2024'te veri işlemeyi durduracak ve Google Analytics 4'e geçişimiz sırasında bazı UA 360 özellikleri bu tarihten önce kullanımdan kaldırılacak. Google Analytics 4'ü kullanmak için Firebase'e geçiş yapın.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Kampanya Ölçümü - Android SDK v2 (Eski)

Bu belgede, Android sürüm 2 için Google Analytics SDK'sı ile kampanyaların ve trafik kaynaklarının nasıl ölçüleceğine genel bir bakış sunulmaktadır.

Genel bakış

Google Analytics'te kampanyaları ölçmek, kampanyaların ve trafik kaynaklarının uygulamanızdaki kullanıcı etkinliğiyle ilişkilendirilmesini sağlayarak pazarlama kanallarınızın değerini artırmanıza yardımcı olabilir.

Android için Google Analytics SDK'sında çeşitli kampanya ölçümü türleri bulunur:

Google Play Kampanya Ölçümü - Uygulamanızı indirmesi için kullanıcıları uygulamanızın Google Play Store sayfasına yönlendiren kampanya, web sitesi ve uygulamaları görün.
Genel Kampanyaları Ölçme - Hangi kampanyaların veya trafik kaynaklarının uygulamanızın yüklendiğini başlattığını görün.
Yönlendirmeleri Ölçme - Uygulamanızı yüklendikten sonra hangi yönlendiren trafik kaynağının (ör. web siteleri veya diğer uygulamalar) başlattığını görün.

Aşağıdaki bölümlerde, her bir kampanya ölçümünün uygulamanızda ne zaman ve nasıl uygulanacağı açıklanmaktadır.

Google Play Kampanya Ölçümü

Google Play Kampanya Ölçümü, hangi kampanyaların ve trafik kaynaklarının kullanıcıları Google Play Store'dan uygulamanızı indirmeye yönlendirdiğini görmenize olanak tanır. Tüm geliştiricilerin Google Play Store Kampanya Ölçümü'nü uygulamasını öneririz.

Google Play Kampanya Ölçümü nasıl çalışır?

Google Play Store Kampanya Ölçümü, Google Play Store'dan indirildiği sırada uygulamanıza kampanya ve trafik kaynağı bilgilerini aktarmak için Kampanya Parametrelerinin kullanımına dayanır.

Aşağıda, Google Play Kampanya Ölçümü'nün işleyiş şekliyle ilgili baştan sona bir açıklama verilmiştir:

Kullanıcı bir reklamdan, web sitesinden veya uygulamadan gelen ve uygulamanızın Google Play Store sayfasına yönlendiren bir bağlantıyı tıklar. Bağlantı, Kampanya Parametreleri ile etiketlenir.
Kullanıcı uygulamanızı indirip yükledikten sonra, Google Play Store cihazda aynı kampanya parametrelerini içeren bir INSTALL_REFERRER amacı yayınlar.
Ardından uygulamanız, aşağıda verilen BroadcastReceiver nesnesini kullanarak, kampanya parametrelerini okuyarak ve bunları Google Analytics kampanya bilgilerini güncellemek için kullanarak bu amaca yanıt verir.

Google Play Kampanya Ölçümünü Uygulama

Google Play Store Kampanya Ölçümünü uygulamak için:

1. AndroidManifest.xml dosyanıza yeni bir BroadcastRecipientr ekleyin

Aşağıdaki BroadcastReceiver, uygulamanızın yüklendiğinde Google Play Store tarafından yayınlanan INSTALL_REFERRER amaç yayınına yanıt vermesine olanak tanır. Kodu AndroidManifest.xml dosyanıza aşağıdaki şekilde ekleyin:

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

Bilinen sorun: CampaignTrackingReceiver için javadoc dosyası şu anda bu snippet'in yanlış bir örneğini göstermektedir.

2. Google Play Store bağlantılarınıza kampanya parametreleri ekleme

Kampanya Parametreleri, kullanıcıyı uygulamanızın Google Play Store sayfasına yönlendiren kampanya veya trafik kaynağıyla ilgili bilgileri uygulamanızın Google Analytics uygulamasına aktarmak için kullanılır.

Kampanya parametresi dizesi oluşturmayı öğrenmek için Google Play URL Oluşturucu'yu kullanın veya Kampanya Parametreleri referans bölümüne bakın.

Kampanya parametre dizenizi oluşturduktan sonra, aşağıdaki örnekte gösterildiği gibi, bu dizeyi Google Play Store URL'lerinize referrer parametresinin değeri olarak ekleyin:

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

Google Play Store, referrer parametresinin değerini uygulamanızın Google Analytics uygulamasına yalnızca iletir. Bu nedenle, Google Play Store bağlantılarınızda bu parametrenin bulunduğundan emin olmanız önemlidir.

Genel Kampanyaları Ölçme

Genel kampanya ölçümü, bir kampanyayı veya trafik kaynağını, uygulamanızı yüklemiş olan kullanıcılarla ilişkilendirmek için kullanılabilir.

Örneğin, uygulamanızı daha önce yüklemiş olan mevcut kullanıcılara ulaşmak için ücretli bir kampanya yürütüyorsanız hangi uygulama lansmanlarının bu kampanya sonucunda gerçekleştiğini ölçmek için genel kampanya ölçümünü kullanabilirsiniz.

Genel Kampanya Ölçümünü Uygulama

Genel bir kampanyanın kampanya değerlerini ayarlamak için setCampaign() yöntemini çağırın ve bağımsız değişken olarak bir kampanya parametresi dizesi iletin.

Tipik bir uygulama, uygulama başlatıldığında setCampaign() öğesini çağırabilir ve geçerli kampanya parametreleri olup olmadığını görmek için uygulamayı başlatan niyeti kontrol edebilir:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

Tavsiyeleri Ölçme

Yönlendirme ölçümü, uygulamanızı bir kullanıcının cihazında başlatan bir yönlendiren kaynağı ölçmenize olanak tanıması açısından diğer kampanya ölçümü türlerine benzer. Ancak yönlendirme ölçümünde, kampanya parametreleri dizesi yerine "google.com" veya "myOtherApp" gibi basit bir dize kullanılır.

"google.com" gibi bir yönlendiren kaynak ayarladığınızda kaynak boyutu "google.com", aracı boyutu ise dolaylı yoldan "referrer" olarak ayarlanır.

Kampanya ölçümünde olduğu gibi yönlendiren kaynak ayarlamanız varsayılan olarak bir sonraki gönderme çağrısının yeni bir oturum başlatmasına neden olur.

Aşağıdaki kod snippet'inde, uygulamanızı açacak tüm bağlantıları Google Analytics kampanya parametreleri veya yönlendiren kaynağı açıklayan basit bir referrer parametresiyle etiketlediğinizi varsayıyoruz. Başka kampanya parametreleri yoksa referrer parametresi varsa kullanıcının kampanya bilgileri yeni yönlendiren kaynakla güncellenir:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

Bilinen sorunlar

CampaignTrackingReceiver için javadoc kullanım örneğinde yanlış sınıf yolu kullanıyor. Doğru kullanım için Google Play Kampanya Ölçümünü uygulama bölümüne bakın.
Uygulama başına yalnızca bir BroadcastReceiver sınıfı belirtilebilir. Farklı SDK'lardan iki veya daha fazla BroadcastReceivers eklemeniz gerekirse tüm yayınları alacak kendi BroadcastReceiver sınıfınızı oluşturmanız ve her yayın türü için uygun BroadcastReceivers yöntemini çağırmanız gerekir.
Google Play Kampanya Ölçümü, şu anda web Play Store'dan başlatılan web'den cihaza yükleme işlemlerini desteklememektedir.

Kampanya Parametreleri

Kampanya parametreleri, kullanıcıları uygulamanıza getiren trafik kaynakları ve kampanyalar hakkında bilgi aktarmak için kullanılır.

Genel kampanya ölçümünde, kodlanmamış bir kampanya parametresi dizesi setCampaign() öğesine bağımsız değişken olarak iletilir.
Google Play Kampanya Ölçümü'nde, uygulamanızın Play Store sayfasına yönlendiren tüm URL'lere, değeri olarak kodlanmış kampanya parametre dizesi içeren bir referrer parametresi eklenir.

Aşağıda, genel kampanya ölçümü için kullanılabilecek geçerli, kodlanmamış bir kampanya dizesi örneği verilmiştir:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

Aşağıdaki tabloda, Google Play'de veya genel kampanya ölçümünde kullanılabilecek kampanya parametrelerinin tam listesi gösterilmektedir.

Parametre	Açıklama	Örnekler
`utm_campaign`	Kampanya adı; belirli bir ürün promosyonunu veya stratejik kampanyayı tanımlamak amacıyla anahtar kelime analizinde kullanılır	`utm_campaign=spring_sale`
`utm_source`	Kampanya kaynağı; bir arama motorunu, bülteni veya başka bir kaynağı tanımlamak için kullanılır	`utm_source=google`
`utm_medium`	Kampanya aracısı; e-posta veya tıklama başına maliyet (tbm) gibi bir aracı tanımlamak için kullanılır	`utm_medium=cpc`
`utm_term`	Kampanya terimi; reklamlar için anahtar kelimeleri sağlamak üzere ücretli aramayla birlikte kullanılır	`utm_term=running+shoes`
`utm_content`	Kampanya içeriği; A/B testi ve aynı URL'ye yönlendiren reklamları veya bağlantıları ayırt etmek amacıyla içerik hedefli reklamlar için kullanılır	`utm_content=logolink` `utm_content=textlink`
`gclid`	Google Ads otomatik etiketleme parametresi; Google Ads'i ölçmek için kullanılır. Bu değer dinamik olarak oluşturulur ve hiçbir zaman değiştirilmemelidir.

Google Play URL Oluşturucu

Google Play Kampanya Ölçümü için URL'ler oluşturmak üzere Google Play URL Oluşturucu'yu kullanın.