خریدهای درون برنامه ای را اندازه گیری کنید

خریدهای درون‌برنامه‌ای (IAP) محتوا یا ویژگی‌های دیجیتالی هستند که می‌توانید آن‌ها را در یک برنامه تلفن همراه از طریق Google Play یا Apple App Store بفروشید تا برنامه شما مجبور به پردازش تراکنش‌های مالی نباشد. نمونه هایی از خریدهای درون برنامه ای شامل محتوای مبتنی بر اشتراک یا قطعات بازی ویژه است.

Analytics رویدادهای IAP را در گزارش خریدهای درون‌برنامه نشان می‌دهد.

برای برنامه‌های اندروید، Analytics SDK با Google Play ادغام می‌شود. برای برنامه‌های پلتفرم اپل، SDK با استفاده از StoreKit 1 و StoreKit 2 APIهای اپل با فروشگاه App Apple ادغام می‌شود.

در بیشتر موارد، Analytics SDK به طور خودکار رویدادهای IAP را بدون نیاز به تماس های API در برنامه شما جمع آوری می کند. این راهنما نحوه راه‌اندازی پروژه خود را برای ردیابی خودکار توضیح می‌دهد و موارد خاصی را که برای پیاده‌سازی به چند خط کد نیاز دارند، توضیح می‌دهد.

قبل از اینکه شروع کنی

• پروژه Firebase و پایگاه کد برنامه خود را همانطور که در Get Started with Google Analytics توضیح داده شده است، تنظیم کنید.

• پروژه Firebase خود را به یک ویژگی Google Analytics 4 پیوند دهید.

• برای برنامه های پلتفرم اپل:

  • مطمئن شوید که برنامه شما از Analytics SDK نسخه 6.20.0+ استفاده می کند.

• برای برنامه های اندروید:

  • مطمئن شوید که برنامه شما از Analytics SDK نسخه 17.3.0+ (یا Firebase Android BoM نسخه 25.2.0+) استفاده می‌کند.
  • برنامه های Firebase خود را به Google Play پیوند دهید .

اگر در حال توسعه یک برنامه اندروید هستید، می توانید به محض اینکه به Google Play پیوند دهید، رویدادهای IAP را اندازه گیری کنید. بقیه این راهنما بر روی برنامه های پلت فرم اپل متمرکز است.

اگر یک برنامه‌نویس اپل هستید، با بررسی اسناد اپل مطمئن شوید که با APIهای خرید درون‌برنامه‌ای Apple StoreKit 1 و StoreKit 2 آشنا هستید.

پیاده سازی

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