| انتخاب پلاتفرم: | iOS+ Android Unity |
خریدهای درون‌برنامه (IAP) محتوا یا ویژگی‌های دیجیتالی هستند که می‌توانید در یک برنامه تلفن همراه ازطریق Apple App Store بفروشید تا برنامه‌تان مجبور نباشد تراکنش‌های مالی را پردازش کند. نمونه‌هایی از خریدهای درون‌برنامه‌ای شامل محتوای مبتنی بر اشتراک یا قطعات ویژه بازی است.
Analytics رویدادهای خرید درون‌برنامه‌ای را در گزارش خریدهای درون‌برنامه‌ای نشان می‌دهد.
برای برنامه‌های پلاتفرم Apple، کیت توسعه نرم‌افزار بااستفاده از میاناهای برنامه‌سازی کاربردی StoreKit 1 و StoreKit 2 از Apple با Apple App Store ادغام می‌شود.
در بیشتر موارد، کیت توسعه نرم‌افزار Analytics به‌طور خودکار رویدادهای خرید درون‌برنامه‌ای را بدون نیاز به فراخوانی‌های میانای برنامه‌سازی کاربردی در برنامه‌تان جمع‌آوری می‌کند. در iOS، علاوه‌بر رویدادهای خرید درون‌برنامه‌ای که به‌طور خودکار جمع‌آوری می‌شوند، می‌توانید رویدادهای خرید درون‌برنامه‌ای را به‌طور دستی در WebView ثبت کنید. این راهنما توضیح می‌دهد که چگونه پروژه خود را برای ردیابی خودکار راه‌اندازی کنید و برخی موارد خاص را شرح می‌دهد که برای پیاده‌سازی به چند خط کد نیاز دارند.
قبل از شروع
پروژه Firebase و پایگاه کد برنامه‌تان را همان‌طور که در شروع به کار با Google Analytics شرح داده شده است راه‌اندازی کنید.
پروژه Firebase خود را به دارایی Google Analytics 4 پیوند دهید.
مطمئن شوید که از جدیدترین کیت توسعه نرم‌افزار استفاده می‌کنید:
برای پیگیری خودکار خرید درون‌برنامه‌ای: مطمئن شوید که برنامه‌تان از Analytics SDK نسخه ۶.۲۰.۰ یا بالاتر استفاده می‌کند.
برای ردیابی دستی خرید درون‌برنامه‌ای: مطمئن شوید که برنامه‌تان از Analytics SDK نسخه ۱۲.۵.۰ یا بالاتر استفاده می‌کند.
با مرور اسناد Apple، مطمئن شوید که با میاناهای برنامه‌سازی کاربردی خرید درون‌برنامه‌ای Apple StoreKit 1 و StoreKit 2 آشنا هستید.
پیاده‌سازی
در بیشتر موارد، کیت توسعه نرم‌افزار Analytics به‌طور خودکار رویدادهای خرید درون‌برنامه‌ای را بدون نیاز به کد اضافی ثبت می‌کند.
برای برنامه‌های iOS، اگر از StoreKit 1 استفاده می‌کنید، کیت توسعه نرم‌افزار Analytics به‌طور خودکار رویدادهای خرید درون‌برنامه‌ای را ثبت می‌کند. اگر از StoreKit 2 استفاده می‌کنید، می‌توانید رویدادهای خرید درون‌برنامه‌ای درستی‌سنجی‌شده را بااستفاده از تکه‌کد زیر ثبت کنید.
یا اگر لازم است خریدهای درون‌برنامه‌ای انجام‌شده در خارج از App Store را ردیابی کنید، می‌توانید رویدادهای خرید درون‌برنامه‌ای را به‌صورت دستی در WebView ثبت کنید. توجه داشته باشید که کیت توسعه نرم‌افزار همچنان به‌طور خودکار خریدهای درون‌برنامه را درصورت امکان ثبت می‌کند و هیچ رویداد خرید درون‌برنامه ثبت‌شده به‌صورت دستی را حذف تکراری نمی‌کند. مطمئن شوید که هنگام ردیابی دستی خریدهای درون‌برنامه از Analytics SDK نسخه ۱۲.۵.۰ یا بالاتر استفاده می‌کنید.
Swift
اگر از StoreKit 1 استفاده می‌کنید، کیت توسعه نرم‌افزار Analytics به‌طور خودکار رویدادهای خرید درون‌برنامه‌ای را ثبت می‌کند.
اگر از 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() ... }
Objective-C
اگر از StoreKit 1 استفاده می‌کنید، کیت توسعه نرم‌افزار Analytics به‌طور خودکار رویدادهای خرید درون‌برنامه‌ای را ثبت می‌کند.
StoreKit 2 فقط برای Swift است، بنابراین پیاده‌سازی Objective-C پشتیبانی نمی‌شود.