Downloads

Property Dictionary

Browse the full list of properties available in 51Degrees device detection solutions. Find out what values are supported in the Lite, Premium and Enterprise data sets, including full descriptions and advice on how they can be used.

Obtain device Id: consists of four components separated by a hyphen
symbol: Hardware-Platform-Browser-IsCrawler where each Component
represents an ID of the corresponding Profile.

match.getDeviceId()

Obtain match method: provides information about the
algorithm that was used to perform detection for a particular User-Agent.
For more information on what each method means please see:
How device detection works

match.getMethod()

Obtain difference: used when detection method is not Exact or None.
This is an integer value and the larger the value the less confident the
detector is in this result.

match.getDifference()

Obtain signature rank: an integer value that indicates how popular
the device is. The lower the rank the more popular the signature.

match.getRank()

This example can be run in any directory, but assumes your
settings file contains a valid dataFile location and has the
IsMobile property selected.

Summary

Match metrics is an additional piece of information about each match result. It can help developers spot fake User-Agents and determine the general level of confidence the detector has in the current detection results.

Device Id is composed of four components, each represented as a number and separated by the hyphen symbol. Numbers correspond to profile IDs the detector has selected for that particular component. The four components are: hardware, software, browser and crawler. For more information please see the 51Degrees Data Model.

The detection method provides information on what algorithm was used for this particular detection and difference indicates by how much the provided User-Agent is different to the best signatures found in the data file. The larger the number the less confident the detector is. Difference for the 'exact' method is always zero. Difference for the 'none' detection method is irrelevant. For more information see the How Device Detection Works page.

Rank value tells you how popular the identified device is. The lower the value the more popular the device. Popularity is derived by 51Degrees based on our observed usage level.

Other uses for match metrics include:

Ranking devices by popularity. Best used in conjunction with other tutorials to rank the results based on the general device popularity.

Storing device Id for analytics instead of individual profiles.

The Lite data file contains 132,765 device combinations, whilst Premium and Enterprise contain 345,682 and 515,728 device combinations respectively. A larger set of device combinations leads to the 'exact' detection method being used more frequently and the rank providing a more accurate value.