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

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


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

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

برای برنامه‌های Android، کیت توسعه نرم‌افزار Analytics با Google Play ادغام می‌شود.

در بیشتر موارد، کیت توسعه نرم‌افزار Analytics به‌طور خودکار رویدادهای خرید درون‌برنامه‌ای را بدون نیاز به فراخوانی‌های API در برنامه‌تان جمع‌آوری می‌کند. علاوه‌براین، در اینجا چند گزینه دیگر برای جمع‌آوری رویدادهای خرید درون‌برنامه‌ای ارائه شده است:

  • می‌توانید رویدادهای خرید درون‌برنامه‌ای را مستقیماً از برنامه‌تان به‌صورت دستی ثبت کنید، بدون اینکه با «فروشگاه Play» تعامل داشته باشید.

  • همچنین می‌توانید رویدادهای خرید درون‌برنامه‌ای را به‌صورت دستی در WebView ثبت کنید.

این راهنما توضیح می‌دهد که چگونه پروژه خود را برای ردیابی خودکار راه‌اندازی کنید و برخی موارد خاص را که برای پیاده‌سازی به چند خط کد نیاز دارند، شرح می‌دهد.

قبل از شروع

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

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

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

    • برای ردیابی خودکار خرید درون‌برنامه‌ای: مطمئن شوید که برنامه‌تان از Analytics SDK v17.3.0+ (یا Firebase Android BoM v25.2.0+) استفاده می‌کند.
    • برای ردیابی دستی خرید درون‌برنامه: مطمئن شوید که برنامه‌تان از Analytics SDK v23.2.0+ (یا Firebase Android BoM v34.10.0+) استفاده می‌کند

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

پیاده‌سازی

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

برای برنامه‌های Android، می‌توانید رویدادهای خرید درون‌برنامه‌ای را به‌محض پیوند دادن به Google Play بسنجید.

اگر لازم است خریدهای درون‌برنامه‌ای انجام‌شده در خارج از «فروشگاه Play» را ردیابی کنید، می‌توانید رویدادهای خرید درون‌برنامه‌ای را به‌صورت دستی بااستفاده از تکه‌کد زیر یا در WebView ثبت کنید.

برای ردیابی دستی خریدهای درون‌برنامه، مطمئن شوید که از Analytics SDK v23.2.0+ (یا Firebase Android BoM v34.10.0+) استفاده می‌کنید.

Kotlin 

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java 

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}