By default, Workspace ONE Intelligence SDK reports Network Insights data for all
URLs that are accessed by your app and strips each URL of any query parameters.
For example, http://foo.com?name=critter
becomes http://foo.com
.
This is done to ensure personal information is not transmitted to Workspace ONE
Intelligence.
It is also possible to customise filter deny list that will completely discard matching URLs. Network Insights data that pertains to any URL that matches the stored deny values will not be reported to Workspace ONE Intelligence.
Use the [WS1Filter filterWithString:]
to modify the default filtering
behavior:
Objective-C
// Add filters at initialization
WS1Config *config = [WS1Config defaultConfig];
config.urlFilters = @[[WS1Filter filterWithString:@"sensitiveURL"],
[WS1Filter filterWithString:@"additionalURL"]];
[WS1Intelligence enableWithAppID:@"MYAPPID" config:config];
// Add filters later on
[WS1Intelligence addFilter:[WS1Filter filterWithString:@"anotherURL"]];
Swift
// Add filters at initialization
let config : WS1Config = WS1Config.default()
config.urlFilters = [WS1Filter(string: "sensitiveURL"), WS1Filter(string: "additionalURL")]
WS1Intelligence.enable(withAppID: appID, config: config)
// Add filters later on
WS1Intelligence.add(filter: WS1Filter)
Note
Filters match URLs via case sensitive substring matching
+ filterWithString:
Convenience method to create a deny filter.
Objective-C
+ (WS1Filter *)filterWithString:(NSString *)matchToken;
Swift
class func filter(withString: matchToken)
matchToken |
An NSString of the url to filter |
A WS1Filter object for matchToken.
+ filterWithString:andFilterType:
Convenience method to create a filter with the specified filter type.
Objective-C
+ (WS1Filter *)filterWithString:(NSString *)matchToken
andFilterType:(WS1FilterType)filterType
Swift
class func filter(withString: matchToken andFilterType:filterType)
matchToken |
An NSString of the url to filter |
filterType |
Indicates filter type |
A WS1Filter object for matchToken.
- initWithString:
Initialize a filter that denies reporting for all URLs that match the specified token.
Objective-C
- (id)initWithString:(NSString *)matchToken;
Swift
init?(string matchToken: String)
matchToken |
An NSString of the url to filter |
A WS1Filter object of type WS1FilterTypeDeny
- initWithString:andFilterType:
Initialize a filter that with the behavior specified by the filter type.
Objective-C
- (id)initWithString:(NSString *)matchToken
andFilterType:(WS1FilterType)filterType;
Swift
init?(string matchToken: String,
filterType filterType: WS1FilterType)
matchToken |
An NSString of the url to filter |
filterType |
Indicates filter type |
A WS1Filter object with the indicated filter type.
+ doesMatch:
Returns YES if the filter matches the provided URL string
Objective-C
- (BOOL)doesMatch:(NSString *)url;
Swift
url |
Specifies the url to be matched |
Returns YES when the filter matches the provided URL string
WS1FilterType
The filter type of WS1Filter
Objective-C
typedef enum : NSInteger {
WS1FilterTypeDeny,
WS1FilterTypePreserveQuery,
WS1FilterTypePreserveFragment,
WS1FilterTypePreserveParameters,
WS1FilterTypePreserveAll
} WS1FilterType;
Swift
enum WS1FilterType : Int {
case Deny
case PreserveQuery
case PreserveFragment
case PreserveParameters
case PreserveAll
}
|
Deny reporting for certain endpoints. Request with a URL that matches this string are not reported |
|
Prevent URL query string from being stripped out |
|
Prevent URL fragment identifier from being stripped out |
|
Prevent URL parameter string from being stripped out |
|
Prevent URL query, fragment, and parameters sections from being stripped out |