Rozszerzanie Google Analytics za pomocą Cloud Functions

Google Analytics udostępnia raporty Zdarzenia, które pomagają zrozumieć, jak użytkownicy korzystają z aplikacji. Dzięki Cloud Functions (1 generacji) możesz uzyskiwać dostęp do zdarzeń konwersji zarejestrowanych na urządzeniach Apple i urządzeniach z Androidem oraz wywoływać funkcje na podstawie tych zdarzeń.

Obecnie Cloud Functions obsługuje tylko zdarzenia na platformie Apple i zdarzenia na Androidzie oznaczone jako zdarzenia konwersji. Zdarzenia konwersji w witrynie nie są obecnie dostępne. Możesz określić, które zdarzenia są zdarzeniami konwersji, na stronie Analytics > Zdarzenia w konsoli Firebase.

Uwaga: Cloud Functions for Firebase (2 generacji) nie obsługuje zdarzeń i reguł opisanych w tym przewodniku. Funkcje 1 generacji i 2 generacji mogą współistnieć w tym samym pliku źródłowym, więc nadal możesz rozwijać i wdrażać tę funkcję razem z funkcjami 2 generacji.

Aktywowanie funkcji Google Analytics

Cloud Functions obsługuje Google Analytics AnalyticsEvent. To zdarzenie jest wywoływane, gdy aktywność użytkownika generuje zdarzenie konwersji. Możesz na przykład napisać funkcję, która jest wywoływana po wygenerowaniu zdarzenia in_app_purchase, co oznacza, że nastąpił zakup w aplikacji. Musisz określić zdarzenie Analytics, które ma wywołać funkcję, za pomocą metody functions.analytics.event() i obsłużyć je w module obsługi zdarzeń onLog():

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

Atrybuty zdarzenia dostępu

W przypadku każdego zdarzenia Analytics masz dostęp do wszystkich odpowiednich parametrów i właściwości użytkownika. Obejmują one informacje o użytkowniku, urządzeniu, aplikacji i lokalizacji geograficznej zdarzenia. Pełną listę parametrów i właściwości użytkownika znajdziesz w dokumentacji functions.analytics.

W przypadku funkcji wywoływanej przez zakup, jak w tym przykładzie, możesz chcieć uzyskać dostęp do atrybutów użytkownika, takich jak język i wartość zdarzenia (valueInUSD). Ten drugi atrybut umożliwia przykładowej funkcji sprawdzenie, czy jest to zdarzenie konwersji o wysokiej wartości, aby wysłać kupon o wyższej wartości do wartościowych klientów.

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

Dalsze kroki

Więcej informacji o obsłudze zdarzeń Analytics w Cloud Functions znajdziesz w dokumentacji Google Analytics i w functions.analytics. Możesz też spróbować uruchomić przykładowy kod coupon-on-purchase.