Attivatori di Google Analytics

Google Analytics fornisce report sugli eventi che ti aiutano a capire il modo in cui gli utenti interagiscono con la tua app. Con Cloud Functions (1a generazione), può accedere agli eventi di conversione che hai registrato da dispositivi Apple e Android. e attivare funzioni basate su questi eventi.

Solo gli eventi Android e della piattaforma Apple contrassegnati come eventi di conversione sono attualmente supportati da Cloud Functions; Gli eventi di conversione web non sono attualmente disponibili. Puoi specificare quali eventi sono conversioni eventi nel Eventi del riquadro Analytics della console Firebase.

Nota: Cloud Functions for Firebase (2a generazione) non fornisce assistenza per gli eventi e gli attivatori descritti in questa guida. Poiché le funzioni di 1ª e 2ª generazione possono coesistere nello stesso file di origine, puoi comunque sviluppare e implementare questa funzionalità insieme alle funzioni di 2ª generazione.

Attiva una funzione Google Analytics

Cloud Functions supporta Google Analytics AnalyticsEvent Questo evento viene attivato ogni volta che l'attività utente genera un evento di conversione. Ad esempio, potresti scrivere una funzione che si attiva quando viene generato l'evento in_app_purchase, per indicare che si è verificato un acquisto in-app. Devi specificare l'evento Analytics con cui attivare la funzione utilizzando il metodo functions.analytics.event() e gestirlo all'interno del gestore di eventi onLog():

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

Accedere agli attributi evento

Con ogni evento di Analytics, hai accesso a tutte le e proprietà utente. Queste includono informazioni sull'utente, i dispositivo, l'app e le informazioni geografiche relative all'evento. Per l'elenco completo dei parametri e delle proprietà utente, vedi functions.analytics.

Per una funzione attivata da un acquisto, come illustrato in questo esempio, potresti voler accedere agli attributi utente, come la lingua dell'utente e il valore dell'evento (valueInUSD). Questo secondo attributo consente alla funzione di esempio di verificare se si tratta di un evento di conversione di alto valore, in modo da inviare un coupon di valore superiore ai clienti di valore.

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

Passaggi successivi

Per saperne di più sulla gestione degli eventi Analytics in Cloud Functions, consulta la documentazione di Google Analytics e la documentazione di riferimento di functions.analytics, quindi prova a eseguire l'esempio di codice coupon-on-purchase.