Rozszerzanie Google Analytics za pomocą Cloud Functions

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

Tylko zdarzenia na platformie Apple i w Androidzie oznaczone jako zdarzenia konwersji są obecnie obsługiwane przez Cloud Functions; Zdarzenia konwersji w witrynie nie są obecnie dostępny. Możesz określić, które zdarzenia są konwersjami wydarzenia w zakresie Karta Zdarzenia w panelu Analytics w konsoli Firebase.

Uwaga: Cloud Functions dla Firebase (2 generacji) nie zapewnia obsługi zdarzenia i aktywatory opisane w tym przewodniku. Ponieważ 1 generacji i 2 generacji funkcje mogą współistnieć obok siebie w tym samym pliku źródłowym, nadal możesz opracowywania i wdrażania tej funkcji przy użyciu funkcji 2 generacji.

Aktywowanie funkcji Google Analytics

Cloud Functions obsługuje Google Analytics AnalyticsEvent To zdarzenie jest wywoływane za każdym razem, gdy aktywność użytkownika generuje zdarzenie konwersji. Możesz na przykład napisać funkcję, która uruchamia się po wygenerowaniu zdarzenia in_app_purchase, co wskazuje, że zakup w aplikacji został zrealizowany. Musisz wskazać zdarzenie Analytics, które: chcesz aktywować funkcję za pomocą functions.analytics.event() i obsługuje zdarzenia w tagu onLog() moduł obsługi zdarzeń:

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

Atrybuty zdarzenia dostępu

Z każdym zdarzeniem Analytics masz dostęp do wszystkich i właściwościach użytkownika. Obejmują one informacje o użytkowniku, urządzenie, aplikację i informacje geograficzne dotyczące wydarzenia. Pełną listę parametrów i właściwości użytkownika znajdziesz functions.analytics.

W przypadku funkcji wywoływanej przez zakup, jak pokazano na ten fragment, warto uzyskać dostęp do atrybutów użytkownika, takich jak język użytkownika jako wartość zdarzenia (valueInUSD). Ten drugi atrybut pozwala funkcji przykładowej sprawdzić, czy zdarzenia konwersji o dużej wartości, by wysyłać wartościowy kupon 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

Aby dowiedzieć się więcej o obsłudze zdarzeń Analytics w Cloud Functions, zapoznaj się z dokumentacją Google Analytics oraz odniesienie do functions.analytics, i spróbuj uruchomić przykładowy kod, kupon przy zakupie.