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

Встроенные покупки (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 автоматически собирает события покупок через Интернет (IAP), не требуя вызовов API в вашем приложении. В iOS вы также можете вручную регистрировать события покупок через Интернет (WebView) в дополнение к автоматически собираемым событиям покупок через Интернет (IAP). В этом руководстве объясняется, как настроить проект для автоматического отслеживания, и описываются некоторые особые случаи, для реализации которых требуется всего несколько строк кода.

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

Android-приложения

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

  • Свяжите свои приложения Firebase с Google Play .

Приложения на платформе Apple

  • Убедитесь, что вы используете последнюю версию SDK:

    • Для автоматического отслеживания покупок в приложении: убедитесь, что ваше приложение использует Analytics SDK v6.20.0+.

    • Для ручного отслеживания покупок в приложении: убедитесь, что ваше приложение использует Analytics SDK v12.5.0+.

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

Выполнение

В большинстве случаев Analytics SDK автоматически регистрирует события IAP, не требуя дополнительного кода.

Реализация в приложениях для Android

Для приложений Android вы можете отслеживать события покупок внутри приложения сразу после подключения к Google Play .

Реализация в приложениях на платформе Apple

Для приложений iOS: если вы используете StoreKit 1, Analytics SDK автоматически регистрирует события покупок внутри приложения. Если вы используете StoreKit 2, вы можете регистрировать подтверждённые события покупок внутри приложения, используя фрагмент кода ниже.

В качестве альтернативы, если вам необходимо отслеживать внутриигровые покупки, совершенные вне App Store, вы можете регистрировать события IAP вручную в WebView . Обратите внимание, что SDK будет продолжать автоматически регистрировать внутриигровые покупки, где это возможно, и не будет удалять дубликаты событий внутриигровых покупок, зарегистрированных вручную. Убедитесь, что вы используете Analytics SDK версии 12.5.0+ при ручном отслеживании внутриигровых покупок.

Быстрый

Если вы используете StoreKit 1, Analytics SDK автоматически регистрирует события IAP.

Если вы используете StoreKit 2, используйте следующий код для регистрации событий IAP.

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, Analytics SDK автоматически регистрирует события IAP.

StoreKit 2 поддерживает только Swift, поэтому реализация Objective-C не поддерживается.