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

انتخاب پلاتفرم: iOS+ Android Unity


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

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

برای برنامه‌های پلاتفرم Apple، کیت توسعه نرم‌افزار بااستفاده از StoreKit 1 و StoreKit 2 APIs از Apple با Apple App Store ادغام می‌شود.

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

قبل از شروع

  • پروژه Firebase و پایگاه کد برنامه را همان‌طور که در شروع به کار با Google Analytics توضیح داده شده است راه‌اندازی کنید.

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

  • مطمئن شوید که از جدیدترین کیت توسعه نرم‌افزار استفاده می‌کنید:

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

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

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

پیاده‌سازی

در بیشتر موارد، «کیت توسعه نرم‌افزار Analytics» رویدادهای IAP را بدون نیاز به کد اضافی به‌طور خودکار ثبت می‌کند.

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

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

Swift

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

Objective-C

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

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