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

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

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

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

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

לפני שמתחילים

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

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

הטמעה

Swift

אם אתם משתמשים ב-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, אירועי IAP מתועדים באופן אוטומטי ביומן על ידי ה-SDK של Analytics.

StoreKit 2 הוא Swift בלבד, לכן אין תמיכה בהטמעה של Objective-C.

Kotlin+KTX

כדי לתעד אירועי IAP, צריך ליצור קישור אל Google Play.

Java

כדי לתעד אירועי IAP, צריך ליצור קישור אל Google Play.