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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

הטמעה

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

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

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

כדי לעקוב באופן ידני אחרי רכישות באפליקציה, צריך לוודא שמשתמשים ב-Analytics SDK גרסה 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);
  }
}