Rozszerzanie Google Analytics za pomocą Cloud Functions

Google Analytics udostępnia raporty o zdarzeniach, 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 usługę 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 for Firebase (2 generacji) nie obsługuje 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 oznacza, że zakup w aplikacji został zrealizowany. Musisz określić 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

Przy każdym zdarzeniu Analytics masz dostęp do wszystkich powiązanych 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 tabeli Cloud Functions, zapoznaj się z dokumentacją Google Analytics oraz functions.analytics, i spróbuj uruchomić przykładowy kod, kupon przy zakupie.