Référence de la classe GAI

Présentation

Classe supérieure de Google Analytics pour iOS.

Fournit des installations permettant de créer des outils de suivi et de définir des indicateurs comportementaux.

Hérite de NSObject.

Méthodes d'instance

(id< GAITracker >)- trackerWithName:trackingId :
 Crée ou récupère une implémentation de GAITracker avec le nom et l'ID de suivi spécifiés. Plus...
 
(id< GAITracker >)- trackerWithTrackingId :
 Crée ou récupère une implémentation GAITracker dont le nom correspond à l'ID de suivi spécifié. Plus...
 
(void)- removeTrackerByName:
 Supprimez un coach électronique du dictionnaire des outils de suivi. Plus...
 
(void)- livraison
 Envoie toutes les informations de suivi en attente. Plus...
 
(void)- shippingWithCompletionHandler:
 Envoie la balise de suivi suivante dans la file d'attente, en appelant la méthode completeHandler lorsque la balise de suivi a été envoyée (renvoie kGAIDispatchGood) ou si une erreur s'est produite (renvoie kGAIDispatchError). Plus...
 

Méthodes de classe

(GAI*)+ sharedInstance
 Obtenez l'instance partagée de la classe Google Analytics pour iOS. Plus...
 

Propriétés

id< GAITracker >par défaut Tracker
 Pour plus de commodité, cette classe expose une instance de suivi par défaut. Plus...
 
id< GAIlogger >enregistreur
 GAILogs à utiliser. Plus...
 
BOOLdésactiver
 Dans ce cas, aucune information de suivi n'est collectée. Les appels de suivi deviennent alors des no-ops. Plus...
 
NSTimeIntervalleshippinginterval.
 Si cette valeur est positive, les informations de suivi sont automatiquement expédiées toutes les secondes, le cas échéant. Plus...
 
BOOLtrackUnCatchExceptions
 Lorsque ce paramètre est défini sur "true", le SDK enregistre le gestionnaire d'exceptions non capturées actuellement enregistré, puis enregistre un gestionnaire d'exceptions non capturées qui suit les exceptions qui se sont produites à l'aide de defaultTracker. Plus...
 
BOOLdryrun
 Dans ce cas, aucune information de suivi n'est envoyée. Plus...
 

Documentation de la méthode

+ (GAI *) sharedInstance

Obtenez l'instance partagée de la classe Google Analytics pour iOS.

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

Crée ou récupère une implémentation de GAITracker avec le nom et l'ID de suivi spécifiés.

Si l'outil de suivi du nom spécifié n'existe pas déjà, il sera créé et affiché. Sinon, l'outil de suivi existant sera renvoyé. Si l'outil de suivi existant pour le nom respectif a un ID de suivi différent, cet ID de suivi n'est pas modifié par cette méthode. Si defaultTracker n'est pas défini, il sera défini sur l'instance de suivi renvoyée ici.

Paramètres
name (nom)Nom de ce coach électronique. Ne doit pas être nil ni vide.
ID de suiviID de suivi à utiliser pour cet appareil. Il doit être au format UA-xxxxx-y.
Renvoie
GAITracker associé au nom spécifié. L'outil de suivi peut être utilisé pour envoyer des données de suivi à Google Analytics. La première fois que cette méthode est appelée avec un nom particulier, l'outil de suivi de ce nom est renvoyé, et les appels ultérieurs portant le même nom renvoient la même instance. Il n'est pas nécessaire de conserver l'appareil, car celui-ci sera conservé en interne par la bibliothèque.

Si une erreur se produit ou si le nom n'est pas valide, cette méthode renvoie nil.

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

Crée ou récupère une implémentation GAITracker dont le nom correspond à l'ID de suivi spécifié.

Si l'outil de suivi du nom correspondant n'existe pas déjà, il est créé. Son ID de suivi est défini sur |trackingId|. Il est renvoyé. Sinon, l'outil de suivi existant est renvoyé. Si l'outil de suivi existant pour le nom respectif a un ID de suivi différent, cet ID de suivi n'est pas modifié par cette méthode. Si defaultTracker n'est pas défini, il est défini sur l'instance de suivi renvoyée ici.

Paramètres
ID de suiviID de suivi à utiliser pour cet appareil. Il doit être au format UA-xxxxx-y. Le nom de l'outil de suivi sera identique à l'identifiant de suivi.
Renvoie
GAITracker associé à l'ID de suivi spécifié. L'outil de suivi peut être utilisé pour envoyer des données de suivi à Google Analytics. La première fois que cette méthode est appelée avec un ID de suivi particulier, l'outil de suivi du nom correspondant est renvoyé, et les appels ultérieurs associés au même ID de suivi renvoient la même instance. Il n'est pas nécessaire de conserver l'appareil, car celui-ci sera conservé en interne par la bibliothèque.

Si une erreur se produit ou si l'ID de suivi n'est pas valide, cette méthode renvoie nil.

- (void) removeTrackerByName: (NSString *) name

Supprimez un coach électronique du dictionnaire des outils de suivi.

S'il s'agit de l'outil de suivi par défaut, l'option est également supprimée.

Paramètres
name (nom)Nom du coach électronique.
- Livraison (void)

Envoie toutes les informations de suivi en attente.

Notez que cette méthode n'a pas d'effet sur l'intervalle de diffusion et peut être utilisée conjointement avec l'envoi périodique.

- (void) shippingWithCompletionHandler: (void(^)(GAIDispatchResult résultat)) completionHandler

Envoie la balise de suivi suivante dans la file d'attente, en appelant la méthode completeHandler lorsque la balise de suivi a été envoyée (renvoie kGAIDispatchGood) ou si une erreur s'est produite (renvoie kGAIDispatchError).

En l'absence de connexion réseau ou en l'absence de données, kGAIDispatchNoData est renvoyé.

Notez que le fait d'appeler cette méthode avec un gestionnaire final nul est désactivé. Vous pouvez réactiver l'envoi périodique en définissant un intervalle positif entre la valeur de l'attribut "RépartitionIntervalle" et le nombre de fois où l'application redémarre en arrière-plan.

L'appel de cette méthode avec un gestionnaire nil completeHandler est identique à l'appel de la distribution ci-dessus.

Cette méthode peut être utilisée pour récupérer des données en arrière-plan sous iOS 7.0 ou version ultérieure. Il est préférable d'appeler cette méthode lorsque l'application se ferme afin d'envoyer les informations de suivi non envoyées.

Paramètres
TerminéBloc à exécuter après une seule requête de distribution. Le paramètre GAIDispatchResult indique si la distribution a réussi, si elle a généré une erreur ou si elle n'a reçu aucun appel.

Documentation de la propriété

- (id<GAITracker>) defaultTracker
(écriture, non atomique, attribution)

Pour plus de commodité, cette classe expose une instance de suivi par défaut.

Elle est initialisée sur nil et sera définie sur le premier outil de suivi instancié dans trackerWithTrackingId:. Elle peut être remplacée si vous le souhaitez.

La classe GAITrackedViewController utilisera par défaut cette instance de suivi.

- Journalisation (id<GAIlogger>)
(écriture, non atomique, conservation)

GAILogs à utiliser.

- (BOOL) désactivation
(écriture, non atomique, attribution)

Dans ce cas, aucune information de suivi n'est collectée. Les appels de suivi deviennent alors des no-ops.

Lorsque ce paramètre est défini sur "true", toutes les informations en attente d'importation sont supprimées. La valeur de cet indicateur est automatiquement conservée par le SDK. Cette option permet aux développeurs d'implémenter un paramètre de désactivation dans l'application afin de permettre aux utilisateurs de désactiver le suivi Google Analytics.

Ce paramètre est défini sur NO la première fois que le SDK Google Analytics est utilisé sur un appareil. Il est ensuite conservé.

- (NSTimeIntervalle) RépartitionIntervalle
(écriture, non atomique, attribution)

Si cette valeur est positive, les informations de suivi sont automatiquement expédiées toutes les secondes, le cas échéant.

Sinon, vous devez envoyer les informations de suivi manuellement en appelant la distribution.

La valeur par défaut est 120. Les informations de suivi doivent donc être envoyées automatiquement toutes les 120 secondes.

- (BOOL) trackUnCatchExceptions
(écriture, non atomique, attribution)

Lorsque ce paramètre est défini sur "true", le SDK enregistre le gestionnaire d'exceptions non capturées actuellement enregistré, puis enregistre un gestionnaire d'exceptions non capturées qui suit les exceptions qui se sont produites à l'aide de defaultTracker.

Si defaultTracker n'est pas nil, cette fonction suit l'exception sur le coach électronique et tente d'envoyer les informations de suivi en suspens pendant 5 secondes. Le cas échéant, il appellera le gestionnaire d'exceptions précédemment enregistré. Si ce paramètre est défini sur "false", le gestionnaire d'exceptions non enregistrées précédemment restauré est restauré.

- (BOOL) d'exécution à sec
(écriture, non atomique, attribution)

Dans ce cas, aucune information de suivi n'est envoyée.

La valeur par défaut est 'NO'.