Attivatori di Google Analytics per Firebase
Google Analytics for Firebase fornisce report sugli eventi che ti aiutano a 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 efficace, poiché qualsiasi azione eseguita da un utente nella tua app può essere registrata e attivare 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 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 } }
Le informazioni sugli utenti, ad esempio quelle dell'applicazione o del dispositivo, sono disponibili nella proprietà userDim
. Le informazioni sull'evento registrato sono disponibili nell'array eventDim
. Gli oggetti contenuti nell'array
includono un campo name
che contiene 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
esegui il deployment della funzione
Per eseguire il deployment della funzione, specifica il tipo di evento e il progetto in cui hai configurato Firebase Auth. Nella console, è presente un campo per Event
Type (Tipo di evento), che contiene log
, l'unica opzione, e Log Event Name (Nome evento di log), che è l'evento di conversione che attiverà la funzione.
Nella riga di comando, è necessario utilizzare stringhe specifiche per specificare questi parametri. Il seguente comando Google Cloud CLI 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 esegui 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 classe nel codice sorgente. Facoltativo, a meno che tu non abbia utilizzato FUNCTION_NAME per specificare nel codice sorgente la funzione da eseguire durante il deployment. In questo caso, devi utilizzare --entry-point per indicare 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 di Google Analytics, comprese le informazioni
del progetto. Dovrebbe avere il seguente formato:
projects/YOUR_PROJECT_ID/events/CONVERSION_EVENT_NAME
|
--runtime RUNTIME |
Il nome del runtime che stai utilizzando. Per un elenco completo, consulta la documentazione di riferimento di gcloud .
|