User Agent Strings

    User Agent Strings


    Article summary

    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


    Was this article helpful?