Uygulama içi satın almaları ölçme

Platform seçin: iOS+ Android Unity


Uygulama içi satın almalar (UİSA), uygulamanızın finansal işlemler yapmak zorunda kalmaması için bir mobil uygulamada Google Play üzerinden satabileceğiniz dijital içerik veya özelliklerdir. Uygulama içi satın alma işlemlerine örnek olarak aboneliğe dayalı içerik veya özel oyun parçaları verilebilir.

Analytics, UİSA etkinliklerini Uygulama içi satın alma işlemleri raporunda gösterir.

Android uygulamalarında Analytics SDK'sı, Google Play ile entegre olur.

Çoğu durumda Analytics SDK, uygulamanızda API çağrıları gerektirmeden uygulama içi satın alma etkinliklerini otomatik olarak toplar. Ayrıca, uygulama içi satın alma etkinliklerini toplamak için bazı ek seçenekler de vardır:

  • Uygulama içi satın alma etkinliklerini Play Store ile etkileşime girmeden doğrudan uygulamanızdan manuel olarak kaydedebilirsiniz.

  • UAI etkinliklerini WebView'da manuel olarak da kaydedebilirsiniz.

Bu kılavuzda, projenizi otomatik izleme için nasıl ayarlayacağınız açıklanmakta ve uygulamak için birkaç satır kod gerektiren bazı özel durumlar açıklanmaktadır.

Başlamadan önce

  • Firebase projenizi ve uygulamanızın kod tabanını Google Analytics ile Başlarken bölümünde açıklandığı şekilde ayarlayın.

  • Firebase projenizi bir Google Analytics 4 mülküne bağlayın.

  • En yeni SDK'yı kullandığınızdan emin olun:

    • Otomatik uygulama içi satın alma izleme için: Uygulamanızın Analytics SDK v17.3.0+ (veya Firebase Android BoM v25.2.0+) kullandığından emin olun.
    • Manuel uygulama içi satın alma izleme için: Uygulamanızın Analytics SDK'sının 23.2.0 sürümünü veya üzerini (ya da Firebase Android BoM SDK'sının 34.10.0 sürümünü veya üzerini) kullandığından emin olun.
  • Firebase uygulamalarınızı Google Play bağlayın.

Uygulama

Çoğu durumda Analytics SDK, ek kod gerektirmeden uygulama içi satın alma etkinliklerini otomatik olarak kaydeder.

Android uygulamaları için, Google Play ile bağlantı oluşturur oluşturmaz uygulama içi satın alma etkinliklerini ölçebilirsiniz.

Play Store dışında yapılan uygulama içi satın alma işlemlerini izlemeniz gerekiyorsa aşağıdaki kod snippet'ini kullanarak veya WebView'da UİSA etkinliklerini manuel olarak kaydedebilirsiniz.

Uygulama içi satın alma işlemlerini manuel olarak izlemek için Analytics SDK v23.2.0+ (veya Firebase Android BoM v34.10.0+) kullandığınızdan emin olun.

Kotlin

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}