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

בחירת פלטפורמה: iOS+‎ Android Unity


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

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

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

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

  • אתם יכולים לתעד אירועי רכישה באפליקציה באופן ידני ישירות מהאפליקציה, בלי אינטראקציה עם חנות Play.

  • אפשר גם לתעד אירועי רכישות מתוך האפליקציה באופן ידני ב-WebView.

במדריך הזה מוסבר איך להגדיר את הפרויקט למעקב אוטומטי, ומתוארים בו כמה מקרים מיוחדים שבהם צריך להטמיע כמה שורות קוד.

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

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

  • מקשרים את הפרויקט ב-Firebase לנכס Google Analytics 4.

  • חשוב לוודא שאתם משתמשים בגרסה העדכנית של ה-SDK:

    • למעקב אוטומטי אחרי רכישות באפליקציה: ודאו שבאפליקציה שלכם מותקנת גרסה 17.3.0 ומעלה של ה-SDK של Analytics (או גרסה 25.2.0 ומעלה של Firebase Android BoM).
    • למעקב ידני אחרי רכישות באפליקציה: ודאו שהאפליקציה משתמשת ב-Analytics SDK בגרסה 23.2.0 ומעלה (או ב-Firebase Android BoM בגרסה 34.10.0 ומעלה)

  • מקשרים את האפליקציות ב-Firebase אל Google Play.

הטמעה

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

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

אם אתם צריכים לעקוב אחרי רכישות באפליקציה שבוצעו מחוץ לחנות Play, אתם יכולים לתעד אירועי IAP באופן ידני באמצעות קטע הקוד הבא או ב-WebView.

כדי לעקוב באופן ידני אחרי רכישות באפליקציה, צריך לוודא שמשתמשים ב-SDK של Analytics בגרסה 23.2.0 ואילך (או ב-Firebase Android BoM בגרסה 34.10.0 ואילך).

Kotlin 

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java 

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}