- Print
User Agent Strings
- Print
The user-agent string allows your app to identify the browser version, device make/model/supported software, and the version of Firebolt®. This uniform user-agent string will simplify app development and harmonize across all devices, including Sky, Xfinity, and Xumo. Additionally, this user-agent string meets IAB’s OTT Device recommendation to differentiate connected TV/streaming devices.
The user-agent string follows the following pattern:
<browser> ComcastAppPlatform <device model> Firebolt/<firebolt version>
Browser
= The browser used by the device.ComcastAppPlatform
= The connected OTT device (e.g.: STB, TV, etc)Device Model
= The make and model of the device.Firebolt/<version>
= The current version of Firebolt® running on the device
Example Xfinity Arris Xi6
Mozilla/5.0 (Linux; x86_64 GNU/Linux) AppleWebKit/601.1 (KHTML, like Gecko) Version/8.0 Safari/601.1 WPE ComcastAppPlatform AX061AEI Firebolt/0.8.1
Example Sky Titan v2
Mozilla/5.0 (X11; Linux armv7l) AppleWebKit/537.36 (KHTML, like Gecko) QtWebEngine/5.9.7 Chrome/56.0.2924.122 Safari/537.36 ComcastAppPlatform ES340UK Firebolt/0.6
Targeting App versions
To effectively target an App version, the partner can follow these steps using the Firebolt® API:
Determine the version of the App to load
Assess Device capabilities (performance levels and make/model)
Based on Device capabilities, the App should use the appropriate device APIs
Note: Advertisers who want more detailed info, such as those found within SIS (operator, experience, etc), must choose to adopt Firebolt or the AdvertisingSDK to receive this level of data via API.
Legacy custom user-agent strings
If your App has already been released using a different user-agent string format, please work with your partner manager to coordinate an appropriate switchover date.
What changes need to be made?
The current user-agent string typically contains less information, so in most cases, nothing will need to change, and the new user-agent string should not disrupt your App.
If your analytics/telemetry segments are by UAS, you must adjust the “fingerprint” after the user-agent change.
If your App relies on any user-agent parameters to target/profile, please coordinate with your partner manager to adopt Firebolt® APIs to continue access to those parameters.
If your App requires a custom user-agent string for operational purposes, evaluate options with your partner manager.
Does my app need to use Firebolt® to move to the new user-agent string?
No. Although the new user-agent string identifies the supported Firebolt® version, this is a courtesy to Apps that have adopted Firebolt®. Apps may use this parameter to load the appropriate Firebolt® packages. Apps that don’t utilize Firebolt® can continue as is, ignoring the presence of the Firebolt
value in the user-agent string.
Xumo & Sky Devices
Platforms | Model Number | Xumo | Sky | Device Lifecycle | Sprint Branch | Stable Branch |
---|---|---|---|---|---|---|
Hisense | HSTP11MWR | ✓ | Purchase | Available | stable2 | |
Hisense GX | HSTP11MWRFX50 | ✓ | Purchase | Available | stable2 | |
Hisense V2 | HSTP12MWR | ✓ | Purchase | Available | stable2 | |
Element | ELTE11MWR | ✓ | Purchase | Available | stable2 | |
Pioneer | PITU11MWR | ✓ | Purchase | Available | stable2 | |
Pioneer HD | XUSHTB11MWR | ✓ | Purchase | Available | stable2 | |
Apache HD | XUSHTC11MWR | ✓ | TBA | Available | stable2 | |
Apache UHD | XUSPTC11MWR | ✓ | TBA | Available | stable2 | |
ES1 Realtek | COESST11AEI | ✓ | In Trials | Available | stable2 | |
LLAMA IT | SKTL11MEIIT | ✓ | Purchase | Available | stable2 | |
LLAMA UK | SKTL11AEI | ✓ | Purchase | Available | stable2 | |
XIONE ALPACA IT | SKXI11AENSOIT | ✓ | Purchase | Available | stable2 | |
XIONE DE | SKXI11AIS | ✓ | Purchase | Available | stable2 | |
XIONE IT | SKXI11ANS | ✓ | Purchase | Available | stable2 | |
XIONE UK | SKXI11ADS | ✓ | Purchase | Available | stable2 |
Other Supported Devices
Platforms | Model Number | Comcast | Cox | Shaw | ROGERS | Videotron | Charter | Device Lifecycle | Sprint Branch | Stable Branch |
---|---|---|---|---|---|---|---|---|---|---|
Pace XG1v1 | PX001AN | ✓ | EOL | stable2_pxg1v1 | ||||||
Pace XG1v3 | PX013AN | ✓ | Purchase | |||||||
Arris XG1v1 | MX011AN | ✓ | EOL | |||||||
Arris XG1v3 | AX013AN | ✓ | ✓ | ✓ | Purchase | |||||
Arris XG1v4 | AX014AN | ✓ | ✓ | Purchase | Available | stable2 | ||||
Arris XG1v1-RM | AX11RAN | ✓ | EOL | |||||||
Cisco G8 | CS011AN | ✓ | EOD | |||||||
Pace Xi3 | PX032ANI | ✓ | EOL | |||||||
Pace XiD | PXD01ANI | ✓ | ✓ | ✓ | Purchase | |||||
Cisco XiD | CXD01ANI | ✓ | ✓ | ✓ | Purchase | |||||
Pace Xi5 | PX051AEI | ✓ | Purchase | |||||||
Arris Xi6 | AX061AEI | ✓ | ✓ | ✓ | ✓ | ✓ | Purchase | Available | stable2 | |
Technicolor Xi6 | TX061AEI | ✓ | ✓ | ✓ | ✓ | Purchase | Available | stable2 | ||
Sercomm Xione BCOM | SCXI11BEI | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Purchase | Available | stable2 |
Sercomm Xione Realtek | SCXI11AIC | ✓ | ✓ | Purchase | Available | stable2 | ||||
WNC Xione | WNXi11AEI | ✓ | Purchase | Available | stable2 | |||||
Pace XG2v2 | PX022AN | ✓ | ✓ | Purchase | ||||||
Sam XG2v2 | SX022AN | ✓ | ✓ | EOD | ||||||
Pace RNG | PR150BN | ✓ | EOL | stable2_rng | ||||||
Sam RNG | SR150BN | ✓ | EOL | stable2_rng |