Eventi personalizzati di Google Ads con Google Analytics per Firebase - iOS
Informazioni su questo codelab
1. Introduzione
Ultimo aggiornamento: 2020-12-14
Cosa creerai
In questo codelab, imparerai a implementare eventi personalizzati con l'SDK GA4F per iOS e lanciare campagne per azione tramite Google Ads.
Attraverso questo codelab, puoi sperimentare l'intero processo di business delle app che i nostri clienti devono affrontare. Se vuoi imparare un'introduzione più tempestiva a Firebase per iOS, inizia con Firebase iOS Codelab Swift
Cosa imparerai a fare
- Come inizializzare GA4F (Google Analytics for Firebase) in iOS Swift
- Come creare eventi e parametri personalizzati.
- Come importare eventi da Firebase in Google Ads
- Lanciare campagne per azione con eventi personalizzati.
Che cosa ti serve
- Xcode
- Account Firebase
- Account Google Ads
2. Avvia un nuovo progetto iOS Swift
Crea una semplice app Swift per iOS basata su modelli. Modifica questa app iniziale per creare l'app completa.
Per prima cosa, avvia Xcode.
- Se non hai progetti aperti, seleziona Create a new Xcode project (Crea un nuovo progetto Xcode) dalla pagina di benvenuto.
- Seleziona iOS nella parte superiore della finestra di dialogo.
- Nella sezione Applicazione, seleziona App e fai clic su Avanti.
- Nella finestra di dialogo visualizzata, utilizza i seguenti valori per assegnare un nome alla tua app e scegli opzioni aggiuntive per il tuo progetto, quindi fai clic su Avanti :
- Nome del prodotto: ad es. app-iOS
Xcode utilizza il nome del prodotto che hai inserito per assegnare un nome al progetto e all'app.
- Team: se il campo non viene compilato automaticamente, imposta il team su None.
- Nome dell'organizzazione: il nome della tua organizzazione o il tuo nome.
- Identificatore bundle: questo valore viene generato automaticamente in base al nome del prodotto e all'identificatore dell'organizzazione.
- Lingua: Swift
- Seleziona una posizione in cui salvare il progetto e fai clic su Crea.
- Xcode apre il nuovo progetto nella finestra dell'area di lavoro.
3. Crea e configura un progetto Firebase
Per iniziare a utilizzare Firebase, devi creare e impostare un progetto Firebase.
Creare un progetto Firebase
Se hai già un progetto Firebase in cui Google Analytics non è abilitato, puoi attivarlo dalla scheda Integrazioni delle impostazioni > Impostazioni progetto. Vai al passaggio di configurazione di Firebase.
- Accedi a Firebase.
Nella Console Firebase, fai clic su Aggiungi progetto(o Crea un progetto) e assegna un nome al tuo progetto Firebase Firebase-iOS-Ads.
- Fai clic sulle varie opzioni di creazione del progetto. Accetta i termini di Firebase, se richiesto. Dovresti abilitare Google Analytics per questo progetto perché hai bisogno degli eventi di Google Analytics per monitorare gli eventi di azione e le conversioni.
Per saperne di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.
4. Configurazione Firebase
- Nella console Firebase, seleziona Panoramica del progetto > Project Settings (Impostazioni progetto) nel menu di navigazione a sinistra, quindi fai clic sul pulsante iOS in General (Generali) > Le tue app
Verrà visualizzata la finestra di dialogo mostrata nella schermata seguente.
- Il valore importante da fornire è l'ID pacchetto iOS, che otterrai seguendo il passaggio seguente.
- Nel progetto Xcode per l'app per iOS, seleziona l'app di primo livello nel navigatore dei progetti, quindi seleziona la scheda Generale.
- Il valore del campo Identificatore bundle è l'ID pacchetto iOS (ad esempio
com.yourcompany.yourproject
). Copia questo valore. - Nella finestra di dialogo Firebase, incolla l'ID pacchetto copiato nel campo
iOS bundle ID
. - Fai clic su Registra app.
- Proseguendo con Firebase, segui le istruzioni per scaricare il file di configurazione
GoogleService-Info.plist
- Vai al tuo progetto Xcode, quindi sposta il file
GoogleService-Info.plist
(che hai appena scaricato) nella radice del progetto Xcode. - Ignora i passaggi rimanenti e torna alla pagina principale della console Firebase.
5. Configura Firebase Analytics in Xcode
In questo passaggio, inizierai ad aggiungere l'SDK Firebase al tuo progetto Xcode.
- Apri una finestra del terminale e vai alla posizione del progetto Xcode per la tua app.
- Crea un Podfile se non ne hai uno:
$ pod init
- Apri il podfile e aggiungi :
$ vi Podfile
$ pod 'Firebase/Analytics'
- Salva il file ed esegui :
$ pod install
- Aggiungi codice di inizializzazione :
Per connettere Firebase all'avvio della tua app, aggiungi il codice di inizializzazione riportato di seguito alla classe AppDelega principale.
import UIKit
import Firebase
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
FirebaseApp.configure()
return true
}
}
- Ecco fatto! Vai alla console.
Ora è tutto pronto per attivare alcuni log eventi personalizzati.
6. Registra eventi personalizzati con Firebase Analytics
In questo passaggio, imparerai come registrare eventi personalizzati con Firebase Analytics nell'app per iOS.
Firebase Analytics registra automaticamente alcuni eventi per te; non devi aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventi personalizzati di Analytics al suo interno.
Registra eventi
Dopo aver configurato l'istanza FirebaseApp, puoi iniziare a registrare gli eventi con il metodo logEvent().
Analytics.logEvent("text_search", parameters: [
"name": name as NSObject,
"full_text": text as NSObject
])
Impostare parametri evento predefiniti
Puoi registrare i parametri negli eventi utilizzando setDefaultEventParameters. I parametri predefiniti sono associati a tutti gli eventi futuri registrati.
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Visualizzare gli eventi nella console di debug Xcode
Puoi attivare il logging dettagliato per monitorare il logging degli eventi da parte dell'SDK e verificare che gli eventi vengano registrati correttamente. Sono inclusi gli eventi registrati automaticamente e manualmente.
Puoi attivare il logging dettagliato nel seguente modo:
- In Xcode, seleziona Product > (Prodotto > Schema > Modifica schema...
- Seleziona Esegui nel menu a sinistra.
- Seleziona la scheda Argomenti.
- Nella sezione Arguments Passed On Launch (Argomenti passati al lancio), aggiungi -FIRAnalyticsDebugEnabled.
La volta successiva che eseguirai l'app, i tuoi eventi verranno visualizzati nella console di debug Xcode, aiutandoti a verificare immediatamente che gli eventi vengano inviati.
Visualizza gli eventi nella dashboard
Tra qualche ora vedrai l'evento registrato nella console Firebase. Si trova in Analytics → Eventi. Puoi trovare i valori parametro anche facendo clic sull'evento.
Segnerai "text_search" come conversione facendo scorrere "Contrassegna come conversione" passa a destra.
Puoi verificare se l'evento è stato contrassegnato correttamente come conversione nella scheda Conversioni di Firebase Analytics. Contrassegnando l'evento come conversione, Google Ads potrà anche importarlo come conversione.
7. Importare gli eventi di analisi in Google Ads
La configurazione di Firebase-iOS è terminata ed è tutto pronto per lanciare la campagna per app con gli eventi di azione registrati. Inizia collegando Firebase a Google Ads. Se colleghi Firebase a Google Ads, le campagne per app potranno acquisire una conoscenza di più sui segmenti di pubblico e migliorare le conoscenze acquisite sulle campagne per app, il che, in genere, migliora il rendimento e le conversioni.
- Vai alle Impostazioni di Firebase facendo clic sul pulsante accanto a Panoramica del progetto.
- Nella scheda Integrazioni, vedrai Google Ads e un pulsante Link. Fai clic su Collega e continua.
- Scegli l'account Google Ads.
Ora la parte su Firebase è terminata.
Ora, vai a Google Ads e accedi.
- Vai su Google Ads, accedi e vai a Strumenti e Impostazioni → Misurazione → Conversioni per l'importazione di eventi personalizzati come conversioni.
- Fai clic sul pulsante + per aggiungere una nuova azione di conversione.
- Scegli le 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.
- Controlla e fai clic sul pulsante Importa e continua.
Dopo aver impostato text_search
come azione di conversione, è il momento di lanciare una campagna che abbia come target gli utenti che probabilmente attiveranno eventi text_search
.
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 sulla nuova campagna e continua.
- Per il momento, lanceremo una campagna per la promozione di app con l'opzione Installazioni di app.
- Trova la tua app indicando il nome dell'app, il nome del pacchetto o del publisher.
- Nella sezione Offerte, seleziona Azioni in-app nella casella personale per fare in modo che Annunci si concentrino sulle azioni.
- puoi trovare i tuoi eventi personalizzati nell'elenco fornito. Imposta il costo per azione target e compila anche altre opzioni.
- Configura le impostazioni della campagna. Queste informazioni non rientrano nell'ambito del codelab, quindi consulta questi documenti o contattalo tramite altri canali per ottimizzare le impostazioni.
9. Complimenti
Congratulazioni, hai completato l'integrazione tra Firebase e Google Ads. In questo modo, potrai migliorare il rendimento della tua campagna.
Hai installato lo script, creato e preparato un nuovo elenco modifiche del codelab, hai aggiornato e inserito in modo temporaneo l'elenco delle modifiche del codelab in attesa, esaminato e approvato l'elenco delle modifiche del codelab e inviato e pubblicato l'elenco delle modifiche del codelab.
Hai appreso
- Come configurare Firebase per iOS
- Come registrare eventi personalizzati con iOS e Firebase Analytics
- Come importare gli eventi e utilizzarli per le campagne per azione.