Attivatori di Google Analytics

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 registrati da dispositivi Apple e Android e attivare funzioni in base a questi eventi.

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

Nota: Cloud Functions for Firebase (2ª gen.) non supporta 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, puoi scrivere una funzione che si attiva quando viene generato l'evento in_app_purchase, a 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 Analytics, hai accesso a tutti i parametri e le proprietà utente pertinenti. Sono incluse informazioni sull'utente, sul dispositivo, sull'app e informazioni geografiche relative all'evento. Per l'elenco completo dei parametri e delle proprietà utente, consulta la documentazione di riferimento di 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 scoprire 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.