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

Uygulama içi satın almalar (UİSA), uygulamanızın finansal işlemler yapmak zorunda kalmaması için bir mobil uygulamada Google Play veya Apple App Store ü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. Apple platformu uygulamalarında SDK, Apple'ın StoreKit 1 ve StoreKit 2 API'lerini kullanarak Apple App Store 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. 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.
Apple platformu uygulamaları için:
- Uygulamanızın Analytics SDK'sının 6.20.0 veya sonraki bir sürümünü kullandığından emin olun.
Android uygulamaları için:
- Uygulamanızın Analytics SDK v17.3.0+ (veya Firebase Android BoM v25.2.0+) kullandığından emin olun.
- Firebase uygulamalarınızı Google Play'e bağlayın.

Android uygulaması geliştiriyorsanız Google Play ile bağlantı oluşturur oluşturmaz uygulama içi satın alma etkinliklerini ölçebilirsiniz. Bu kılavuzun geri kalanı Apple platformu uygulamalarına odaklanmaktadır.

Apple geliştiricisiyseniz Apple belgelerini inceleyerek Apple StoreKit 1 ve StoreKit 2 uygulama içi satın alma API'leri hakkında bilgi edinin.

Uygulama

Swift

StoreKit 1 kullanıyorsanız Analytics SDK, uygulama içi satın alma etkinliklerini otomatik olarak günlüğe kaydeder.

StoreKit 2'yi kullanıyorsanız uygulama içi satın alma etkinliklerini günlüğe kaydetmek için aşağıdaki kodu kullanın.

import StoreKit
import FirebaseAnalytics

// A user tapped a button to purchase an item.
func userTappedPurchaseUpgradeButton() {
  let product = ...
  purchaseSomeProduct(product)
}

func purchaseSomeProduct(_ product: Product) {
  // Purchase a Product. This is mostly standard boilerplate StoreKit 2
  // code, except for the Analytics.logTransaction() call.
  let result = try await product.purchase()
  switch result {
  case .success(let verification):
      let transaction = try checkVerified(verification)

      // Call this Firebase API to log the in-app purchase event.
      Analytics.logTransaction(transaction)

      await transaction.finish()
  ...
}

Objective-C

StoreKit 1 kullanıyorsanız Analytics SDK, uygulama içi satın alma etkinliklerini otomatik olarak günlüğe kaydeder.

StoreKit 2 yalnızca Swift'te kullanılabilir. Bu nedenle, Objective-C uygulaması desteklenmez.

Kotlin

IAP etkinliklerini günlüğe kaydetmek için Google Play bağlantısını kullanın.

Java