- 2 Minutes to read
- Print
- DarkLight
Users
- 2 Minutes to read
- Print
- DarkLight
Identifying users (or customers) is important to improve the analysis of user behavior in your app, e.g. to identify returning visitors. It is also possible to further categorize customers to improve Intelligence results. Please note that this information can contain information regulated by data privacy laws.
Recommendation
Transmit hashed personal data should not be evaluated in terms of content (e.g. with the SHA256 hash). If you would like to collect this data for analytical reasons, we suggest that you transmit the data in encrypted form (see How to Implement Server-Side Encryption in Mapp Intelligence).
Parameter Constants
User categories must be specified within the MIUserCategories() object.
Parameter | Description | Where to configure (Mapp Q3 > Configuration > ...) | Where to analyze |
---|---|---|---|
customerId | Used to identify a user. We highly recommend using MD5 or SHA methods if you pass e-mail addresses. | - | Datatype Text: URM - User Relationship Management > Visitor Id |
customCategories | Used to enrich customer information with additional data. | Categories > User Categories > New Category | Datatype Text: URM - User Relationship Management |
firstName | First name | - | |
lastName | Surname | - | |
newsletterSubscribed | Tracks if the user subscribed to a newsletter | - | |
birthday | Date of birth. Necessary format: int day, int month, int year | - | |
emailAddress | Email address | - | |
emailReceiverId | Email receiver ID | - | |
phoneNumber | Phone number | - | |
street | Street | - | |
streetNumber | Street number | - | |
zipCode | Zip code | - | |
city | City | - | |
country | Country | - | |
gender | Gender. Enum with the following options:
| - |
Methods for Users
User data can be tracked in both page and event requests.
Example iOS
Please note that custom parameters are optional in the request.
Define all event information you want to track:
let userCategories = MIUserCategories() userCategories.customCategories = [20:"userParam1"] userCategories.birthday = MIBirthday(day: 12, month: 1, year: 1993) userCategories.city = "Paris" userCategories.country = "France" userCategories.customerId = "CustomerID" userCategories.gender = .female let event = MIActionEvent(name: "TestAction") event.userCategories = userCategories
Call the trackAction method
MappIntelligence.shared()?.trackAction(event);
Full Code Example
@IBAction func trackCustomAction(_ sender: Any) {
let eventParameters = MIEventParameters(parameters: [20:"ck20Param1"])
//user properties
let userCategories = MIUserCategories()
userCategories.customCategories = [20:"userParam1"]
userCategories.birthday = MIBirthday(day: 12, month: 1, year: 1993)
userCategories.city = "Paris"
userCategories.country = "France"
userCategories.customerId = "CustomerID"
userCategories.gender = .female
//sessionproperties
let sessionParameters = MISessionParameters(parameters: [10: "sessionParam1"])
let event = MIActionEvent(name: "TestAction")
event.eventParameters = eventParameters
event.userCategories = userCategories
event.sessionParameters = sessionParameters
MappIntelligence.shared()?.trackAction(event)
}
Define all event information you want to track:
MIUserCategories* userCategories = [[MIUserCategories alloc] init]; [userCategories setCustomCategories: [@{@20: @"userParam1"} copy]]; [userCategories setCity:@"Paris"]; [userCategories setCountry:@"France"]; [userCategories setCustomerId:@"CustomerID"]; [userCategories setGender: female]; MIActionEvent* event = [[MIActionEvent alloc] initWithName:@"TestAction"]; [event setUserCategories:userCategories];
Call the trackAction method
[[MappIntelligence shared] trackAction:event];
Full Code Example
-(void) testAction {
MIEventParameters* eventParameters = [[MIEventParameters alloc] initWithParameters:[@{@20: @[@"ck20Param1"]} copy]];
MIUserCategories* userCategories = [[MIUserCategories alloc] init];
[userCategories setCustomCategories: [@{@20: @"userParam1"} copy]];
[userCategories setCity:@"Paris"];
[userCategories setCountry:@"France"];
[userCategories setCustomerId:@"CustomerID"];
[userCategories setGender: female];
MISessionParameters* sessionParameters = [[MISessionParameters alloc] initWithParameters:[@{@10: @"sessionParam1"} copy]];
MIActionEvent* event = [[MIActionEvent alloc] initWithName:@"TestAction"];
[event setEventParameters:eventParameters];
[event setUserCategories:userCategories];
[event setSessionParameters:sessionParameters];
[[MappIntelligence shared] trackAction:event];
}