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ı için 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. iOS'te, otomatik olarak toplanan uygulama içi satın alma etkinliklerine ek olarak WebView'da uygulama içi satın alma etkinliklerini manuel olarak da günlüğe 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.

Android uygulamaları

• 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 bağlayın.

  Not: Android uygulamaları için Google Play ile bağlantı oluşturur oluşturmaz UİSA etkinliklerini ölçebilirsiniz. Bu kılavuzun geri kalanı Apple platformu uygulamalarına odaklanmaktadır.

Apple platform uygulamaları

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

  • Otomatik uygulama içi satın alma izleme için: Uygulamanızın Analytics SDK'sının 6.20.0 veya sonraki bir sürümünü kullandığından emin olun.

  • Manuel uygulama içi satın alma izleme için: Uygulamanızın Analytics SDK'sının 12.5.0 veya sonraki bir sürümünü kullandığından emin olun.

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

Uygulama

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

Android uygulamalarında uygulama

Android uygulamaları için, Google Play'e bağlandığınız anda uygulama içi satın alma etkinliklerini ölçebilirsiniz.

Apple platformu uygulamalarında uygulama

iOS uygulamalarında StoreKit 1'i kullanıyorsanız Analytics SDK, uygulama içi satın alma etkinliklerini otomatik olarak günlüğe kaydeder. StoreKit 2 kullanıyorsanız aşağıdaki kod snippet'ini kullanarak doğrulanmış uygulama içi satın alma etkinliklerini kaydedebilirsiniz.

Alternatif olarak, App Store dışında yapılan uygulama içi satın alma işlemlerini izlemeniz gerekiyorsa uygulama içi satın alma etkinliklerini bir WebView'da manuel olarak günlüğe kaydedebilirsiniz. SDK'nın, mümkün olan durumlarda uygulama içi satın alma işlemlerini otomatik olarak günlüğe kaydetmeye devam edeceğini ve manuel olarak günlüğe kaydedilen uygulama içi satın alma etkinliklerinin yinelenenlerini kaldırmayacağını unutmayın. Uygulama içi satın alma işlemlerini manuel olarak izlerken Analytics SDK'sının 12.5.0 veya sonraki bir sürümünü kullandığınızdan emin olun.

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.