‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

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

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

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

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

הטמעה

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

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

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

Swift

אם אתם משתמשים ב-StoreKit 1, ערכת ה-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