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

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


عمليات الشراء داخل التطبيق (IAP) هي محتوى أو ميزات رقمية يمكنك بيعها في تطبيق على الأجهزة الجوّالة من خلال 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:

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

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

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

التنفيذ

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

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

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

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.