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

اختيار المنصة: +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".

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

التنفيذ

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

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

بدلاً من ذلك، إذا كنت بحاجة إلى تتبُّع عمليات الشراء داخل التطبيق التي تتم خارج متجر التطبيقات، يمكنك تسجيل أحداث الشراء داخل التطبيق يدويًا في 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.