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

عمليات الشراء داخل التطبيق (IAP) هي محتوى أو ميزات رقمية يمكنك بيعها في تطبيق جوال من خلال Google Play أو Apple App Store حتى لا يضطر تطبيقك إلى معالجة المعاملات المالية. تتضمن أمثلة عمليات الشراء داخل التطبيق المحتوى القائم على الاشتراك أو أجزاء اللعبة الخاصة.

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

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

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

قبل ان تبدأ

• قم بإعداد مشروع Firebase وقاعدة التعليمات البرمجية لتطبيقك كما هو موضح في الخطوات الأولى مع Google Analytics .

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

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

  • تأكد من أن تطبيقك يستخدم Analytics SDK v6.20.0+.

• لتطبيقات أندرويد:

  • تأكد من أن تطبيقك يستخدم Analytics SDK v17.3.0+ (أو Firebase Android BoM v25.2.0+).
  • ربط تطبيقات Firebase بـ Google Play .

إذا كنت تعمل على تطوير تطبيق Android، فيمكنك قياس أحداث الشراء داخل التطبيق (IAP) بمجرد الارتباط بـ 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()
  ...
}