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