רכישות מתוך האפליקציה (IAP) הן תכונות או תוכן דיגיטלי שאפשר למכור באפליקציה לנייד דרך Google Play או Apple App Store, כך שלא תצטרכו לעבד עסקאות פיננסיות דרך האפליקציה. דוגמאות לרכישות מהאפליקציה כוללות תוכן שמבוסס על מינויים או פריטים מיוחדים במשחקים.
Analytics מציג אירועי IAP בדוח רכישות מתוך האפליקציה.
באפליקציות ל-Android, ערכת ה-SDK Analytics משולבת עם Google Play. באפליקציות לפלטפורמת Apple, ה-SDK משולב עם Apple App Store באמצעות ממשקי ה-API StoreKit 1 ו-StoreKit 2 של Apple.
ברוב המקרים, ערכת ה-SDK של Analytics אוספת באופן אוטומטי אירועים של רכישות מתוך האפליקציה, בלי שצריך לבצע קריאות ל-API באפליקציה. במדריך הזה מוסבר איך להגדיר את הפרויקט למעקב אוטומטי, ומתוארים בו כמה מקרים מיוחדים שבהם צריך להוסיף כמה שורות קוד כדי להטמיע את המעקב.
לפני שמתחילים
מגדירים את פרויקט Firebase ואת בסיס הקוד של האפליקציה כמו שמתואר במאמר תחילת העבודה עם Google Analytics.
באפליקציות לפלטפורמת Apple:
- מוודאים שהאפליקציה משתמשת ב-Analytics SDK בגרסה 6.20.0 ואילך.
באפליקציות ל-Android:
- חשוב לוודא שבאפליקציה נעשה שימוש ב-Analytics SDK גרסה 17.3.0 ואילך (או ב-Firebase Android BoM גרסה 25.2.0 ואילך).
- קישור אפליקציות ב-Firebase אל Google Play
אם אתם מפתחים אפליקציה ל-Android, אתם יכולים למדוד אירועים של רכישות מתוך האפליקציה ברגע שתקשרו אל Google Play. שאר המדריך הזה מתמקד באפליקציות לפלטפורמת Apple.
אם אתם מפתחים לאפל, כדאי לעיין בתיעוד של אפל כדי להכיר את ממשקי ה-API של StoreKit 1 ו-StoreKit 2 לרכישות מתוך האפליקציה.
הטמעה
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.
Kotlin
כדי לרשום אירועים של רכישות מתוך האפליקציה, צריך לקשר אל Google Play.
Java
כדי לרשום אירועים של רכישות מתוך האפליקציה, צריך לקשר אל Google Play.