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

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

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

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

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

قبل البدء

تطبيقات Android

  • تأكَّد من أنّ تطبيقك يستخدم الإصدار 17.3.0 أو إصدار أحدث من حزمة تطوير البرامج Analytics (أو الإصدار 25.2.0 أو إصدار أحدث من Firebase Android BoM).

  • ربط تطبيقاتك على Firebase بحساب Google Play

تطبيقات منصة Apple

  • تأكَّد من استخدام أحدث إصدار من حزمة SDK:

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

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

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

التنفيذ

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

عملية التنفيذ في تطبيقات Android

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

التنفيذ في تطبيقات منصة Apple

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

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

Swift

إذا كنت تستخدم الإصدار 1 من StoreKit، تسجّل حزمة تطوير البرامج (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

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

‫StoreKit 2 متوافق مع Swift فقط، لذا لا يمكن استخدام Objective-C.