Intégration d’iOS

Intégration

Pour intégrer la bibliothèque, le système a besoin d’appeler cette méthode:

 (void)startWithTrackerURL:(NSURL *)trackerURL appId:(NSUInteger)appId;  

app Id et trackerURL peuvent être reçues lors de l’étape d’enregistrement de votre application.

Pour contrôler la logique de travail de Maxymizely système de suivi, d’utiliser ces champs et méthodes:

A. Enregistrement d’un nombre minimal d’événements dans le paquet:

(void)setMinEventsInPacketCount:(NSUInteger)minEvents;  

Remarquez! Lorsque l’appel de FermeSession est faite, un paquet est envoyé indépendamment de la quantité des événements étant effectuées.

B. Ouverture d’une session:

 + (void)openSession;  

La session ouvre automatiquement après l’événement UIApplicationWillEnterForegroundNotification.

C. Fermeture d’une session:

 + (void)closeSession; 

Session se ferme automatiquement après l’événement UIApplicationDidEnterBackgroundNotification event.

D. Ajout de “valeur de paramètre” dans le flux de l’exploitation forestière:

 + (void)logValue:(double)value forKey:(NSString *)key; 

E. Ajout d’un événement tapé:

(void)addEventWithType:(BMTEventType)type
//event type

content:(NSString *)content
//section (level) where the event occurred
        
referrer:(NSString *)referrer
//previous section (level)

title:(NSString *)title
//section description

name:(NSString *)name
//an element's name

value:(double)value
//value of the element

externalId:(NSString *)externalId
//user's identifier(ex. Logins)

customAttribute1:(NSString *)customAttribute1     
customAttribute2:(NSString *)customAttribute2   
customAttribute3:(NSString *)customAttribute3
//3 custom event attributes that are filled
//at the discretion of the developer

configurationId:(NSInteger)configurationId
//configuration identifier within the application
        
windowId:(UInt32)windowId;
//identifier of the window where the event occurred    

La valeur d’horodatage et de la valeur de paramètre siteId seront placés automatiquement. Voici les versions abrégées de la méthode d’appel de l’ajout d’événements:

(void)logEmpty;
(void)logLoadPage:(NSString *)pageName;
(void)logClick:(NSString *)clickName;
(void)logViewElement:(NSString *)elementName; 
(void)logDownload:(NSString *)item; 
(void)logUpload:(NSString *)item; 
(void)logSubmit:(NSString *)item; 
(void)logRegistration:(NSString *)info; 
(void)logPurchase:(NSString *)purchaseId price:(double)price; 
(void)logLogin:(NSString *)info; 
(void)logError:(NSError *)error; 
(void)log:(NSString *)string;       

F. Ajout d’attributs personnalisés:

(void)addUserAttributeWithName:(NSString *)name
//attribute name

value:(NSString *)value
//attribute value

externalId:(NSString *)externalId
//user’s identifier (ex. Email, different Login)

configurationId:(NSInteger)configurationId;
//configuration identifier within the application  

La configuration

Pour contrôler la logique de fonctionnement du système de suivi Maxymizely, utiliser ces champs et méthodes:

Principaux domaines de configuration:

  • SiteId – un identificateur de la ressource nécessaire pour suivre
  • ConfigurationId – un identificateur pour le suivi des utilisateurs
  • ExternalId – un identifiant d’utilisateur unique (par exemple, un ID utilisateur interne de la base de données, e-mail, login, Facebook ID, ou toute autre information qui permet d’identifier un utilisateur unique)

La méthode de configuration supplémentaire:

(void)addUserAttributeWithName  

Cette méthode permet d’attribuer un certain nombre de paramètres supplémentaires à un utilisateur.

L’application

La base pour l’analyse est le processus de suivi des événements qui se déroulent au sein d’une application. Ces événements peuvent être initiés par un utilisateur, ainsi que par un contenu interactif à l’intérieur de la fenêtre, où le contenu est situé.

Pour l’intégrateur de système, il ya deux niveaux d’événements consignés:

  • Niveau de système
  • Niveau d’utilisateur

La plupart des types d’événements sont disponibles au niveau d’utilisateur. L’intégrateur met en œuvre des contrôles de suivi dans le système des fonctions de l’application.

Pour l’identification précise des points de contrôle / commande des événements il ya un ensemble de paramètres de configuration:

  • Value – identifiant de point de contrôle (un html id de l’élément, le nom de domaine, etc.)
  • CustomAttribute1, CustomAttribute2, CustomAttribute3 – 3 attributs supplémentaires sont fixés à la discrétion d’utilisateur/développeur