FAQ

ScientiaMobile offers a support forum open to all WURFL users. Commercial licensees are invited to post questions from the account to which their licenses are associated. This may mean faster handling of those posts by ScientiaMobile’s personnel. ScientiaMobile also offers commercial support packages with various tiered support levels to address a variety of business needs. You may contact us using our general contact form or license inquiry form.


General

 

Back to top

Q: Another company is selling WURFL data with a different API. Why should I choose ScientiaMobile?

A: WURFL data may not be resold or used with a different API. If you discover a company that is doing this, please notify us. While the source code and the repository are not hidden, third-parties do not have the legal right to take the work and resell it.  ScientiaMobile is the industry standard for accurate, high-performance device detection.  We achieve this through extensive experience, fine tuning our API and its search algorithms, and continuous expansion of our device coverage. We find that many people who experiment with other services quickly discover their shortcomings and switch to WURFL.

Back to top

Q: How do I update my WURFL data automatically?

A: All ScientiaMobile WURFL OnSite and WURFL InFuze customers are given access to a direct download URL for obtaining the latest WURFL snapshot. This is either the weekly snapshot (released on Sunday night), or an Out-Of-Band snapshot that we release to our customers between weekly snapshots in case of a significant improvement to the data (for example, if a high-profile device is released mid- week and it is not yet in WURFL). The snapshots are licensed to your organization with your commercial license included. To access the direct download URL, customers can login to ScientiaMobile and click on the Login link in the top-right of the screen. This will provide access to the customer vault. Clicking on “direct download link” in the lower right of the vault will create a custom direct download URL. This URL is unique to each customer and must be kept private. Instructions for implementing automatic downloading of WURFL data are included in the customer vault.

Please see this documentation for further details about automating the download.

Back to top

Q: Can I be notified whenever there is an API update or other significant change?

A: Yes. Commercial licensees are already notified, but you may manually subscribe to the ScientiaMobile Announcements list if you have another address where you’d like to receive the notifications.

Back to top


Licensing

Q: What is the price of a commercial license?

A: We offer several products, each with the their own license type. In general, for On-Premise products (WURFL OnSite, WURFL InFuze, and WURFL InSight) the price varies based on scope of usage (Mobile Web Optimization, Analytics, Advertising), the number of detections, the number of WURFL Capabilities, the scope of the deployment (single site, multiple sites, OEM), and the size of the company. All of the premise-based products are based on an annual fee.

Cloud-Based products (WURFL Cloud, WURFL.js Business Edition, and ImageEngine) have different pricing plans, but all are billed monthly. WURFL Cloud varies based on the capabilities used and the number of detections.  WURFL.js Business Edition is priced based on the number of unique visitors to a website. And ImageEngine is priced based on the number of images resized and GB delivered of output images.

Please contact our sales to learn more about a pricing plan that matches your needs.

Back to top

Q: What are the advantages to licensing WURFL commercially?

A: Beginning with release 1.8, WURFL is available only via a Commercial license or an Evaluation license that expires in 30 days. Former AGPL or open source users should contact us to explore the Evaluation license or purchase a Commercial license. They might also look into products such as WURFL Cloud or WURFL.js.  As a commercial product, WURFL’s advantages are continued innovation, improvements, maintenance, and support. Over the last several years, we have released several exciting new products, improved performance of the  API, and grown our device data to over 45,000 device profiles.  Commercial customers receive weekly automated updates. They have the choice of selecting from over 500 WURFL device capabilities. They received ticketed support via our Enterprise support portal.

Back to top

Q: Will a commercial license give me access to newer versions of the InFuze and OnSite APIs?

A: Yes. As part of the annual license, customers are entitled to upgrading to the latest and greatest API release.

Back to top

Q: What is the renewal timeframe on the license?

A: Premise-based products (WURFL OnSite, WURFL InFuze, and WURFL InSight) renew based on an annual fee. These fees provide access to updates to clients, APIs or DDR data within the scope of their particular product during that initial and renewal timeframe. Cloud-based products are monthly fees and renewals.

Back to top

Q: My company uses WURFL for analytics and reporting purposes. Do I need to license WURFL commercially?

A: Yes. Please contact ScientiaMobile and our sales team will work with you to create an offer that best fits your analytical solution needs.  ScientiaMobile treats Mobile optimization, advertising, analytics, and image optimization as separate use cases that require specific license terms. Certain products (e.g. WURFL Cloud) do not support the analytics use case.

Back to top

Q: My product bundles WURFL which I sell to multiple customers. Do I need to acquire a Single commercial license for each of them?

A: ScientiaMobile also offers OEM commercial licenses for the WURFL OnSite and WURFL InFuze products. Pricing is based on the number of customers and is considerably lower than the price of multiple single licenses. Please contact ScientiaMobile for details.

Back to top

Q: I am a device manufacturer/OEM who intends to ensure that its devices are correctly represented in WURFL. How can I make that happen?

A: Our process already involves including new and popular devices shortly after they become available on the market, but OEMs should make extra sure that devices are correctly represented before the device is released. For this reason, we have a created a device manufacturer partner offering which provides a fast-track into making device data available to the WURFL user base as soon as possible. Please contact ScientiaMobile about this offering.

Back to top


 Commercial And Evaluation Licenses and Restrictions

Q: What’s the license of the WURFL APIs?

A: As of Release 1.8, the WURFL API is only offered under a Commercial license or an Evaluation license that expires in 30 days. WURFL is no longer released under AGPL or Open Source licenses.

Back to top

Q: Can I modify the API?

A: The Commercial and Evaluation licenses do not provide source code for the WURFL API. If you have a compelling business requirement for access to the source code, then please contact about a Commercial license. We strive to improve and maintain the accuracy and performance of the WURFL API. For that reason, we do not encourage customers to modify the API. Nor do we support changes customers make to the API.

Back to top

Q: Can I add a new device profile to WURFL to manage a new device?

A:  If you are a commercially licensed customer who has downloaded the wurfl.xml file from the customer vault (i.e. licensed repository), then yes, you can. Any WURFL user (both commercial and Evaluation) who would like to have additions permanently added to the WURFL DDR can submit a request by emailing ScientiaMobile, or posting on our support forum.

 

Back to top


Customer Vault

Q: What is the Customer Vault?

A: ScientiaMobile serves commercial licensees of WURFL by offering them a personal virtual space in which they can access their licenses and updated versions of the WURFL repository. Every user who registers with ScientiaMobile obtains access to their customer vault via a username and password. Such a vault is initially empty and gets populated with the goodies that the user acquires as they become commercial licensees.

Back to top

Q: What do commercial WURFL licensees find in their Customer Vault?

A: The Customer Vault contains the license for the software that has been purchased. WURFL OnSite and WURFL InFuze customers will find several weeks of the WURFL DDR updates. ScientiaMobile releases a new WURFL update every week. In addition to the weekly snapshots, the Vault contains a customized URL to the latest update, that can be used to update one’s WURFL installation programmatically. Please refer to the following documentation for details. In the vault, WURFL Cloud Customers will find a link to the Cloud Control panel, giving access to: personal API keys, WURFL capabilities, usage history, and WURFL Cloud client for the different programming platforms.

Back to top


WURFL Cloud

Q: What is WURFL Cloud?

A: The WURFL Cloud Service is a highly-available Cloud installation of the WURFL Device Description Repository that allows companies to query updated mobile device information in real time. WURFL OnSite and WURFL InFuze APIs require that developers or system administrators periodically download and deploy a newer wurfl.xml file, to enrich the DDR with the device profiles of recently-released devices. The WURFL Cloud Client has access to a constantly updated repository in the Cloud. This is comprised of essentially two parts:

  1. WURFL Cloud Client: This is a library which can analyze an HTTP request and create a corresponding query to the WURFL Cloud Server over HTTP. The WURFL Cloud client provides several API options including PHP, Java, .Net, Ruby, Perl, Python and Node.js. A strategy for local caching is usually adopted to minimize latency. A monthly WURFL Cloud Service subscription is required to obtain the credentials to query the WURFL Cloud Service.
  2. WURFL Cloud Service: This is the highly-available service with the most up to date WURFL DDR managed by ScientiaMobile. Subscribers are given access to WURFL Cloud account settings from which they can (among other things) download the cloud clients for the different languages, find their unique API key to use the service and access a report about their usage.

Back to top

Q: How do I sign up for WURFL Cloud?

A: Please see our Getting Started guide.

Back to top

 

Q: Who can use WURFL Cloud?

A: WURFL Cloud is open to companies of all sizes, though no OEM clients or software as a service companies (SaaS) can use WURFL Cloud client to serve their customers. You should refer to the Terms and Conditions for the use of the service if in doubt.

Back to top

Q: What counts as a detection?

A: A detection in the WURFL Cloud product is counted as a unique visitor in a 24 hour period. The number of detection’s you need will be roughly equal to your unique visitors in a given month.

Back to top

Q: Which languages are supported in talking to WURFL Cloud?

A: Here is a list of languages for which a WURFL Cloud API exists: PHP 5.1+, Java 1.5+, ASP.NET 2.0 through 4.0, Perl, Node.js, Ruby and Python are officially supported. In addition to this, at least one customer has been allowed to ‘speak JSON’ to the Cloud directly.

Back to top

Q: I am a hobbyist, man I still use WURFL Cloud?

A: ScientiaMobile also offers WURFL Cloud lite, free of charge, to micro-companies, hobbyists and companies that simply want to evaluate the Cloud. Free usage is limited to 3 capabilities and 5,000 device detection’s per month.

Back to top

Q: What will happen if I exceed my number of detection’s limit?

A: The WURFL Cloud Client will throw an exception, such as ScientiaMobile\WurflCloud\ApiKeyException for PHP (and similarly for other languages) if you have exceeded your detection’s. You can use a try {}/catch {} block to keep the exception from bubbling up to your application. Apart from that, the service will keep working for a period that is long enough to assume that you have received notifications that the limit is exceeded and you should upgrade your account. If no action is taken, WURFL Cloud will eventually refuse service until the next billing period.

Back to top

Q: I am trying to detect iPhone models, but I am only getting ‘Apple iPhone’ as a response?

A: This is due to how Apple has chosen to not reveal the device name along with the User Agent string, thus not making it possible to determine the specific model using only the User Agent.

Back to top

Q: I am testing WURFL Cloud with FireFox/Chrome/Opera and plug-in X/Y/Z to spoof the user agent. I always get the same (wrong) results back from the cloud. What am I missing? 

A: You are missing the fact that the WURFL Cloud Client will rely on cookies to store capabilities and avoid extra round-trips to WURFL Cloud for devices that were previously serviced. If you want to use a desktop web browser (or other tool that spoofs the UA string) for testing, you should make sure that cookies are disabled or cleared. This is further explained within the WURFL Cloud getting started guide.

“…By default, the WURFL Cloud uses client-side cookies to cache device information in the browser. As a result you will need to temporarily disable cookies in your desktop web browser to test for different devices. The method to disable cookies varies from browser to browser. Below are instructions for Firefox. For other browsers, please refer to your browsers documentation…”

Back to top


WURFL.js

Q: How do I sign up for WURFL.js?

A: Anyone is able to sign up for WURFL.js here.

Back to top

Q: How can I get more capabilities and/or detections?

A: Your plan can be upgraded or downgraded depending on your traffic. The capabilities are currently a fixed set and are not able to be modified.

Back to top

Q: What counts as a detection?

A: A detection is considered a unique visitor for a website regardless of the number of pages that are visited on that website over a 24-hours period.

Back to top

ImageEngine

Q: What are the differences between ImageEngine and ImageEngineLite?

A: ImageEngineLite is our community offering of our ImageEngine service. Our premium offering of ImageEngine provides more parameters and no bandwidth limitations. More detailed information can be found here.

Back to top

Q:I already have a CDN. Why would I need this?

A: It is very likely that ImageEngine can optimize your images even if you’re using a CDN. You can easily combine ImageEngine and any CDN either by puttin ImageEngine infront of, or behind your CDN.

Back to top

Q: I already have a Content Management System (CMS). Why would I need this?

A: It is very likely that your CMS is not optimizing images at all, which will result in slow web page performance.

Back to top

Q: Can’t I do this today with Responsive Images, Picture and srcset command?

A: The Responsive Images specification still need the different versions (sizes, formats, crops) of the image to exist. For this, you can use ImageEngine. This way, you don’t have to create 5-10 versions of an image. Actually, when in Responsive Images syntax you’ll have to write 10-12 lines with reference to images, you only need one or two references with Image Engine because the built in device detection.

Back to top

Q: Does quality of image suffer?

A: Some times ImageEngine uses lossy compression of images. This may result in a visible quality reduction. Also converting an image between formats, may result in quality reduction. However, even if the file size is significantly reduced, our optimization algorithms are made in such a way that human eye is incapable of spotting any differences between optimized- and original images.

Back to top

Q: How much of a performance improvement can I expect?

A: Depends on a lot of things; How you define and measure performance, how many images you have, what kind of images, what is your mobile browser share and so on. On a general note, you could expect 50-60% reduced image payload, better response times for images and improved page load times because less CPU time is spent on image loading.

Back to top

Q: What are “Client Hints”

A: Client Hints is an emerging standard, spear-headed by Google, which enables the browser to append information about how an image should be displayed, such as size and device pixel ratio. ImageEngine uses this information if it is available. With the addition of WURFL data, ImageEngine has all information needed to produce an optimal result based on how and where a specific image is displayed.

Back to top

Q: Is ImageEngine a CDN?

A: Yes, for all practical purposes it is. ImageEngine runs on several locations, including Amazon. However, ImageEngine can also play together with your existing CDN if you want to keep it. Either in front of- or behind your existing CDN.

Back to top

Q: Does ImageEngine make changes to my images?

A: Yes. In order to optimize the image we need to make changes in size, croping, aspect ratio and compression. You accept that we can do this by using ImageEngine. However, you still own your images, including the derivates, during their lifetime in cache.

Back to top


WURFL InSight

Q: What is WURFL InSight? How is it different than other WURFL products?

A: Most WURFL products work via a WURFL API that interrogates the WURFL Device Description Repository in real time. In contrast, WURFL InSight processes Web logs and produces enhanced logs with WURFL Capabilties appended on.  We call these WURFL logs.  WURFL InSight still uses the User Agent string (found in Web logs) to identify the device. Users can generate insights by using WURFL logs via their Business Intelligence or ETL tools to generate new data sets,  reports, or charts.

Back to top

Q: Are all the capabilities in the WURFL API-driven products available in WURFL InSight?

A: Yes, all of the device capabilities that you can select in our API driven products are also in WURFL Insight. You can refer to the same list of device capabilities here. to learn more.

Back to top

Q: Who usually uses WURFL InSight and how?

A: WURFL InSight is designed for business analysts who want to use the analytics tools they are familiar with, and not deal with the integration of the WURFL API. To effectively use WURFL InSight, these analysts combine web logs that contain user agent strings with WURFL data. There are many business questions that these business analysts might answer about mobile devices visiting their web sites and their capabilities.

Back to top

Q: Do I need to download tables every week? 

A: No, you do not need to download xml files. WURFL InSight will check for and load updated device data every time the license file changes. There is no need to download files from your account vault.

Back to top

Q: Do you offer analytics reporting? Can I just give ScientiaMobile the raw data and you provide reports to me?

A: No, WURFL InSight is a solution that feeds into your existing analytics or Business Intelligence tools.  It is not currently an analytics reporting tool. WURFL InSight is intended to enrich your current web logs. The enriched web logs can be loaded during the Extraction, Transformation, and Load phase of your Business Intelligence (BI) processes. With your current BI tools, you can analyze WURFL data in the context of other data. We offer a flexible tool that handles any web log and can be driven via either a graphical interface (GUI) or integrated into an automated process with a command line interface (CLI).  We offer modules that integrate WURFL logs directly into Business Intelligence and ETL tools. You can learn more about them on the WURFL InSight product page

Back to top

Q: Can I resell the WURFL InSight information as part of a broader analytics product or service?

A: No.

Back to top


WURFL InFuze

Q: Does a C++ API for WURFL exist?

A: Yes. ScientiaMobile offers its own C++ API as part of its WURFL InFuze product. The API implements the same exact logic (and produces the same results) as ScientiaMobile’s other APIs by the same version number.

Back to top

Q: Can I use WURFL device detection through an Apache/NGINX Module?

A: Yes. ScientiaMobile has released modules for both Apache and NGINX. This link has more info. The modules are based on the C++ API.

Back to top

Q: Can I use WURFL device detection through Varnish-Cache?

A: Yes. ScientiaMobile has released modules for Varnish Cache. This link has more info. The module is based on our C++ API.

Back to top

Q: Where can I download the C++ API and/or the NGINX/Varnish/Apache Modules?

A: WURFL InFuze’s C++ API and Modules are not released under a dual license, but exclusively under a commercial license. Paid customers receive access to the downloads via their customer vault. Interested parties can inquire about licensing the usual way.

Back to top

Q: Will I need to build the Varnish/Nginx/Apache Module myself?

A: Probably not. We support a variety of popular Linux distributions. Feel free to contact us if you have special needs.

Back to top

Q: For which Linux distributions are the RPM/DEB packages available?

A: We offer packages built and tested for the following Linux/Unix platforms: Ubuntu, CentOS, RHEL, Fedora, FreeBSD, SmartOS, and Windows.

Back to top

Q: Where do I find installation instructions?

A: The modules installation is following the usual RPM and DEB installation procedure (i.e. rpm -i libwurfl-1.4.2.1.el6_2.centos.x86_64.rpm or dpkg -i libwurfl-1.4.2.1.ubuntu12.04.amd64.deb). Please note that you will need to install all the dependencies in order to successfully install the WURFL InFuze packages.

Back to top

Q: I am trying to detect iPhone models (4, 4s, 5, 5c, etc…), but am only getting ‘Apple iPhone’ as a response?

A: This is due to how Apple has chosen to not reveal the device name along with the User Agent string, thus not making it possible to determine the specific model using only the User Agent. Our WURFL.js Business Edition does successfully identify Apple models. Many customers successfully use both WURFL.js Business Edition and WURFL InFuze.

Back to top

Q: Do the different WURFL InFuze modules count as one single product?

A: No, the modules and C++ API are separated into different product options that are normally sold separately. Companies considering buying more than 1 module should contact us for pricing.

Back to top

Q: How do I check your modules for leaking memory?

A: Instructions for testing our InFuze modules for leaking memory can be found here.

Back to top

Q: What kind of documentation is provided with the packages?

A: Release notes, Changelog and example scripts are provided with each package.

Back to top