Attivatori di Google Analytics per Firebase
Google Analytics for Firebase fornisce report sugli eventi che ti consentono di capire in che modo gli utenti interagiscono con la tua app. Con Cloud Functions, puoi accedere agli eventi di conversione registrati da dispositivi Apple e Android e attivare funzioni in base a questi eventi.
Tipi di evento
Google Analytics for Firebase attiva l'evento log
. Si tratta di un tipo di evento molto efficace, dal momento che qualsiasi azione compiuta da un utente nella tua app può essere registrata e, di conseguenza, attiva una funzione.
Tipo di evento | Trigger |
---|---|
providers/google.firebase.analytics/eventTypes/event.log
|
Si attiva quando viene registrato un evento di conversione. |
Cloud Functions può rispondere al logging di un evento di conversione di Google Analytics per Firebase. Ad esempio, se un utente effettua un acquisto in-app, viene registrato un evento di conversione in_app_purchase
che può essere utilizzato da Cloud Functions.
Struttura dell'evento
Questo trigger richiama la tua funzione con un evento simile a quello mostrato di seguito:
{ "eventDim": [ // Contains a single event { "date": "20090213", "name": "screen_view", "params": { "firebase_conversion": { "intValue": "1" }, "firebase_event_origin": { "stringValue": "auto" }, "firebase_previous_class": { "stringValue": "MainActivity" }, "firebase_previous_id": { "intValue": "1928209043426257906" }, "firebase_previous_screen": { "stringValue": "id-D-D" }, "firebase_screen": { "stringValue": "id-C-C" }, "firebase_screen_class": { "stringValue": "MainActivity" }, "firebase_screen_id": { "intValue": "1234567890000" } }, "previousTimestampMicros": "1234567890000", "timestampMicros": "1234567890000" } ], "userDim": { // A UserDimensions object } }
Informazioni sull'utente come informazioni sull'applicazione o sul dispositivo sono disponibili nella proprietà userDim
. Le informazioni sull'evento registrato sono disponibili nell'array eventDim
. Gli oggetti contenuti in questo array
includono un campo name
contenente il nome dell'evento di conversione (ad esempio
in_app_purchase
). Anche i campi personalizzati configurati in Google Analytics for Firebase
vengono visualizzati qui.
Esempio di codice
Utilizza il seguente snippet per elaborare questa risposta:
Node.js
Python
Go
C#
Ruby
PHP
Deployment della funzione
Per eseguire il deployment della funzione, specifica il tipo di evento e il progetto in cui è configurato Firebase Auth. Nella console è presente un campo per Tipo
evento, che contiene log
, l'unica opzione, e Nome evento di log, che è l'evento di conversione che attiverà la funzione.
Nella riga di comando, per specificare questi parametri è necessario utilizzare stringhe specifiche. Il seguente comando gcloud esegue il deployment di una funzione che si attiva quando un utente effettua un acquisto in-app:
gcloud functions deploy FUNCTION_NAME \ --entry-point ENTRY_POINT \ --trigger-event providers/google.firebase.analytics/eventTypes/event.log \ --trigger-resource projects/YOUR_PROJECT_ID/events/in_app_purchase \ --runtime RUNTIME
Argomento | Descrizione |
---|---|
FUNCTION_NAME |
Il nome registrato della Cloud Function di cui stai eseguendo il deployment.
Può essere il nome di una funzione nel codice sorgente o una stringa arbitraria. Se FUNCTION_NAME è una stringa arbitraria, devi includere il flag --entry-point .
|
--entry-point ENTRY_POINT |
Il nome di una funzione o di una classe nel codice sorgente. Facoltativo, a meno che
tu non abbia utilizzato FUNCTION_NAME
per specificare la funzione
nel codice sorgente da eseguire durante il deployment. In questo caso, devi utilizzare --entry-point per fornire il nome della funzione eseguibile.
|
--trigger-event NAME |
Il nome del tipo di evento che la funzione vuole ricevere. Per
Google Analytics for Firebase, il valore è sempre
providers/google.firebase.analytics/eventTypes/event.log.
|
--trigger-resource NAME |
Il nome completo dell'evento Google Analytics, incluse le informazioni del progetto. Dovrebbe avere il formato:
projects/YOUR_PROJECT_ID/events/CONVERSION_EVENT_NAME
|
--runtime RUNTIME |
Il nome del runtime in uso. Per un elenco completo, consulta la documentazione di riferimento di gcloud .
|