گسترش Google Analytics با Cloud Functions

Google Analytics گزارش‌های رویدادی ارائه می‌دهد که به شما کمک می‌کند نحوه تعامل کاربران با برنامه‌تان را درک کنید. با Cloud Functions (نسل اول)، می‌توانید به رویدادهای تبدیلی که از دستگاه‌های Apple و Android ثبت کرده‌اید دسترسی داشته باشید و براساس آن رویدادها، عملکردهایی را راه‌اندازی کنید.

راه‌اندازی تابع 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);
});

مراحل بعدی

برای کسب اطلاعات بیشتر درباره مدیریت رویدادهای Analytics در Cloud Functions، به سند Google Analytics و مرجع functions.analytics مراجعه کنید، و نمونه کد coupon-on-purchase را اجرا کنید.