GAI Class Reference

Get the shared instance of the Google Analytics for iOS class.

Creates or retrieves a GAITracker implementation with the specified name and tracking ID.

If the tracker for the specified name does not already exist, then it will be created and returned; otherwise, the existing tracker will be returned. If the existing tracker for the respective name has a different tracking ID, that tracking ID is not changed by this method. If defaultTracker is not set, it will be set to the tracker instance returned here.

Parameters

name	The name of this tracker. Must not be nil or empty.
trackingID	The tracking ID to use for this tracker. It should be of the form UA-xxxxx-y.

Returns

A GAITracker associated with the specified name. The tracker can be used to send tracking data to Google Analytics. The first time this method is called with a particular name, the tracker for that name will be returned, and subsequent calls with the same name will return the same instance. It is not necessary to retain the tracker because the tracker will be retained internally by the library.

If an error occurs or the name is not valid, this method will return nil.

Creates or retrieves a GAITracker implementation with name equal to the specified tracking ID.

If the tracker for the respective name does not already exist, it is created, has it's tracking ID set to |trackingId|, and is returned; otherwise, the existing tracker is returned. If the existing tracker for the respective name has a different tracking ID, that tracking ID is not changed by this method. If defaultTracker is not set, it is set to the tracker instance returned here.

Parameters

trackingID

The tracking ID to use for this tracker. It should be of the form UA-xxxxx-y. The name of the tracker will be the same as trackingID.

Returns

A GAITracker associated with the specified trackingID. The tracker can be used to send tracking data to Google Analytics. The first time this method is called with a particular trackingID, the tracker for the respective name will be returned, and subsequent calls with the same trackingID will return the same instance. It is not necessary to retain the tracker because the tracker will be retained internally by the library.

If an error occurs or the trackingId is not valid, this method will return nil.

Remove a tracker from the trackers dictionary.

If it is the default tracker, clears the default tracker as well.

Parameters

name	The name of the tracker.

Dispatches any pending tracking information.

Note that this does not have any effect on dispatchInterval, and can be used in conjunction with periodic dispatch.

Dispatches the next tracking beacon in the queue, calling completionHandler when the tracking beacon has either been sent (returning kGAIDispatchGood) or an error has resulted (returning kGAIDispatchError).

If there is no network connection or there is no data to send, kGAIDispatchNoData is returned.

Note that calling this method with a non-nil completionHandler disables periodic dispatch. Periodic dispatch can be reenabled by setting the dispatchInterval to a positive number when the app resumes from the background.

Calling this method with a nil completionHandler is the same as calling the dispatch above.

This method can be used for background data fetching in iOS 7.0 or later. It would be wise to call this when the application is exiting to initiate the submission of any unsubmitted tracking information.

Parameters

completionHandler

The block to run after a single dispatch request. The GAIDispatchResult param indicates whether the dispatch succeeded, had an error, or had no hits to dispatch.

For convenience, this class exposes a default tracker instance.

This is initialized to nil and will be set to the first tracker that is instantiated in trackerWithTrackingId:. It may be overridden as desired.

The GAITrackedViewController class will, by default, use this tracker instance.

The GAILogger to use.

When this is true, no tracking information will be gathered; tracking calls will effectively become no-ops.

When set to true, all information that is pending uploading will be deleted. The value of this flag will be persisted automatically by the SDK. Developers can optionally use this flag to implement an opt-out setting in the app to allows users to opt out of Google Analytics tracking.

This is set to NO the first time the Google Analytics SDK is used on a device, and is persisted thereafter.

If this value is positive, tracking information will be automatically dispatched every dispatchInterval seconds.

Otherwise, tracking information must be sent manually by calling dispatch.

By default, this is set to 120, which indicates tracking information should be dispatched automatically every 120 seconds.

When set to true, the SDK will record the currently registered uncaught exception handler, and then register an uncaught exception handler which tracks the exceptions that occurred using defaultTracker.

If defaultTracker is not nil, this function will track the exception on the tracker and attempt to dispatch any outstanding tracking information for 5 seconds. It will then call the previously registered exception handler, if any. When set back to false, the previously registered uncaught exception handler will be restored.

When this is 'YES', no tracking information will be sent.

Defaults to 'NO'.