Individual mobile applications typically send a unique user agent string that is not known to any public repository, or they might not send a user agent at all. As a result, user agent detection for mobile native applications cannot rely on WURFL, Browscap, or other public standard.
To enable tracking of user agent-related information, the Tealeaf client frameworks for mobile native applications submit this header information:
Logging Framework | Example Submitted Header |
---|---|
Android Logging Framework |
|
iOS Logging Framework |
|
The header is also used by the CX UI Capture for AJAX solution. However, user agent detection for UI Capture is sourced from the client used in the session.
When the Reference session agent detects the HTTP_X_TEALEAF
header and either the (android)
or (ios)
value, it does these tasks:
- The Reference session agent overwrites the request variable for traffic type:
TLT_TRAFFIC_TYPE=MOBILE_APP
This value is eventually surfaced as the value
MOBILE_APP
in theTraffic Type
dimension. - The Reference session agent overwrites the request variable for browser platform:
- Android:
TLT_BROWSER_PLATFORM=Android
- iOS:
TLT_BROWSER_PLATFORM=iOS
- Android:
- The Reference session agent looks for the
HTTP_X_TEALEAF_PROPERTY
header, which is submitted from the client frameworks with extended user agent information. For example:HTTP_X_TEALEAF_PROPERTY=TLT_BROWSER=StraussAndPlesser Native; TLT_BROWSER_VERSION=8.5; TLT_BROWSER_PLATFORM=Android; TLT_BRAND=Asus; TLT_MODEL=Asus Eee Pad Transformer TF101; TLT_SCREEN_HEIGHT=800; TLT_SCREEN_WIDTH=1280; TLT_COLOR_DEPTH=65536
- These values are used to populate the
[ExtendedUserAgent]
section. For example:[ExtendedUserAgent] TLT_BROWSER=StraussAndPlesser Native TLT_BROWSER_VERSION=8.5 TLT_BROWSER_PLATFORM=Android TLT_BRAND=Asus TLT_MODEL=Asus Eee Pad Transformer TF101 TLT_SCREEN_HEIGHT=800 TLT_SCREEN_WIDTH=1280 TLT_COLOR_DEPTH=65536
These [ExtendedUserAgent]
fields are not populated with data from the mobile native applications, as the fields are applicable to browsers only:
TLT_BROWSER_JAVASCRIPT
TLT_BROWSER_COOKIES
TLT_PICTURE_SUPPORT
TLT_VIDEO_SUPPORT
TLT_STREAMING_SUPPORT
Some of the variables can be inserted with false
values if the request itself includes a user agent. After these fields were inserted into the [ExtendedUserAgent]
section, the fields and properties of HTTP_X_TEALEAF_PROPERTY
are applied.