Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Inizia con Google Analytics

Questa guida rapida mostra come aggiungere Google Analytics alla tua app e iniziare a registrare gli eventi.

Google Analytics raccoglie dati di utilizzo e comportamento per la tua app. L'SDK registra due tipi principali di informazioni:

  • Eventi: cosa sta succedendo nella tua app, come azioni dell'utente, eventi di sistema o errori.
  • Proprietà utente: attributi che definisci per descrivere i segmenti della tua base di utenti, come la preferenza della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà dell'utente ; non è necessario aggiungere alcun codice per abilitarli.

Prima di iniziare

  1. Se non l'hai già fatto, aggiungi Firebase al tuo progetto iOS e assicurati che Google Analytics sia abilitato nel tuo progetto Firebase:

    • Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

    • Se hai un progetto Firebase esistente che non ha Google Analytics abilitato, puoi abilitare Google Analytics dalla scheda Integrazioni delle tue > Impostazioni progetto .

    Quando abiliti Google Analytics nel tuo progetto, le tue app Firebase sono collegate ai flussi di dati di Google Analytics.

  2. (Consigliato) . Aggiungi il framework AdSupport al tuo progetto per abilitare funzionalità aggiuntive come il pubblico e l'attribuzione della campagna.

Aggiungi l'SDK di Analytics alla tua app

  1. Aggiungi la dipendenza per Firebase al tuo Podfile: 
    pod 'Firebase/Analytics'
  2. Esegui pod install e apri il file .xcworkspace creato.
  3. Importa il modulo Firebase nella tua UIApplicationDelegate :

    Swift

    import Firebase

    Obiettivo-C

    @import Firebase;
  4. Configura un'istanza condivisa di FirebaseApp , in genere nell'applicazione della tua app application:didFinishLaunchingWithOptions: metodo:

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Obiettivo-C

    // Use Firebase library to configure APIs
[FIRApp configure];


(Facoltativo) Disattiva la registrazione dell'attribuzione della rete pubblicitaria Apple

Per tua comodità, l'SDK registra automaticamente la tua app con Apple per l'attribuzione della rete pubblicitaria con SKAdNetwork . Se desideri disabilitare questa funzione, imposta il valore di GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED su NO (booleano) nel file info.plist della tua app.

Inizia a registrare gli eventi

Dopo aver configurato l'istanza FirebaseApp , puoi iniziare a registrare gli eventi con il metodo logEvent() .

Alcuni eventi sono consigliati per tutte le app ; altri sono consigliati per specifici tipi di attività o verticali. È necessario inviare eventi suggeriti insieme ai parametri prescritti, per garantire il massimo dettaglio disponibile nei rapporti e per beneficiare delle funzionalità e integrazioni future non appena diventano disponibili. Questa sezione mostra la registrazione di un evento predefinito, per ulteriori informazioni sulla registrazione degli eventi, vedere Eventi di registro .

L'esempio seguente mostra come registrare un evento consigliato per indicare che un utente ha fatto clic su un elemento specifico nella tua app:

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont"
  ])

Obiettivo-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Per visualizzare questo evento nella console di debug di Xcode, abilita il debug di Analytics:

  1. In Xcode, seleziona Prodotto> Schema> Modifica schema ...
  2. Seleziona Esegui dal menu a sinistra.
  3. Seleziona la scheda Argomenti .
  4. Nella sezione Arguments Passed On Launch , aggiungi -FIRAnalyticsDebugEnabled .

Prossimi passi