User Agent Strings

Prev Next

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:

  1. Determine the version of the App to load

  2. Assess Device capabilities (performance levels and make/model)

  3. 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