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

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

בשלב הזה, Cloud Functions תומך רק באירועים בפלטפורמות של אפל וב-Android שמסומנים כאירועי המרה. אירועי המרה באתר לא זמינים כרגע. אפשר לציין אילו אירועים הם אירועי המרה בדף Analytics > Events במסוף 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.