GAI Class-Referenz

Rufen Sie die freigegebene Instanz der Google Analytics for iOS-Klasse ab.

Erstellt oder ruft eine GAITracker-Implementierung mit dem angegebenen Namen und der Tracking-ID ab.

Wenn der Tracker für den angegebenen Namen noch nicht vorhanden ist, wird er erstellt und zurückgegeben. Andernfalls wird der vorhandene Tracker zurückgegeben. Wenn der vorhandene Tracker für den entsprechenden Namen eine andere Tracking-ID hat, wird diese Tracking-ID durch diese Methode nicht geändert. Wenn "defaultTracker" nicht festgelegt ist, wird dies auf die hier zurückgegebene Tracker-Instanz festgelegt.

Parameter

name	Der Name dieses Trackers. Darf nicht nil oder leer sein.
Tracking-ID	Die Tracking-ID, die für diesen Tracker verwendet werden soll. Er sollte das Format UA-xxxxx-y haben.

Gibt Folgendes zurück:

Ein GAITracker, der dem angegebenen Namen zugeordnet ist. Der Tracker kann verwendet werden, um Tracking-Daten an Google Analytics zu senden. Wenn diese Methode zum ersten Mal mit einem bestimmten Namen aufgerufen wird, wird der Tracker für diesen Namen und nachfolgende Aufrufe mit demselben Namen dieselbe Instanz zurückgeben. Es ist nicht notwendig, den Tracker zu behalten, da er intern von der Bibliothek gespeichert wird.

Wenn ein Fehler auftritt oder der Name ungültig ist, wird bei dieser Methode nil zurückgegeben.

Erstellt oder ruft eine GAITracker-Implementierung ab, deren Name der angegebenen Tracking-ID entspricht.

Wenn der Tracker für den entsprechenden Namen noch nicht vorhanden ist, wird er erstellt, seine Tracking-ID auf |trackingId| festgelegt und zurückgegeben. Andernfalls wird der vorhandene Tracker zurückgegeben. Wenn der vorhandene Tracker für den entsprechenden Namen eine andere Tracking-ID hat, wird diese Tracking-ID durch diese Methode nicht geändert. Wenn "defaultTracker" nicht festgelegt ist, wird dies auf die hier zurückgegebene Tracker-Instanz festgelegt.

Parameter

Tracking-ID

Die Tracking-ID, die für diesen Tracker verwendet werden soll. Er sollte das Format UA-xxxxx-y haben. Der Name des Trackers entspricht der Tracking-ID.

Gibt Folgendes zurück:

Ein GAITracker, der der angegebenen Tracking-ID zugeordnet ist. Der Tracker kann verwendet werden, um Tracking-Daten an Google Analytics zu senden. Wenn diese Methode zum ersten Mal mit einer bestimmten Tracking-ID aufgerufen wird, wird der Tracker für den entsprechenden Namen und nachfolgende Aufrufe mit derselben Tracking-ID dieselbe Instanz zurückgeben. Es ist nicht notwendig, den Tracker zu behalten, da er intern von der Bibliothek gespeichert wird.

Wenn ein Fehler auftritt oder die Tracking-ID ungültig ist, wird bei dieser Methode nil zurückgegeben.

Entferne einen Tracker aus dem Tracker-Wörterbuch.

Wenn es sich um den Standard-Tracker handelt, wird auch dieser gelöscht.

Parameter

name	Der Name des Trackers.

Sendet alle ausstehenden Verfolgungsinformationen.

Beachten Sie, dass dies keine Auswirkungen auf weiter unten Seite (Intervall) hat und in Verbindung mit einer regelmäßigen Weiterleitung verwendet werden kann.

Löst das nächste Tracking-Beacon in der Warteschlange aus und ruft "completeHandler" auf, wenn das Tracking-Beacon gesendet wurde (kgaIDispatchGood zurückgegeben) oder ein Fehler aufgetreten ist (kGAIDispatchError).

Wenn keine Netzwerkverbindung besteht oder keine Daten zum Senden vorhanden sind, wird kGAIDispatchNoData zurückgegeben.

Wenn Sie diese Methode mit einem "unvollständigen" abgeschlossenen Handler aufrufen, wird die regelmäßige Weiterleitung deaktiviert. Die periodische Weiterleitung kann wieder aktiviert werden, indem Sie das DispatchIntervall auf eine positive Zahl setzen, wenn die Anwendung im Hintergrund fortgesetzt wird.

Der Aufruf dieser Methode mit einem nil completeHandler ist mit dem Aufruf der obigen Weiterleitung identisch.

Diese Methode kann für das Abrufen von Hintergrunddaten in iOS 7.0 oder höher verwendet werden. Es wäre sinnvoll, dies beim Verlassen der Anwendung aufzurufen, um das Senden der nicht gesendeten Tracking-Informationen zu starten.

Parameter

Abschluss-Handler

Der Block, der nach einer einzelnen Weiterleitungsanfrage ausgeführt werden soll. Der Parameter GAIDispatchResult gibt an, ob die Weiterleitung erfolgreich war, einen Fehler enthält oder keine Treffer zum Senden vorliegen.

Der Einfachheit halber stellt diese Klasse eine Standard-Tracker-Instanz bereit.

Dieser ist auf nil initialisiert und wird auf den ersten Tracker festgelegt, der in trackerWithTrackingId instanziiert wird. Sie kann bei Bedarf überschrieben werden.

Die Klasse GAITrackedViewController verwendet standardmäßig diese Tracker-Instanz.

Der zu verwendende GAILogger.

Wenn dies der Fall ist, werden keine Informationen zur Sendungsverfolgung erfasst. Anrufe werden zu einem managementfreien Vorgang.

Wenn dieser Parameter auf „true“ gesetzt wird, werden alle Informationen gelöscht, deren Upload noch aussteht. Der Wert dieses Flags wird vom SDK automatisch beibehalten. Entwickler können mit diesem Flag optional eine Deaktivierungseinstellung in der App implementieren, damit Nutzer das Google Analytics-Tracking deaktivieren können.

Der Wert wird auf NO gesetzt, wenn das Google Analytics SDK zum ersten Mal auf einem Gerät verwendet wird und danach beibehalten wird.

Wenn dieser Wert positiv ist, werden die Tracking-Informationen automatisch alle DispatchIntervall-Sekunden gesendet.

Andernfalls müssen die Verfolgungsinformationen manuell durch Aufrufen der Weiterleitungsfunktion gesendet werden.

Standardmäßig ist dies auf 120 gesetzt, d. h., dass Tracking-Informationen automatisch alle 120 Sekunden gesendet werden.

Wenn der Wert auf „true“ gesetzt ist, zeichnet das SDK den aktuell registrierten, nicht abgefangenen Ausnahme-Handler auf und registriert dann einen nicht abgefangenen Ausnahme-Handler, der die mit dem StandardTracker aufgetretenen Ausnahmen erfasst.

Wenn defaultTracker nicht nil ist, verfolgt diese Funktion die Ausnahme im Tracker und versucht 5 Sekunden lang ausstehende Tracking-Informationen zu senden. Anschließend wird der zuvor registrierte Ausnahme-Handler aufgerufen, falls vorhanden. Wird der Wert auf „false“ gesetzt, wird der zuvor registrierte, nicht abgefangene Ausnahme-Handler wiederhergestellt.

Ist dies der Fall, werden keine Tracking-Informationen gesendet.

Die Standardeinstellung ist 'NO'.