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

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

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

Для приложений на платформе 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.

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

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

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

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

Выполнение

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

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