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

בחירת פלטפורמה: ‫iOS+‎ Android Unity


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

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

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

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

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

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

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

  • מוודאים שאתם משתמשים ב-SDK העדכני ביותר:

    • למעקב אוטומטי אחרי רכישות באפליקציה: מוודאים שהאפליקציה משתמשת בגרסה Analytics SDK v6.20.0 ואילך.

    • לצורך מעקב ידני אחרי רכישות באפליקציה: מוודאים שהאפליקציה משתמשת בגרסה 12.5.0 ואילך של Analytics SDK.

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

הטמעה

ברוב המקרים, Analytics SDK רושם ביומן באופן אוטומטי אירועים של רכישות מתוך האפליקציה, בלי שנדרש קוד נוסף.

באפליקציות ל-iOS, אם אתם משתמשים ב-StoreKit 1, ‏ Analytics SDK מתעד באופן אוטומטי אירועי IAP. אם אתם משתמשים ב-StoreKit 2, אתם יכולים לרשום ביומן אירועים מאומתים של רכישות באפליקציה באמצעות קטע הקוד שבהמשך.

לחלופין, אם אתם צריכים לעקוב אחרי רכישות מתוך האפליקציה שבוצעו מחוץ ל-App Store, אתם יכולים לתעד אירועי רכישה מתוך האפליקציה באופן ידני ב-WebView. שימו לב שה-SDK ימשיך לתעד באופן אוטומטי רכישות באפליקציה ככל האפשר, ולא יבטל כפילויות של אירועי רכישה באפליקציה שמתועדים באופן ידני. אם אתם עוקבים אחרי רכישות באפליקציה באופן ידני, אתם צריכים לוודא שאתם משתמשים בגרסה 12.5.0 ואילך של Analytics SDK.

Swift

אם אתם משתמשים ב-StoreKit 1, ‏ Analytics SDK מתעד באופן אוטומטי אירועים של רכישות מתוך האפליקציה.

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

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