قياس عمليات الشراء داخل التطبيق

اختيار نظام أساسي: +iOS Android Unity


عمليات الشراء داخل التطبيق هي محتوى رقمي أو ميزات يمكنك بيعها في تطبيق متوافق مع الأجهزة الجوّالة من خلال Google Play، لكي لا يحتاج تطبيقك إلى معالجة المعاملات المالية. ومن أمثلة عمليات الشراء داخل التطبيق المحتوى المستند إلى اشتراك أو الأجزاء المتميزة داخل الألعاب.

Analytics تعرض أحداث عمليات الشراء داخل التطبيق في تقرير عمليات الشراء داخل التطبيق.

بالنسبة إلى تطبيقات Android، تتكامل حزمة تطوير البرامج (SDK) الخاصة بخدمة Analytics مع Google Play.

في معظم الحالات، تجمع حزمة تطوير البرامج (SDK) الخاصة بخدمة Analytics أحداث عمليات الشراء داخل التطبيق تلقائيًا بدون الحاجة إلى طلبات واجهة برمجة التطبيقات في تطبيقك. بالإضافة إلى ذلك، إليك بعض الخيارات الإضافية لجمع أحداث عمليات الشراء داخل التطبيق:

  • يمكنك تسجيل أحداث عمليات الشراء داخل التطبيق يدويًا من تطبيقك مباشرةً، بدون التفاعل مع "متجر Google Play".

  • يمكنك أيضًا تسجيل أحداث عمليات الشراء داخل التطبيق يدويًا في WebView.

يوضّح هذا الدليل كيفية إعداد مشروعك للتتبُّع التلقائي، ويصف بعض الحالات الخاصة التي تتطلّب بضعة أسطر من الرموز البرمجية لتنفيذها.

قبل البدء

  • يمكنك إعداد مشروعك على Firebase وقاعدة رموز تطبيقك كما هو موضّح في البدء مع Google Analytics.

  • يمكنك ربط مشروعك على Firebase بموقع على "إحصاءات Google‏ 4".

  • تأكَّد من استخدام أحدث حزمة تطوير برامج (SDK):

    • لتتبُّع عمليات الشراء داخل التطبيق تلقائيًا: تأكَّد من أنّ تطبيقك يستخدم حزمة تطوير البرامج (SDK) الخاصة بخدمة Analytics الإصدار 17.3.0 أو إصدارًا أحدث (أو حزمة مواد Firebase Android BoM الإصدار 25.2.0 أو إصدارًا أحدث).
    • لتتبُّع عمليات الشراء داخل التطبيق يدويًا: تأكَّد من أنّ تطبيقك يستخدم حزمة تطوير البرامج (SDK) الخاصة بخدمة Analytics الإصدار 23.2.0 أو إصدارًا أحدث (أو Firebase Android BoM الإصدار 34.10.0 أو إصدارًا أحدث)

  • يمكنك ربط تطبيقاتك على Firebase بـ Google Play.

التنفيذ

في معظم الحالات، تسجِّل حزمة تطوير البرامج (SDK) الخاصة بخدمة "إحصاءات Google" أحداث عمليات الشراء داخل التطبيق تلقائيًا بدون الحاجة إلى رموز برمجية إضافية.

بالنسبة إلى تطبيقات Android، يمكنك قياس أحداث عمليات الشراء داخل التطبيق فور الربط بـ Google Play.

إذا كنت بحاجة إلى تتبُّع عمليات الشراء داخل التطبيق التي يتم إجراؤها خارج "متجر Google Play"، يمكنك تسجيل أحداث عمليات الشراء داخل التطبيق يدويًا باستخدام مقتطف الرمز البرمجي التالي أو في WebView.

لتتبُّع عمليات الشراء داخل التطبيق يدويًا، تأكَّد من استخدام Analytics حزمة تطوير البرامج (SDK) الإصدار 23.2.0 أو إصدارًا أحدث (أو Firebase Android BoM الإصدار 34.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);
  }
}