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

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


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

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

بالنسبة إلى تطبيقات منصة Apple، تتكامل حزمة تطوير البرامج (SDK) مع Apple App Store باستخدام واجهات برمجة التطبيقات StoreKit 1 وStoreKit 2 من Apple.

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

قبل البدء

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

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

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

    • لتتبُّع عمليات الشراء داخل التطبيق تلقائيًا: تأكَّد من أنّ تطبيقك يستخدم حزمة تطوير البرامج (SDK) لإحصاءات Google الإصدار 6.20.0 أو إصدارًا أحدث.

    • لتتبُّع عمليات الشراء داخل التطبيق يدويًا: تأكَّد من أنّ تطبيقك يستخدم حزمة تطوير البرامج (SDK) لإحصاءات Google الإصدار 12.5.0 أو إصدارًا أحدث.

  • تأكَّد من الإلمام بواجهات برمجة التطبيقات Apple StoreKit 1 وStoreKit 2 لعمليات الشراء داخل التطبيق من خلال مراجعة مستندات Apple.

التنفيذ

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

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

بدلاً من ذلك، إذا كنت بحاجة إلى تتبُّع عمليات الشراء داخل التطبيق التي يتم إجراؤها خارج App Store، يمكنك تسجيل أحداث عمليات الشراء داخل التطبيق يدويًا في WebView. يُرجى العِلم أنّ حزمة تطوير البرامج (SDK) ستواصل تسجيل عمليات الشراء داخل التطبيق تلقائيًا حيثما أمكن، ولن تزيل الأحداث المكرّرة من أحداث عمليات الشراء داخل التطبيق التي يتم تسجيلها يدويًا. تأكَّد من استخدام حزمة تطوير البرامج (SDK) في "إحصاءات Google" الإصدار 12.5.0 أو إصدارًا أحدث عند تتبُّع عمليات الشراء داخل التطبيق يدويًا.

Swift

إذا كنت تستخدم StoreKit 1، تسجِّل حزمة تطوير البرامج (SDK) في Analytics تلقائيًا أحداث عمليات الشراء داخل التطبيق.

إذا كنت تستخدم StoreKit 2، استخدِم الرمز البرمجي التالي لتسجيل أحداث عمليات الشراء داخل التطبيق.

import StoreKit
import FirebaseAnalytics

// A user tapped a button to purchase an item.
func userTappedPurchaseUpgradeButton() {
  let product = ...
  purchaseSomeProduct(product)
}

func purchaseSomeProduct(_ product: Product) {
  // Purchase a Product. This is mostly standard boilerplate StoreKit 2
  // code, except for the Analytics.logTransaction() call.
  let result = try await product.purchase()
  switch result {
  case .success(let verification):
      let transaction = try checkVerified(verification)

      // Call this Firebase API to log the in-app purchase event.
      Analytics.logTransaction(transaction)

      await transaction.finish()
  ...
}

Objective-C

إذا كنت تستخدم StoreKit 1، تسجِّل حزمة تطوير البرامج (SDK) في Analytics تلقائيًا أحداث عمليات الشراء داخل التطبيق.

لا يتوفّر StoreKit 2 إلا بلغة Swift، لذا لا يتوفّر تنفيذ بلغة Objective-C.