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 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, uygulama içi satın alma etkinliklerini Uygulama içi satın alma işlemleri raporunda gösterir.

Apple platformu uygulamaları için SDK, Apple'ın StoreKit 1 ve StoreKit 2 API'lerini kullanarak Apple uygulama mağazası ile entegre olur.

Çoğu durumda Analytics SDK'sı, uygulamanızda API çağrıları yapılmasına gerek kalmadan uygulama içi satın alma etkinliklerini otomatik olarak toplar. iOS'te, otomatik olarak toplanan uygulama içi satın alma etkinliklerine ek olarak uygulama içi satın alma etkinliklerini bir web görünümünde manuel olarak da günlüğe kaydedebilirsiniz. Bu kılavuzda, projenizi otomatik izleme için nasıl ayarlayacağınız açıklanmakta ve uygulanması için birkaç satır kod gerektiren bazı özel durumlar anlatılmaktadır.

Başlamadan önce

  • Firebase projenizi ve uygulamanızın kod tabanını Google Analytics kullanmaya başlama 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'sı 6.20.0 veya sonraki bir sürümü kullandığından emin olun.

    • Manuel uygulama içi satın alma takibi için: Uygulamanızın Analytics SDK'sı 12.5.0 veya sonraki bir sürümü 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'sı, ek kod gerekmeden uygulama içi satın alma etkinliklerini otomatik olarak günlüğe kaydeder.

iOS uygulamalarında StoreKit 1 kullanıyorsanız Analytics SDK'sı, 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 günlüğe kaydedebilirsiniz.

Alternatif olarak, uygulama mağazası dışında yapılan uygulama içi satın alma işlemlerini izlemeniz gerekiyorsa UİSA etkinliklerini bir WebView'da manuel olarak kaydedebilirsiniz. SDK'nın, mümkün olduğunda 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 etkinliklerini tekilleştirmeyeceğini unutmayın. Uygulama içi satın alma işlemlerini manuel olarak izlerken Analytics SDK'sı 12.5.0 veya sonraki bir sürümü kullandığınızdan emin olun.

Swift

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

StoreKit 2 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'sı, uygulama içi satın alma etkinliklerini otomatik olarak günlüğe kaydeder.

StoreKit 2 yalnızca Swift'i desteklediğinden Objective-C uygulaması desteklenmez.