Google Analytics (分析) 觸發條件

Google Analytics 提供事件報表,協助您瞭解使用者與應用程式的互動方式。透過 Cloud Functions (第 1 代),您可以存取從 Apple 和 Android 裝置記錄的轉換事件,並根據這些事件觸發功能。

觸發 Google Analytics 函式

Cloud Functions 支援 Google Analytics AnalyticsEvent。只要使用者活動產生轉換事件,就會觸發這項事件。舉例來說,您可以編寫函式,在產生 in_app_purchase 事件時觸發,表示已發生應用程式內購買交易。您必須使用 functions.analytics.event() 方法指定要觸發函式的 Analytics 事件,並在 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);
});

後續步驟

如要進一步瞭解如何在 Cloud Functions 中處理 Analytics 事件,請參閱 Google Analytics 說明文件functions.analytics 參考資料,並嘗試執行「購買時使用優待券」程式碼範例。