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

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

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

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

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

قبل البدء

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

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

• بالنسبة إلى تطبيقات منصة Apple:

  • تأكَّد من أنّ تطبيقك يستخدم الإصدار 6.20.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Analytics.

• بالنسبة إلى تطبيقات Android:

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

إذا كنت تُطوّر تطبيقًا لنظام التشغيل Android، يمكنك قياس أحداث عمليات الشراء داخل التطبيق فور الربط بـ Google Play. يركز الجزء المتبقّي من هذا الدليل على التطبيقات المتوافقة مع منصة Apple.

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

التنفيذ

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()
  ...
}