הרחבת Google Analytics באמצעות Cloud Functions

Google Analytics מספק דוחות אירועים שיעזרו לכם להבין איך המשתמשים מקיימים אינטראקציה עם האפליקציה. באמצעות Cloud Functions (דור ראשון), תוכלו לגשת לאירועי המרה שתועדו במכשירי Apple ו-Android ולהפעיל פונקציות על סמך האירועים האלה.

נכון לעכשיו, ב-Cloud Functions יש תמיכה רק באירועים בפלטפורמת Apple ובאירועים ב-Android שמסומנים כאירועי המרה. אירועי המרה באינטרנט לא זמינים כרגע. אפשר לציין אילו אירועים הם אירועי המרה בכרטיסייה אירועים בחלונית Analytics במסוף Firebase.

הערה: ב-Cloud Functions for Firebase (דור שני) אין תמיכה באירועים ובטריגרים שמפורטים במדריך הזה. מכיוון שפונקציות מדור ראשון ומדור שני יכולות להתקיים זו לצד זו באותו קובץ מקור, עדיין תוכלו לפתח ולפרוס את הפונקציונליות הזו יחד עם פונקציות מדור שני.

הפעלת פונקציית Google Analytics

Cloud Functions תומך ב-Google Analytics AnalyticsEvent. האירוע הזה מופעל בכל פעם שפעילות של משתמש יוצרת אירוע המרה. לדוגמה, אפשר לכתוב פונקציה שתופעל כשהאירוע in_app_purchase נוצר, כדי לציין שהתרחשה רכישה מתוך האפליקציה. צריך לציין את האירוע Analytics שרוצים להפעיל את הפונקציה באמצעות השיטה functions.analytics.event(), ולטפל באירוע בתוך גורם הטיפול באירועים onLog():

exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  // ...
});

גישה למאפייני האירוע

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

בפונקציה שמופיעה בדוגמה הזו, שמופעל על ידי רכישה, כדאי לגשת למאפייני משתמשים כמו השפה של המשתמש והערך של האירוע (valueInUSD). המאפיין השני הזה מאפשר לפונקציה לדגום לבדוק אם מדובר באירוע המרה בעל ערך גבוה, כדי לשלוח שובר בעל ערך גבוה יותר ללקוחות חשובים.

/**
 * After a user has completed a purchase, send them a coupon via FCM valid on their next purchase.
 */
exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  const user = event.user;
  const uid = user.userId; // The user ID set via the setUserId API.
  const purchaseValue = event.valueInUSD; // Amount of the purchase in USD.
  const userLanguage = user.deviceInfo.userDefaultLanguage; // The user language in language-country format.

  // For purchases above 500 USD, we send a coupon of higher value.
  if (purchaseValue > 500) {
    return sendHighValueCouponViaFCM(uid, userLanguage);
  }
  return sendCouponViaFCM(uid, userLanguage);
});
index.js

השלבים הבאים

למידע נוסף על טיפול באירועי Analytics ב-Cloud Functions, תוכלו לעיין במסמכי העזרה של Google Analytics ובחומר העזר של functions.analytics, ולנסות להריץ את דוגמת הקוד coupon-on-purchase.