Eventi personalizzati di Google Ads con Google Analytics per Firebase - iOS

1. Introduzione

Ultimo aggiornamento: 14/12/2020

Cosa creerai

In questo codelab imparerai a implementare eventi personalizzati con l'SDK GA4F per iOS e a lanciare campagne basate sull'azione tramite Google Ads.

In questo codelab puoi sperimentare l'intero processo di business delle app che i nostri clienti devono affrontare. Se vuoi un'introduzione più semplice a Firebase iOS, inizia con il Codelab di Firebase per iOS 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 a Google Ads
• Lanciare campagne per azione con eventi personalizzati.

Che cosa ti serve

• Xcode
• Account Firebase
• Account Google Ads

2. Avviare un nuovo progetto iOS Swift

Crea una semplice app iOS Swift basata su un modello. Modifica questa app di base per creare l'app finale.

Per prima cosa, avvia Xcode.

1. Se non hai progetti aperti, seleziona Crea un nuovo progetto Xcode dalla pagina di benvenuto.
2. Seleziona iOS nella parte superiore della finestra di dialogo.
3. Nella sezione Applicazione, seleziona App e poi fai clic su Avanti.
4. Nella finestra di dialogo visualizzata, utilizza i seguenti valori per assegnare un nome all'app e scegliere opzioni aggiuntive per il progetto, quindi fai clic su Avanti :
5. Nome prodotto: ad es. ios-app

Xcode utilizza il nome del prodotto che hai inserito per denominare il progetto e l'app.

2. Team: se questo campo non viene compilato automaticamente, imposta il team su Nessuno.
3. Nome dell'organizzazione: il nome della tua organizzazione o il tuo nome.
4. Identificatore bundle: questo valore viene generato automaticamente in base al nome del prodotto e all'identificatore dell'organizzazione.
5. Lingua: Swift
6. Seleziona una posizione in cui salvare il progetto e fai clic su Crea.
7. Xcode apre il nuovo progetto nella finestra dello spazio di lavoro.

3. Crea e configura un progetto Firebase

Per iniziare a utilizzare Firebase, devi creare e configurare un progetto Firebase.

Crea un progetto Firebase

Se hai un progetto Firebase esistente in cui non è abilitato Google Analytics, puoi attivarlo dalla scheda Integrazioni di Impostazioni > Impostazioni progetto. Passa al passaggio di configurazione di Firebase.

1. Accedi a Firebase.

Nella console Firebase, fai clic su Aggiungi progetto(o Crea un progetto) e assegna al progetto Firebase il nome Firebase-iOS-Ads

2. Fai clic sulle opzioni di creazione del progetto. Accetta i Termini di Firebase se richiesto. Devi attivare Google Analytics per questo progetto, poiché hai bisogno degli eventi 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 di Firebase

1. Nella console Firebase, seleziona Panoramica del progetto > Impostazioni progetto nel riquadro di navigazione a sinistra, quindi fai clic sul pulsante iOS in Generale > Le tue app.

Verrà visualizzata la finestra di dialogo mostrata nella schermata seguente.

2. Il valore importante da fornire è l'ID pacchetto iOS, che otterrai utilizzando il passaggio successivo.
3. Nel progetto Xcode per l'app per iOS, seleziona l'app di primo livello nel navigatore del progetto, quindi seleziona la scheda Generale.
4. Il valore del campo Identificatore bundle è l'ID pacchetto iOS (ad esempio com.yourcompany.yourproject). Copia questo valore.
5. Nella finestra di dialogo Firebase, incolla l'ID pacchetto copiato nel campo iOS bundle ID.
6. Fai clic su Registra app.
7. Continuando in Firebase, segui le istruzioni per scaricare il file di configurazione GoogleService-Info.plist

8. Vai al progetto Xcode, quindi sposta il file GoogleService-Info.plist (che hai appena scaricato) nella root del progetto Xcode.
9. Salta i passaggi rimanenti e torna alla pagina principale della console Firebase.

5. Configurare Firebase Analytics in Xcode

In questo passaggio, inizierai ad aggiungere l'SDK Firebase al tuo progetto Xcode.

Nota:i servizi Google utilizzano CocoaPods per installare e gestire le dipendenze. Se non hai mai utilizzato CocoaPods, devi prima installarlo eseguendo questo comando nel terminale:

$ sudo gem install cocoapods

1. Apri una finestra del terminale e accedi alla posizione del progetto Xcode per la tua app.
2. Crea un Podfile se non ne hai uno:

$ pod init

3. Apri il Podfile e aggiungi :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Salva il file ed esegui :

$ pod install

5. Aggiungi codice di inizializzazione :

Per collegare Firebase all'avvio della tua app, aggiungi il codice di inizializzazione riportato di seguito alla tua classe AppDelegate 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
  }
}

6. Ecco fatto! Vai alla console.

Ora puoi attivare alcuni log degli eventi personalizzati.

6. Registrare eventi personalizzati con Firebase Analytics

In questo passaggio, imparerai a registrare eventi personalizzati con Firebase Analytics nell'app per iOS.

Firebase Analytics registra automaticamente alcuni eventi per te, quindi 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 nella tua app.

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 i parametri evento predefiniti

Puoi registrare i parametri tra gli 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 la registrazione 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:

1. In Xcode, seleziona Product > Scheme > Edit scheme… (Prodotto > Schema > Modifica schema…).
2. Seleziona Run (Esegui) dal menu a sinistra.
3. Seleziona la scheda Arguments (Argomenti).
4. Nella sezione Arguments Passed On Launch (Argomenti passati al momento dell'avvio), aggiungi -FIRAnalyticsDebugEnabled.

La prossima volta che esegui l'app, gli eventi verranno visualizzati nella console di debug di Xcode, consentendoti di verificare immediatamente che vengano inviati.

Visualizzare gli eventi nella dashboard

Vedrai l'evento registrato nella console Firebase dopo diverse ore. Si trova in Analytics → Eventi. Puoi anche trovare i valori dei parametri facendo clic sull'evento.

Contrassegna "text_search" come conversione spostando il selettore "Contrassegna come conversione" verso destra.

Puoi verificare se l'evento è stato contrassegnato correttamente come conversione tramite la scheda Conversioni di Firebase Analytics. Se contrassegni l'evento come conversione, Google Ads potrà importarlo come conversione.

7. Importazione degli eventi di Analytics in Google Ads

La configurazione di Firebase-iOS è terminata e puoi lanciare la campagna per app con gli eventi di azione registrati. Inizierai collegando Firebase a Google Ads. Se colleghi Firebase a Google Ads, le campagne per app potranno ottenere maggiori informazioni sui segmenti di pubblico e migliorare l'apprendimento delle campagne per app, il che di solito porta a un rendimento e a conversioni migliori.

1. Vai alle impostazioni di Firebase facendo clic sul pulsante accanto a Panoramica del progetto.
2. Nella scheda Integrazioni, vedrai Google Ads e un pulsante Collega. Fai clic su Collega e continua.

3. Scegli l'account Google Ads.

Attenzione:se l'evento target non è contrassegnato come conversione, Google Ads non potrà importarlo. Assicurati che l'evento sia contrassegnato correttamente come conversione.

Ora la parte di Firebase è terminata.

Ora vai su Google Ads e accedi.

1. Vai a Google Ads e accedi, poi vai a Strumenti e impostazioni → Misurazione → Conversioni per importare gli eventi personalizzati come conversioni.
2. Fai clic sul pulsante + per aggiungere una nuova azione di conversione.

3. Scegli le proprietà Google Analytics 4 (Firebase) e fai clic su Continua.

4. Puoi visualizzare tutti gli eventi di analisi contrassegnati come conversioni. Trova l'evento clicked_counter che abbiamo implementato in precedenza.

5. Seleziona e fai clic sul pulsante Importa e continua.

Dopo aver impostato text_search come azione di conversione, è il momento di lanciare una campagna che ha come target gli utenti che probabilmente attiveranno eventi text_search.

8. Lancio di campagne per azioni nell'app con eventi importati

Importante:per lanciare una campagna per app, devi avere un'app a livello di produzione su Google Play. Se non vuoi ancora pubblicare l'app, lascia questo passaggio per ora.

6. Vai alla scheda della campagna del tuo account attuale e avvia una nuova campagna facendo clic sul pulsante +. Fai clic sulla nuova campagna e continua.
7. Per questo periodo, lanceremo una campagna per la promozione di app con l'opzione Installazioni di app.

8. Trova la tua app fornendo il nome, il nome del pacchetto o il publisher.
9. Nella sezione Offerte, seleziona Azioni in-app nel menu a discesa per consentire ad Ads di concentrarsi sulle azioni.
10. puoi trovare i tuoi eventi personalizzati nell'elenco fornito. Imposta il costo per azione target e compila anche le altre opzioni.

11. Configura le impostazioni della campagna. Questo argomento non rientra nell'ambito del codelab, quindi consulta questi documenti o contattaci tramite altri canali per ottimizzare le impostazioni.

9. Complimenti

Congratulazioni, hai integrato correttamente Firebase e Google Ads. In questo modo, potrai migliorare il rendimento della campagna.

Hai installato lo script, creato e preparato un nuovo elenco di modifiche del codelab, aggiornato e preparato l'elenco di modifiche del codelab in attesa, esaminato e approvato l'elenco di modifiche del codelab e inviato e pubblicato l'elenco di modifiche del codelab.

Cosa hai imparato

• 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.