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

اختيار المنصة: +iOS Android Unity


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

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

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

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

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

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

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

قبل البدء

  • أعِدّ مشروع Firebase وقاعدة الرموز البرمجية لتطبيقك كما هو موضّح في مقالة بدء استخدام Google Analytics.

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

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

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

  • اربط تطبيقات Firebase بـ "Google Play".

التنفيذ

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

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

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

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