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

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

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

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

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

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

برنامه‌های اندروید

  • مطمئن شوید که برنامه شما از Analytics SDK نسخه ۱۷.۳.۰+ (یا Firebase Android BoM نسخه ۲۵.۲.۰+) استفاده می‌کند.

  • برنامه‌های Firebase خود را به Google Play پیوند دهید .

اپلیکیشن‌های پلتفرم اپل

  • مطمئن شوید که از آخرین SDK استفاده می‌کنید:

    • برای ردیابی خودکار خرید درون‌برنامه‌ای: مطمئن شوید که برنامه شما از Analytics SDK نسخه ۶.۲۰.۰+ استفاده می‌کند.

    • برای ردیابی دستی خرید درون‌برنامه‌ای: مطمئن شوید که برنامه شما از Analytics SDK نسخه ۱۲.۵.۰+ استفاده می‌کند.

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

پیاده‌سازی

در بیشتر موارد، SDK آنالیتیکس به طور خودکار رویدادهای IAP را بدون نیاز به کد اضافی ثبت می‌کند.

پیاده‌سازی در برنامه‌های اندروید

برای برنامه‌های اندروید، می‌توانید رویدادهای IAP را به محض اتصال به گوگل پلی اندازه‌گیری کنید.

پیاده‌سازی در برنامه‌های پلتفرم اپل

برای برنامه‌های iOS، اگر از StoreKit 1 استفاده می‌کنید، Analytics SDK به طور خودکار رویدادهای IAP را ثبت می‌کند. اگر از StoreKit 2 استفاده می‌کنید، می‌توانید رویدادهای خرید درون برنامه‌ای تأیید شده را با استفاده از قطعه کد زیر ثبت کنید.

از طرف دیگر، اگر نیاز به پیگیری خریدهای درون‌برنامه‌ای خارج از اپ استور دارید، می‌توانید رویدادهای IAP را به صورت دستی در یک WebView ثبت کنید . توجه داشته باشید که SDK در صورت امکان، خریدهای درون‌برنامه‌ای را به طور خودکار ثبت می‌کند و هیچ رویداد خرید درون‌برنامه‌ای که به صورت دستی ثبت شده باشد را از حالت تکراری خارج نمی‌کند. هنگام پیگیری دستی خریدهای درون‌برنامه‌ای، مطمئن شوید که از Analytics SDK نسخه ۱۲.۵.۰+ استفاده می‌کنید.

سویفت

اگر از 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()
  ...
}

هدف-سی

اگر از StoreKit 1 استفاده می‌کنید، Analytics SDK به طور خودکار رویدادهای IAP را ثبت می‌کند.

StoreKit 2 فقط با Swift سازگار است، بنابراین پیاده‌سازی Objective-C روی آن پشتیبانی نمی‌شود.