Integration von iOS

Integration

Um die Bibliothek  zu integrieren, muss das System diese Methode aufrufen:

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

appId und trackerURL können während des Registrierungsschrittes Ihrer Applikation empfangen werden.

Um die Arbeitslogik des Maxymizely Verfolgungssystems zu kontrollieren, verwenden Sie diese Felder und Methoden:

A. Registrierung der minimalen Anzahl von Ereignissen im Paket:

(void)setMinEventsInPacketCount:(NSUInteger)minEvents;  

Hinweis! Wenn der Aufruf von closeSession erfolgt ist, wird das Paket ohne Rücksicht auf die Anzahl der durchgeführten Ereignisse gesendet.

B. Eröffnung einer Sitzung:

 + (void)openSession;  

Die Sitzung wird automatisch nach dem UIApplicationWillEnterForegroundNotification Ereignis geöffnet.

C. Beendigung einer Sitzung:

 + (void)closeSession; 

Die Sitzung wird automatisch nach dem UIApplicationDidEnterBackgroundNotification Ereignis beendet.

D. Hinzufügen von “Parameter-Wert” in den Prozess der Datenerhebung:

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

E. Hinzufügen von dem typisierten Ereignis:

(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    

Der Zeitstempelwert und der siteId Parameterwert werden automatisch gesetzt. Hier sind die Kurzfassungen für die Aufrufmethode vom Hinzufügen der Ereignisse:

(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. Hinzufügen von den kundenspezifischen Attributen:

(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  

Konfiguration

Um die Arbeitslogik des Maxymizely Verfolgungssystems zu kontrollieren, verwenden Sie diese Felder und Methoden:

Die Hauptkonfigurationsfelder:

• SiteId – ein Quellenidentifikator, der verfolgt werden muss
• ConfigurationId – ein Identifikator für die Benutzerverfolgung
• ExternalId – ein eindeutiger Benutzeridentifikator (zum Beispiel, eine interne Benutzer-ID in der Datenbank, E-Mail, Login, Facebook-ID, oder andere Information, die den eindeutigen Benutzer zu identifizieren hilft). Die zusätzliche Konfigurationsmethode:

(void)addUserAttributeWithName  

Diese Methode ermöglicht die Zuordnung einer Vielzahl der zusätzlichen Parameter zu dem Benutzer.

Applikation

Die Grundlage für die Analyse ist der Verfolgungsprozess von Ereignissen, die in der Applikation stattfinden. Diese Ereignisse können vom Benutzer initiiert werden, sowie mit dem interaktiven Ihnalt im Fenster, wo der Inhalt sich befindet.

Für den Systemfintegrator gibt es zwei Ebenen der protokollierten Ereignisse:

• Systemebene
• Benutzerebene

Die meisten Ereignistypen stehen auf der Benutzerebene zur Verfügung. Der Integrator implementiert die Kontrollstellen der Verfolgung im Funktionssystem der Applikation.

Für eine genaue Identifizierung der Kontrollereignisse/Kontrollstellen gibt es einen Satz der Konfigurationsparametern:

• Value – Identifikator des Kontrollpunktes (ID HTML des Elements, Feldname, usw.)
• CustomAttribute1, CustomAttribute2, CustomAttribute3 – drei zusätzliche Attribute werden nach Wahl des Benutzers/Entwicklers gesetzt