1. Introduzione
Ultimo aggiornamento: 25/01/2021
Cosa creerai
In questo codelab, imparerai a implementare eventi personalizzati con GA4F e a lanciare campagne per azione tramite Google Ads per l'app Flutter.
Useremo l'app Flutter predefinita con un semplice widget contatore. Pubblicheremo la nostra app a potenziali utenti, che probabilmente faranno clic sul widget contatore.
Cosa imparerai a fare
- Come inizializzare GA4F (Google Analytics for Firebase) in Flutter
- Come creare eventi e parametri personalizzati
- Come importare eventi da Firebase in Google Ads
- Come lanciare campagne per azione con eventi personalizzati
Che cosa ti serve
- Android Studio 3.6 o versioni successive
- Xcode (per supporto iOS)
- Account Firebase
- Account Google Ads
2. Avvia un nuovo progetto Flutter
Creare una semplice app Flutter basata su modelli. Modificherai questa app iniziale per questo codelab.
Avvia Android Studio.
- Se non hai progetti aperti, seleziona Start a new Flutter ap (Avvia una nuova app Flutter) dalla pagina di benvenuto. Altrimenti, seleziona File > Nuovo > Nuovo progetto Flutter.
- Seleziona Flutter Application (Applicazione Flutter) come tipo di progetto e fai clic su Next (Avanti).
- Verifica che il percorso dell'SDK Flutter specifichi la posizione dell'SDK. Seleziona Installa SDK se il campo di testo è vuoto.
- Inserisci il nome del progetto e fai clic su Avanti.
- Utilizza il nome del pacchetto predefinito suggerito da Android Studio e fai clic su Avanti.
- Fai clic su Fine.
- Attendi che Android Studio installi l'SDK e crei il progetto.
3. Crea e configura un progetto Firebase
Per iniziare a utilizzare Firebase, devi creare e impostare un progetto Firebase.
Creare un progetto Firebase
- Accedi a Firebase.
Nella console Firebase, fai clic su Aggiungi progetto (o Crea un progetto) e assegna al progetto Firebase il nome Firebase-Flutter-Ads o un nome a tua scelta.
- Fai clic sulle varie opzioni di creazione del progetto. Accetta i termini di Firebase, se richiesto. Dovresti attivare Google Analytics per questo progetto perché hai bisogno degli eventi di Google Analytics per monitorare gli eventi di azione e analizzare le conversioni.
Per saperne di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.
4. Configurazione Firebase specifica per piattaforma (Android)
Configurare Android
- Nella console Firebase, seleziona Panoramica del progetto nel menu di navigazione a sinistra, quindi fai clic sul pulsante Android in "Inizia aggiungendo Firebase alla tua app"
Verrà visualizzata la finestra di dialogo mostrata nella schermata seguente.
- Il valore importante da fornire è il nome del pacchetto Android, che si otterrà seguendo i passaggi riportati di seguito.
- Nella directory dell'app Flutter, apri il file
android/app/src/main/AndroidManifest.xml
. - Nell'elemento
manifest
, trova il valore stringa dell'attributopackage
. Questo valore è il nome del pacchetto Android (ad esempiocom.yourcompany.yourproject
). Copia questo valore. - Nella finestra di dialogo Firebase, incolla il nome del pacchetto copiato nel campo
Android package name
. - Non abbiamo bisogno della chiave SHA-1 qui, a meno che tu non abbia intenzione di utilizzare Accedi con Google o Firebase Dynamic Links (tieni presente che non fanno parte di questo codelab). Se prevedi di importare i dati di
in_app_purchase
da Google Play, dovrai impostare la chiave in un secondo momento. - Fai clic su Registra app.
- Proseguendo con Firebase, segui le istruzioni per scaricare il file di configurazione
google-services.json
.
- Vai alla directory dell'app Flutter, quindi sposta il file
google-services.json
(che hai appena scaricato) nella directoryandroid/app
. - Torna alla console Firebase, salta i passaggi rimanenti e torna alla pagina principale della console Firebase.
- Infine, devi disporre del plug-in Gradle dei servizi Google per leggere il file
google-services.json
generato da Firebase. - Nel tuo IDE o editor, apri
android/app/build.gradle
, quindi aggiungi la seguente riga come ultima riga nel file:
apply plugin: 'com.google.gms.google-services'
- Apri
android/build.gradle
, poi aggiungi una nuova dipendenza all'interno del tagbuildscript
:
buildscript {
repositories {
// ...
}
dependencies {
// ...
Classpath 'com.google.gms:google-services:4.3.3'
}
}
- Se la tua app è ancora in esecuzione, chiudila e ricreala per consentire a Gradle di installare le dipendenze.
Hai completato la configurazione dell'app Flutter per Android. Per iOS, ti consigliamo di fare riferimento a questo codelab ( Scopri Firebase per Flutter)
5. Configura Firebase Analytics in Flutter
In questo passaggio, inizierai a utilizzare il pacchetto Firebase Analytics denominato firebase_analytics
, che contiene le funzionalità di Firebase Analytics.
Il file pubspec gestisce gli asset per un'app Flutter. In pubspec.yaml
, aggiungi firebase_analytics: ^6.2.0
(firebase_analytics
6.2.0 o versioni successive) all'elenco delle dipendenze :
dependencies:
flutter:
sdk: flutter
cupertino_icons: ^0.1.2
firebase_analytics: ^6.2.0 # add this line
Mentre visualizzi il parametro Pubspec nell'area di modifica di Android Studio, fai clic su Pacchetti ricevono. Viene eseguito il pull del pacchetto nel tuo progetto. Nella console dovresti vedere quanto segue:
flutter packages get
Running "flutter packages get" in startup_namer...
Process finished with exit code 0
L'esecuzione di Pub get
genera automaticamente anche il file pubspec.lock
con un elenco di tutti i pacchetti inseriti nel progetto e i relativi numeri di versione.
In lib/main.dart
, importa il nuovo pacchetto:
import 'package:firebase_analytics/firebase_analytics.dart';
Nella classe MyApp
, avvia l'oggetto FirebaseAnalytics
chiamando il costruttore.
class MyApp extends StatelessWidget {
static FirebaseAnalytics analytics = FirebaseAnalytics();
...
}
Ora è tutto pronto per attivare alcuni log eventi personalizzati.
6. Registra eventi personalizzati con Firebase Analytics
Se generi un nuovo modello nell'app Flutter, vedresti una variabile _counter
e il metodo _incrementCounter()
all'interno della classe State
predefinita. Ora vuoi registrare gli eventi personalizzati quando il pulsante di incremento viene selezionato più di cinque volte da parte di utenti troppo entusiasti. In seguito, lanceremo una campagna per app per attirare potenziali utenti appassionati
Innanzitutto, vogliamo passare gli oggetti di analisi che abbiamo inizializzato al widget Stateful
. Per iniziare, aggiungiamo un parametro di analisi al costruttore MyHomePage
.
MyHomePage({Key key, this.title, this.analytics}) : super(key: key);
Aggiungerai anche un parametro di analisi quando chiami il costruttore.
home: MyHomePage(
title: 'Flutter Demo Home Page',
analytics: analytics,
),
Ora puoi registrare facilmente gli eventi con il metodo logEvent()
. Aggiungi il metodo e incrementa la variabile _counter
.
void _incrementCounter() {
setState(() {
_counter++;
//add this
if(_counter > 5) {
widget.analytics.logEvent(name: "clicked_counter");
}
});
}
Ora la tua app è pronta per attivare il log eventi personalizzato.
Puoi anche utilizzare metodi predefiniti per attivare gli eventi.
Ora è tutto pronto. In Android Studio, esegui "main.ARROW".
(Facoltativo) Inviare informazioni aggiuntive a Firebase Analytics utilizzando i parametri
Puoi inviare informazioni aggiuntive tramite i parametri. I parametri personalizzati possono essere registrati per i report di Analytics. Possono anche essere utilizzati come filtri nelle definizioni dei segmenti di pubblico applicabili a ciascun report. Se la tua app è collegata a un progetto BigQuery, i parametri personalizzati sono disponibili anche in BigQuery (vedi BigQuery Export per Firebase).
Qui stiamo impostando il valore _counter
come parametro.
void _incrementCounter() {
setState(() {
_counter++;
if(_counter > 5) {
widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
}
});
}
Controllare e eseguire il debug degli eventi
Potrai visualizzare gli eventi registrati nella console Firebase dopo alcune ore. Basta fare clic sulla scheda Eventi nella sezione di Analytics all'interno della console Firebase. Puoi anche controllare i valori all'interno dell'evento clicked_counter
facendo clic sull'evento.
Contrassegna clicked_counter
come conversione facendo scorrere verso destra l'opzione Contrassegna come conversione.
Se l'evento è nella scheda Conversione, significa che lo hai contrassegnato come conversione. Google Ads ora può importare questo evento da Firebase.
A scopo di debug, utilizza Firebase DebugView. Per maggiori dettagli, vedi Debug dell'evento.
7. Importare gli eventi di analisi in Google Ads
Una volta completata la configurazione di Firebase-Flutter, puoi lanciare le campagne per app con eventi di azione. Per iniziare, collega il Firebase a Google Ads. Se colleghi Firebase a Google Ads,le campagne per app possono importare eventi Firebase. Inoltre, questo processo aiuta Google Ads a migliorare le campagne per app consentendogli di acquisire maggiori informazioni sui segmenti di pubblico.
- Vai a Firebase Settings (Impostazioni di Firebase) facendo clic sul pulsante accanto a Project Overview (Panoramica del progetto).
- Nella scheda Integrazioni, vedrai Google Ads e un pulsante Collega. Fai clic su Collega e poi su Continua.
- Scegli l'account Google Ads.
Ora la parte su Firebase è terminata.
Accedi a Google Ads.
- Accedi e vai a Strumenti e Impostazioni > Misurazione > Conversioni per importare gli eventi personalizzati come conversioni.
- Fai clic sul pulsante + per aggiungere nuove azioni di conversione.
- Scegli Proprietà Google Analytics 4 (Firebase) e fai clic su Continua.
- Puoi visualizzare tutti gli eventi di analisi che sono contrassegnati come conversioni. Trova l'evento
clicked_counter
che abbiamo implementato in precedenza.
- Seleziona l'azione, fai clic su Importa e poi su Continua.
Dopo aver impostato clicked_counter
come azione di conversione, puoi lanciare campagne per azione indirizzate agli utenti che probabilmente attiveranno clicked_counter
eventi più di cinque volte.
8. Lancio di campagne per app per azione con eventi importati
- Vai alla scheda campagna dell'account corrente e avvia una nuova campagna facendo clic sul pulsante +. Fai clic su [Nuova campagna] e poi su Continua.
- Lancia una campagna per la promozione di app con l'opzione Installazioni di app.
- Trova la tua app digitando il nome dell'app, del pacchetto o del publisher.
- Nella sezione Offerte, seleziona Azioni in-app nel menu a discesa.
- Individua l'evento personalizzato nell'elenco fornito. Imposta il Costo per azione target e completa le eventuali opzioni aggiuntive.
- Completa le impostazioni della campagna.
9. Complimenti
Congratulazioni, hai completato l'integrazione tra Firebase e Google Ads. In questo modo, potrai migliorare il rendimento della tua campagna con gli eventi Firebase importati.
Hai appreso
- Come configurare Firebase Analytics per Flutter
- Come registrare eventi personalizzati con Firebase Analytics nell'app Flutter.
- Come importare gli eventi e utilizzarli per le campagne per azione.