Điều kiện kích hoạt Google Analytics

Google Analytics cung cấp các báo cáo sự kiện giúp bạn hiểu cách người dùng tương tác với ứng dụng của bạn. Với Cloud Functions (thế hệ 1), bạn có thể truy cập vào các sự kiện chuyển đổi mà bạn đã ghi lại từ các thiết bị Apple và Android, đồng thời kích hoạt các hàm dựa trên các sự kiện đó.

Hiện tại, Cloud Functions chỉ hỗ trợ các sự kiện trên nền tảng Apple và Android được đánh dấu là sự kiện chuyển đổi; các sự kiện chuyển đổi trên web hiện không được hỗ trợ. Bạn có thể chỉ định những sự kiện chuyển đổi sự kiện trong Thẻ Sự kiện trong ngăn Analytics trên bảng điều khiển Firebase.

Lưu ý: Cloud Functions for Firebase (thế hệ thứ 2) không cung cấp hỗ trợ cho các sự kiện và điều kiện kích hoạt được mô tả trong hướng dẫn này. Vì thế hệ 1 và thế hệ 2 có thể cùng tồn tại song song trong cùng một tệp nguồn, bạn vẫn có thể phát triển và triển khai chức năng này cùng với các hàm thế hệ thứ 2.

Kích hoạt hàm Google Analytics

Cloud Functions hỗ trợ Google Analytics AnalyticsEvent. Sự kiện này được kích hoạt bất cứ khi nào hoạt động của người dùng tạo ra một sự kiện chuyển đổi. Ví dụ: bạn có thể viết một hàm kích hoạt khi sự kiện in_app_purchase được tạo, cho biết rằng một giao dịch mua hàng trong ứng dụng đã xảy ra. Bạn phải chỉ định sự kiện Analytics mà bạn muốn kích hoạt hàm của mình bằng cách sử dụng functions.analytics.event() và xử lý sự kiện trong onLog() trình xử lý sự kiện:

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

Truy cập vào các thuộc tính sự kiện

Với mỗi sự kiện Analytics, bạn có quyền truy cập vào tất cả các thông số và thuộc tính người dùng liên quan. Những thông tin này bao gồm thông tin về người dùng, thiết bị, ứng dụng và thông tin địa lý cho sự kiện. Để biết danh sách đầy đủ các tham số và thuộc tính người dùng, hãy xem tài liệu tham khảo về functions.analytics.

Đối với hàm được kích hoạt bằng giao dịch mua như minh hoạ trong mẫu này, bạn nên truy cập vào các thuộc tính người dùng như ngôn ngữ của người dùng và giá trị của sự kiện (valueInUSD). Thuộc tính thứ hai này cho phép hàm mẫu kiểm tra xem đây có phải là sự kiện chuyển đổi có giá trị cao hay không, để gửi phiếu giảm giá có giá trị cao hơn cho những khách hàng có giá trị.

/**
 * 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

Các bước tiếp theo

Để tìm hiểu thêm về cách xử lý các sự kiện Analytics trong Cloud Functions, hãy xem tài liệu về Google Analytics và Tham chiếu functions.analytics, và thử chạy mã mẫu Phiếu giảm giá khi mua hàng.