Riferimento classe GAI

Panoramica

corso di primo livello su Google Analytics per iOS.

Offre servizi per creare tracker e impostare segnalazioni comportamentali.

Eredita NSObject.

Metodi di istanza

(ID< GAITracker >)- trackerWithName:trackingId:
 Crea o recupera un'implementazione GAITracker con il nome e l'ID monitoraggio specificati. Altro...
 
(ID< GAITracker >)- trackerWithTrackingId:
 Crea o recupera un'implementazione GAITracker con il nome uguale all'ID monitoraggio specificato. Altro...
 
(void) - removeTrackerByName:
 Rimuovi un tracker dal dizionario dei tracker. Altro...
 
(void) - spedizione
 Invia eventuali informazioni di monitoraggio in attesa. Altro...
 
(void) - dispatchWithCompleteHandler:
 Invia il successivo beacon di monitoraggio in coda, chiamando completateHandler quando il beacon di monitoraggio è stato inviato (restituendo kGAIDispatchGood) o si è verificato un errore (restituendo kGAIDispatchError). Altro...
 

Metodi della classe

(GAI *)+ sharedInstance
 Ottieni l'istanza condivisa del corso Google Analytics per iOS. Altro...
 

Proprietà

id< GAITracker >defaultTracker
 Per praticità, questa classe espone un'istanza di tracker predefinita. Altro...
 
id< GAILogger >logger
 L'elemento GAILogger da utilizzare. Altro...
 
BOOLoptOut
 In tal caso, non verranno raccolte informazioni di tracciamento e le chiamate di tracciamento diventeranno di fatto autonome. Altro...
 
NSTimeIntervaldispatchInterval
 Se questo valore è positivo, le informazioni di monitoraggio verranno inviate automaticamente ogni dispatchInterval secondi. Altro...
 
BOOLtrackUncaughtExceptions
 Se impostato su true, l'SDK registra il gestore delle eccezioni non rilevato attualmente registrato, quindi registra un gestore delle eccezioni non rilevato che tiene traccia delle eccezioni che si sono verificate utilizzando defaultTracker. Altro...
 
BOOLdryRun
 Se scegli "SÌ", non verranno inviate informazioni di tracciamento. Altro...
 

Documentazione del metodo

+ (GAI *) sharedInstance

Ottieni l'istanza condivisa del corso Google Analytics per iOS.

- (id<GAITracker>) trackerWithName: (NSString *) name
ID monitoraggio: (NSString *) trackingId

Crea o recupera un'implementazione GAITracker con il nome e l'ID monitoraggio specificati.

Se il tracker per il nome specificato non esiste già, verrà creato e restituito; in caso contrario, verrà restituito il tracker esistente. Se il tracker esistente per il rispettivo nome ha un ID monitoraggio diverso, l'ID monitoraggio non viene modificato con questo metodo. Se defaultTracker non è impostato, verrà impostato sull'istanza del tracker restituita qui.

Parametri
nomeIl nome del tracker. Non deve essere nil o vuoto.
trackingIDL'ID monitoraggio da utilizzare per questo tracker. Il formato deve essere UA-xxxxx-y.
Ritorni
Un GAITracker associato al nome specificato. Il tracker può essere utilizzato per inviare i dati di monitoraggio a Google Analytics. La prima volta che questo metodo viene chiamato con un determinato nome, viene restituito il tracker con quel nome e le successive chiamate con lo stesso nome restituiranno la stessa istanza. Non è necessario conservare il tracker perché verrà conservato internamente dalla libreria.

Se si verifica un errore o il nome non è valido, questo metodo restituirà nil.

- (id<GAITracker>) trackerWithTrackingId: (NSString *) trackingId

Crea o recupera un'implementazione GAITracker con il nome uguale all'ID monitoraggio specificato.

Se il tracker con il rispettivo nome non esiste già, viene creato, l'ID monitoraggio è impostato su |trackingId| e viene restituito; in caso contrario, viene restituito il tracker esistente. Se il tracker esistente per il rispettivo nome ha un ID monitoraggio diverso, l'ID monitoraggio non viene modificato con questo metodo. Se defaultTracker non è impostato, viene impostato sull'istanza del tracker restituita qui.

Parametri
trackingIDL'ID monitoraggio da utilizzare per questo tracker. Il formato deve essere UA-xxxxx-y. Il nome del tracker sarà uguale a trackingID.
Ritorni
Un GAITracker associato all'ID monitoraggio specificato. Il tracker può essere utilizzato per inviare i dati di monitoraggio a Google Analytics. La prima volta che questo metodo viene chiamato con un particolare ID monitoraggio, viene restituito il tracker con il rispettivo nome e le chiamate successive con lo stesso trackingID restituiscono la stessa istanza. Non è necessario conservare il tracker perché verrà conservato internamente dalla libreria.

Se si verifica un errore o il trackingId non è valido, questo metodo restituirà nil.

- (void) removeTrackerByName: (NSString *) name

Rimuovi un tracker dal dizionario dei tracker.

Se è il tracker predefinito, cancella anche quello predefinito.

Parametri
nomeIl nome del tracker.
- (void) spedizione

Invia eventuali informazioni di monitoraggio in attesa.

Tieni presente che questa operazione non ha alcun effetto su dispatchInterval e può essere utilizzata in combinazione con l'invio periodico.

- (void) dispatchWithCompleteHandler: (void(^)(GAIDispatchResult result)) completionHandler

Invia il successivo beacon di monitoraggio in coda, chiamando completateHandler quando il beacon di monitoraggio è stato inviato (restituendo kGAIDispatchGood) o si è verificato un errore (restituendo kGAIDispatchError).

Se non è disponibile una connessione di rete o se non ci sono dati da inviare, viene restituito kGAIDispatchNoData.

Tieni presente che la chiamata di questo metodo con uncompleteHandler diverso da zero disattiva l'invio periodico. La spedizione periodica può essere riattivata impostando un intervallo di invio su un numero positivo quando l'app viene ripristinata in background.

Chiamare questo metodo con nilcompleteHandler equivale a chiamare l'invio di cui sopra.

Questo metodo può essere utilizzato per il recupero dei dati in background in iOS 7.0 o versioni successive. Ti consigliamo di richiamare questo numero quando l'applicazione viene chiusa per avviare l'invio delle informazioni di monitoraggio non inviate.

Parametri
completionHandlerIl blocco da eseguire dopo una singola richiesta di invio. Il parametro GAIDispatchResult indica se l'invio è riuscito, presenta un errore o non ha hit da inviare.

Documentazione della proprietà

- (id<GAITracker>) defaultTracker
(lettura/scrittura, non atomica, assegnazione)

Per praticità, questa classe espone un'istanza di tracker predefinita.

Questo valore è inizializzato su nil e verrà impostato sul primo tracker creato in un'istanza in trackerWithTrackingId:. L'impostazione può essere ignorata come preferisci.

Per impostazione predefinita, la classe GAITrackedViewController utilizza questa istanza del tracker.

- (id<GAILogger>) logger
(lettura/scrittura, nonatomica, conservazione)

L'elemento GAILogger da utilizzare.

- Disattivazione (BOOL)
(lettura/scrittura, non atomica, assegnazione)

In tal caso, non verranno raccolte informazioni di tracciamento e le chiamate di tracciamento diventeranno di fatto autonome.

Se il criterio viene impostato su true, tutte le informazioni in attesa di caricamento vengono eliminate. Il valore di questo flag verrà mantenuto automaticamente dall'SDK. Facoltativamente, gli sviluppatori possono utilizzare questo flag per implementare un'impostazione di disattivazione nell'app che consenta agli utenti di disattivare il monitoraggio di Google Analytics.

Il valore è impostato su NO la prima volta che l'SDK di Google Analytics viene utilizzato su un dispositivo e successivamente viene mantenuto.

- (NSTimeInterval) dispatchInterval
(lettura/scrittura, non atomica, assegnazione)

Se questo valore è positivo, le informazioni di monitoraggio verranno inviate automaticamente ogni dispatchInterval secondi.

In caso contrario, le informazioni di tracciamento devono essere inviate manualmente chiamando il servizio di spedizione.

Per impostazione predefinita, il valore è 120, che indica che le informazioni sul tracciamento devono essere inviate automaticamente ogni 120 secondi.

- (BOOL) trackUncaughtExceptions
(lettura/scrittura, non atomica, assegnazione)

Se impostato su true, l'SDK registra il gestore delle eccezioni non rilevato attualmente registrato, quindi registra un gestore delle eccezioni non rilevato che tiene traccia delle eccezioni che si sono verificate utilizzando defaultTracker.

Se defaultTracker non è nil, questa funzione tiene traccia dell'eccezione sul tracker e tenta di inviare eventuali informazioni di tracciamento in sospeso per 5 secondi. Quindi, chiamerà l'eventuale gestore delle eccezioni registrato in precedenza. Se viene impostato su false, il gestore delle eccezioni non rilevato in precedenza viene ripristinato.

- (BOOL) funzionamento a secco
(lettura/scrittura, non atomica, assegnazione)

Se scegli "SÌ", non verranno inviate informazioni di tracciamento.

Il valore predefinito è "NO".