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

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

Analytics отображает события внутриигровых покупок в отчете о покупках внутри приложений .

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

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

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

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

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

Приложения для Android

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

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

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

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

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

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

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

Выполнение

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

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

В приложениях для Android можно отслеживать события внутриигровых покупок сразу после привязки к Google Play .

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

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

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

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