wurfl.js getting started guide

ScientiaMobile WURFL.js Business Edition Getting Started Guide

Introduction

WURFL.js Business Edition provides access to ScientiaMobile’s cloud-based WURFL Device Description Repository (DDR). With a single javascript snippet, developers can detect a device and its capabilities in order to better control, optimize, and track the success of their website.

Quick Start

Once you have signed up for an account, you will simply need to enter the hostnames of the websites from which you intend to use WURFL.js:

Customer Vault WURFL.js

If you do not want to configure a CNAME record for your account, then you can now include the following script referencing wjs.wurflcloud.com/wurfl.js in your markup:

<script type='text/javascript' src="//wjs.wurflcloud.com/wurfl.js"></script>

The WURFL object is now available to use:

/**
 * Example of pushing WURFL capabilities to google analytics
 */
ga('send', 'pageview', {
    'dimension1': WURFL.complete_device_name,
    'dimension2': WURFL.form_factor,
    'dimension3': WURFL.is_mobile,
    'dimension4': WURFL.is_robot
});

Capabilities

A full list of available capabilities for WBE WURFL.js Business Edition can be found here.

Caching

WURFL.js Business Edition allows clients to cache the WURFL response on the end-user's browser in order to increase overall performance.

When testing, it is possible to disable caching by adding debug=true to the query string.

<script type='text/javascript' src="//wjs.wurflcloud.com/wurfl.js?debug=true"></script>

Hostnames

Hostnames are required to associate traffic with your account. Under the Associated Hostnames section of your account, you must enter the domains and sub-domains from which you will be accessing WURFL.js Business Edition. By default. WURFL.js Business Edition supports 3 hostnames.

DNS CNAME Support

You can name the WURFL.js Business Edition service as your own by configuring your Domain Name Server (DNS) using CNAME records. Once these CNAME records are entered in the “Associated CNAME Records” section of your account. WURFL.js Business Edition will honor them.

To set up an associated CNAME record, you must configure a CNAME record that points to wjs.wurflcloud.com with your DNS provider, which may or may not be the same as your web hosting provider.

You can then enter them in the CNAME section from the left navigation menu of your account.

Customer Vault WURFL.js

Note: Your DNS changes may take up to a full day to propagate.

You will be able to refer to the service in the HTML page as (assuming your CNAME entry is wjs.your-domain.com):

<script src="//wjs.your-domain.com/wurfl.js"></script>

HTTPS and SSL Support

HTTPS provides a level of security and trust for users of many commercial services. WURFL.js Business Edition enables customers to upload their SSL certificates through their customer vault.

Using these certificates, WURFL.js Business Edition can serve multiple hostnames via the CNAME records using HTTPS.

Customer Vault WURFL.js

Service Level Agreement (SLA)

WURFL.js Business Edition provides fully dedicated infrastructure for its customers. WURFL.js Business Edition provides a Service Level Agreement with a 99.99% uptime target. The definition of the SLA can be found in the license agreement here.

License

2017 ScientiaMobile Incorporated.

The complete WURFL.js Business Edition License can be found here.