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

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

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

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

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

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

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

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

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

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

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

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

پیاده‌سازی

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

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

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

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