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

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

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

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

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

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 или выше при ручном отслеживании покупок в приложении.

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