Aggiungi Analytics alla tua app iOS

Questa guida illustra come aggiungere Analytics alla tua app per iOS per misurare l'attività utente nelle schermate denominate. Se non hai ancora un'applicazione e vuoi vedere come funziona Analytics, consulta la nostra applicazione 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 già 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. Usa 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. Per prima cosa, configura l'oggetto Analytics condiviso all'interno di AppDelegate. In questo modo la tua app potrà inviare dati ad Analytics. Esegui le seguenti operazioni:

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>

Poi, 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 dello schermo

Qui invierai una visualizzazione di 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 richieste:

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>
#import <GoogleAnalytics/GAIFields.h>ViewController.m

Utilizza un metodo viewWillAppear o una sostituzione di funzione per inserire il monitoraggio dello schermo.
Dai un nome allo schermo ed esegui il monitoraggio.

id<GAITracker> tracker = [GAI sharedInstance].defaultTracker;
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];ViewController.m

Nota: puoi aggiungere un codice di monitoraggio a ogni UIViewController che rappresenta una schermata, sia che venga mostrato all'utente in modo imperativo (tramite codice) o tramite uno storyboard. Imposta un nome all'interno di ogni UIViewController se vuoi distinguere le visualizzazioni di schermata della tua app in Analytics. Per tutta l'attività registrata sul tracker condiviso viene inviato il nome schermata più recente fino a quando non viene sostituita o eliminata (impostata su null).

Passaggi successivi

Leggi la Guida all'implementazione delle app mobile per scoprire come utilizzare Google Analytics per misurare le interazioni degli utenti e rispondere a domande sull'utilizzo delle app.
Esamina altre opzioni di configurazione, come campionamento, test e debug, impostazioni di disattivazione e così via.
Se richiesto dalla tua app, attiva funzionalità facoltative come E-commerce avanzato, IDFA (identificatore per gli inserzionisti) e la misurazione delle campagne per l'installazione di iAd.