דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

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

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

אפליקציות ל-Android

חשוב לוודא שבאפליקציה נעשה שימוש ב-Analytics SDK גרסה 17.3.0 ואילך (או ב-Firebase Android BoM גרסה 25.2.0 ואילך).
קישור אפליקציות ב-Firebase אל Google Play

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

אפליקציות לפלטפורמות של Apple

מוודאים שאתם משתמשים בגרסה העדכנית ביותר של ה-SDK:
- למעקב אוטומטי אחר רכישות מתוך האפליקציה: מוודאים שהאפליקציה משתמשת ב-Analytics SDK בגרסה 6.20.0 ואילך.
- למעקב ידני אחר רכישות מתוך האפליקציה: מוודאים שהאפליקציה משתמשת בגרסה 12.5.0 ואילך של Analytics SDK.
כדאי לעיין בתיעוד של Apple כדי להכיר את ממשקי ה-API של רכישות מתוך האפליקציה StoreKit 1 ו-StoreKit 2.

הטמעה

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

הטמעה באפליקציות ל-Android

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

הטמעה באפליקציות לפלטפורמת Apple

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

לחלופין, אם אתם צריכים לעקוב אחרי רכישות מתוך האפליקציה שבוצעו מחוץ ל-App Store, אתם יכולים לתעד אירועי רכישות מתוך האפליקציה באופן ידני ב-WebView. שימו לב: ה-SDK ימשיך לתעד באופן אוטומטי רכישות מתוך האפליקציה ככל האפשר, ולא יבטל כפילויות של אירועי רכישה מתוך האפליקציה שתועדו באופן ידני. כשעוקבים אחרי רכישות מתוך האפליקציה באופן ידני, צריך לוודא שמשתמשים ב-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