تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

عمليات الشراء داخل التطبيق هي محتوى رقمي أو ميزات يمكنك بيعها في تطبيق متوافق مع الأجهزة الجوّالة من خلال 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 أو إصدار أحدث من حزمة تطوير البرامج Analytics (أو الإصدار 25.2.0 أو إصدار أحدث من Firebase Android BoM).
- ربط تطبيقاتك على Firebase بحساب Google Play

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

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

التنفيذ

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

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

Kotlin

لتسجيل أحداث الشراء داخل التطبيق، يُرجى الانتقال إلى Google Play.

Java