Оценивайте покупки в приложении

Встроенные покупки (IAP) — это цифровой контент или функции, которые можно продавать в мобильном приложении через Google Play или Apple App Store, избавляя приложение от необходимости обрабатывать финансовые транзакции. Примерами встроенных покупок являются контент по подписке или специальные игровые элементы.

Analytics отображает события IAP в отчете «Покупки внутри приложения» .

Для приложений Android пакет Analytics SDK интегрируется с Google Play . Для приложений платформы Apple пакет SDK интегрируется с Apple App Store с помощью API StoreKit 1 и StoreKit 2 от Apple.

В большинстве случаев Analytics SDK автоматически собирает события покупок внутри приложения, не требуя вызовов API в вашем приложении. В этом руководстве объясняется, как настроить автоматическое отслеживание в вашем проекте, а также описываются некоторые особые случаи, для реализации которых требуется всего несколько строк кода.

Прежде чем начать

• Настройте свой проект Firebase и кодовую базу своего приложения, как описано в разделе Начало работы с Google Analytics .

• Свяжите свой проект Firebase с ресурсом Google Analytics 4.

• Для приложений платформы Apple:

  • Убедитесь, что ваше приложение использует Analytics SDK v6.20.0+.

• Для приложений Android:

  • Убедитесь, что ваше приложение использует Analytics SDK v17.3.0+ (или Firebase Android BoM v25.2.0+).
  • Свяжите свои приложения Firebase с Google Play .

Если вы разрабатываете приложение для Android, вы можете отслеживать события покупок внутри приложения (IAP) сразу после подключения к Google Play . Оставшаяся часть этого руководства посвящена приложениям для платформы Apple.

Если вы разработчик Apple, убедитесь, что вы знакомы с API-интерфейсами покупок внутри приложений Apple StoreKit 1 и StoreKit 2, изучив документацию Apple .

Выполнение

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()
  ...
}