| انتخاب پلاتفرم: | iOS+ Android Unity |
خریدهای درون‌برنامه (IAP) محتوا یا ویژگی‌های دیجیتالی هستند که می‌توانید در برنامه تلفن همراه ازطریق Google Play بفروشید تا برنامه‌تان مجبور نباشد تراکنش‌های مالی را پردازش کند. نمونه‌هایی از خریدهای درون‌برنامه عبارت‌اند از محتوای مبتنی بر اشتراک یا قطعات ویژه بازی.
Analytics رویدادهای IAP را در گزارش خریدهای درون‌برنامه نشان می‌دهد.
برای برنامه‌های Android، کیت توسعه نرم‌افزار Analytics با Google Play ادغام می‌شود.
در اکثر موارد، «کیت توسعه نرم‌افزار» Analytics رویدادهای «پرداخت درون‌برنامه‌ای» را بدون نیاز به فراخوانی‌های API در برنامه‌تان به‌طور خودکار جمع‌آوری می‌کند. علاوه‌براین، در اینجا چند گزینه دیگر برای جمع‌آوری رویدادهای «پرداخت درون‌برنامه‌ای» ارائه شده است:
می‌توانید رویدادهای خرید درون‌برنامه‌ای را مستقیماً از برنامه‌تان و بدون تعامل با «فروشگاه Play» به‌صورت دستی ثبت کنید.
همچنین می‌توانید رویدادهای IAP را به‌صورت دستی در یک WebView ثبت کنید.
این راهنما توضیح می‌دهد چگونه پروژه‌تان را برای ردیابی خودکار راه‌اندازی کنید و برخی‌از موارد خاص را که برای پیاده‌سازی آن‌ها به چند خط کد نیاز است شرح می‌دهد.
قبل از شروع
پروژه Firebase و پایگاه کد برنامه را همان‌طور که در شروع به کار با Google Analytics توضیح داده شده است راه‌اندازی کنید.
پروژه Firebase خود را به دارایی Google Analytics 4 پیوند دهید.
مطمئن شوید که از جدیدترین کیت توسعه نرم‌افزار استفاده می‌کنید:
- برای خودکار ردیابی خرید درون‌برنامه: مطمئن شوید که برنامه‌تان از کیت توسعه نرم‌افزار Analytics نسخه ۱۷.۳.۰+ (یا Firebase Android BoM نسخه ۲۵.۲.۰+) استفاده می‌کند.
- برای ردیابی خرید درون‌برنامه دستی: مطمئن شوید که برنامه‌تان از کیت توسعه نرم‌افزار Analytics نسخه ۲۳.۲.۰+ (یا Firebase Android BoM نسخه ۳۴.۱۰.۰+) استفاده می‌کند
پیاده‌سازی
در بیشتر موارد، «کیت توسعه نرم‌افزار Analytics» رویدادهای IAP را بدون نیاز به کد اضافی به‌طور خودکار ثبت می‌کند.
برای برنامه‌های Android، می‌توانید رویدادهای IAP را به‌محض اینکه به Google Play پیوند دادید اندازه‌گیری کنید.
اگر نیاز دارید خریدهای درون‌برنامه‌ای انجام‌شده خارج از «فروشگاه Play» را پیگیری کنید، می‌توانید رویدادهای IAP را به‌صورت دستی بااستفاده از تکه‌کد زیر یا در WebView ثبت کنید.
برای ردیابی دستی خریدهای درون‌برنامه، مطمئن شوید که از Analytics کیت توسعه نرم‌افزار نسخه ۲۳.۲.۰+ (یا Firebase Android BoM نسخه ۳۴.۱۰.۰+) استفاده می‌کنید.
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);
}
}