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

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


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

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

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

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

  • يمكنك تسجيل أحداث الشراء داخل التطبيق يدويًا من تطبيقك مباشرةً، بدون التفاعل مع "متجر Google 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 أو إصدار أحدث من حزمة تطوير البرامج 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);
  }
}