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

בחירת פלטפורמה:

‫iOS+ Android

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

‫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 בגרסה 6.20.0 ואילך.
- לצורך מעקב ידני אחרי רכישות באפליקציה: מוודאים שהאפליקציה משתמשת בגרסה 12.5.0 ואילך של Analytics SDK.
כדאי לעיין בתיעוד של Apple כדי להכיר את ממשקי ה-API של רכישות מתוך האפליקציה StoreKit 1 ו-StoreKit 2.

הטמעה

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

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

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

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