Estendi Google Analytics con Cloud Functions

Google Analytics fornisce report sugli eventi che ti aiutano a capire come gli utenti interagiscono con la tua app. Con Cloud Functions (1ª gen.), puoi accedere agli eventi di conversione che hai registrato da dispositivi Apple e Android e attivare le funzioni in base a questi eventi.

Al momento, Cloud Functions supporta solo gli eventi delle piattaforme Apple e Android contrassegnati come eventi di conversione ; gli eventi di conversione web non sono attualmente disponibili.Cloud Functions Puoi specificare quali eventi sono di conversione eventi nella scheda Eventi del Firebase console riquadro Analytics.

Nota: Cloud Functions for Firebase (2ª gen.) non fornisce supporto per gli eventi e i trigger descritti in questa guida. Poiché le funzioni di 1ª gen. e 2ª gen. possono coesistere nello stesso file di origine, puoi comunque sviluppare ed eseguire il deployment di questa funzionalità insieme alle funzioni di 2ª gen.

Attivare una funzione Google Analytics

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

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

Accedere agli attributi degli eventi

Con ogni Analytics evento, hai accesso a tutti i parametri e le proprietà utente pertinenti. Questi includono informazioni sull'utente, sul dispositivo, sull'app e informazioni geografiche per l'evento. Per l'elenco completo dei parametri e delle proprietà utente, consulta il functions.analytics riferimento.

Per una funzione attivata dall'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 Google Analytics e il riferimento functions.analytics, e prova a eseguire l'esempio di codice coupon-on-purchase.