Aggiungi Analytics alla tua app per iOS

Questa guida mostra come aggiungere Analytics alla tua app per iOS per misurare l'attività utente su schermi denominati. Se non hai ancora un'applicazione e vuoi solo vedere come funziona Analytics, dai un'occhiata alla nostra richiesta di esempio.

Analytics utilizza CocoaPods per installare e gestire le dipendenze. Apri una finestra del terminale e vai alla posizione del progetto Xcode per la tua applicazione. Se non hai ancora creato un Podfile per l'applicazione, creane uno ora:

pod init

Apri il Podfile creato per l'applicazione e aggiungi quanto segue:

pod 'GoogleAnalytics'

Salva il file ed esegui:

pod install

Viene creato un file .xcworkspace per l'applicazione. Utilizza questo file per lo sviluppo futuro della tua applicazione.

Inizializzare Analytics per la tua app

Ora che disponi del file di configurazione del progetto, puoi iniziare l'implementazione. Innanzitutto, configura l'oggetto Analytics condiviso all'interno di AppDelegate. In questo modo l'app può inviare dati ad Analytics. Procedi nel seguente modo:

  • Includi le intestazioni necessarie.
  • Imposta il tracker di Analytics all'interno di didFinishLaunchingWithOptions.
  • Sostituisci YOUR_TRACKING_ID con il tuo ID monitoraggio di Analytics, ad esempio UA-47605289-8.
  • (Facoltativo) Invia eccezioni e informazioni di logging.

Per apportare queste modifiche, devi prima aggiungere Analytics all'interno di AppDelegate:

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>

Quindi, esegui l'override del metodo didFinishLaunchingWithOptions per configurare Analytics:

GAI *gai = [GAI sharedInstance];
[gai trackerWithTrackingId:@"YOUR_TRACKING_ID"];

// Optional: automatically report uncaught exceptions.
gai.trackUncaughtExceptions = YES;

// Optional: set Logger to VERBOSE for debug information.
// Remove before app release.
gai.logger.logLevel = kGAILogLevelVerbose;

Aggiungere il monitoraggio delle schermate

Qui invierai una visualizzazione della schermata con nome ad Analytics ogni volta che l'utente apre o modifica le schermate della tua app. Apri un controller di visualizzazione che vuoi monitorare oppure, se si tratta di una nuova applicazione, apri quello predefinito. Il tuo codice deve:

  • Aggiungi le intestazioni obbligatorie:
    #import <GoogleAnalytics/GAI.h>
    #import <GoogleAnalytics/GAIDictionaryBuilder.h>
    #import <GoogleAnalytics/GAIFields.h>
  • Utilizza un metodo viewWillAppear o un override della funzione per inserire il monitoraggio delle schermate.
  • Assegna un nome allo schermo ed esegui il monitoraggio.
id<GAITracker> tracker = [GAI sharedInstance].defaultTracker;
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];

Passaggi successivi