מדידת רכישות מתוך האפליקציה

רכישות בתוך האפליקציה (IAP) הן תוכן דיגיטלי או תכונות שאתה יכול למכור באפליקציה לנייד דרך Google Play או Apple App Store כך שהאפליקציה שלך לא תצטרך לעבד עסקאות פיננסיות. דוגמאות לרכישות מתוך האפליקציה כוללות תוכן המבוסס על מנויים או חלקי משחק מיוחדים.

Analytics מציג אירועי IAP בדוח רכישות מתוך האפליקציה .

עבור אפליקציות אנדרואיד, ה-SDK של Analytics משתלב עם Google Play. עבור אפליקציות פלטפורמה של Apple, ה-SDK משתלב עם Apple App Store באמצעות ממשקי ה-API של StoreKit 1 ו-StoreKit 2 של Apple.

ברוב המקרים, ה-SDK של Analytics אוסף אוטומטית אירועי IAP מבלי לדרוש קריאות API באפליקציה שלך. מדריך זה מסביר כיצד להגדיר את הפרויקט שלך למעקב אוטומטי, והוא מתאר כמה מקרים מיוחדים הדורשים כמה שורות קוד ליישום.

לפני שאתה מתחיל

• הגדר את פרויקט Firebase ואת בסיס הקוד של האפליקציה שלך כמתואר ב'התחלה עם Google Analytics' .

• קשר את פרויקט Firebase שלך ​​לנכס Google Analytics 4.

• עבור אפליקציות פלטפורמת אפל:

  • ודא שהאפליקציה שלך משתמשת ב-Analytics SDK v6.20.0+.

• עבור אפליקציות אנדרואיד:

  • ודא שהאפליקציה שלך משתמשת ב-Analytics SDK v17.3.0+ (או Firebase Android BoM v25.2.0+).
  • קשר את אפליקציות Firebase שלך ​​ל-Google Play .

אם אתה מפתח אפליקציית אנדרואיד, תוכל למדוד אירועי IAP ברגע שאתה מקשר ל-Google Play. שאר המדריך הזה מתמקד באפליקציות פלטפורמת אפל.

אם אתה מפתח של Apple, ודא שאתה מכיר את ממשקי ה-API לרכישה של Apple StoreKit 1 ו-StoreKit 2 באפליקציה על ידי עיון בתיעוד של Apple .

יישום

מָהִיר

אם אתה משתמש ב-StoreKit 1, ה-SDK של Analytics רושם אוטומטית אירועי IAP.

אם אתה משתמש ב-StoreKit 2, השתמש בקוד הבא כדי לרשום אירועי IAP.

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 רושם אוטומטית אירועי IAP.

StoreKit 2 הוא Swift בלבד, כך שיישום Objective-C אינו נתמך.

Kotlin+KTX

כדי לרשום אירועי IAP, קישור ל-Google Play .

Java

כדי לרשום אירועי IAP, קישור ל-Google Play .