This example shows how to access the 'match metrics' assocaited with a result from 51Degrees device detection. Match metrics are various properties that indicate the level of confidence that the supplied evidence corresponds to the result that has been returned.

1 # *********************************************************************

2 # This Original Work is copyright of 51 Degrees Mobile Experts Limited.

4 # Caversham, Reading, Berkshire, United Kingdom RG4 7BY.

5 #

6 # This Original Work is licensed under the European Union Public Licence (EUPL)

7 # v.1.2 and is subject to its terms as set out below.

8 #

9 # If a copy of the EUPL was not distributed with this file, You can obtain

10 # one at https://opensource.org/licenses/EUPL-1.2.

11 #

12 # The 'Compatible Licences' set out in the Appendix to the EUPL (as may be

13 # amended by the European Commission) shall be deemed incompatible for

14 # the purposes of the Work and the provisions of the compatibility

15 # clause in Article 5 of the EUPL shall not apply.

16 #

17 # If using the Work as, or as part of, a network application, by

18 # including the attribution notice(s) required under Article 5 of the EUPL

19 # in the end user terms of the application under an appropriate heading,

20 # such notice(s) shall fulfill the requirements of that article.

21 # ********************************************************************

22

23

28

29 from fiftyone_devicedetection_onpremise.devicedetection_onpremise_pipelinebuilder import DeviceDetectionOnPremisePipelineBuilder

30 from fiftyone_devicedetection_examples.example_utils import ExampleUtils

31

32 # First create the device detection pipeline with the desired settings.

33

34 data_file = ExampleUtils.find_file("51Degrees-LiteV4.1.hash")

35

36 pipeline = DeviceDetectionOnPremisePipelineBuilder(

37 data_file_path = data_file,

38 licence_keys = "",

39 performance_profile = 'MaxPerformance',

40 auto_update=False).build()

41

42 # Now we can take a User-Agent and run it through this pipeline

43

44 # First we create a FlowData object from the pipeline

45 flowdata = pipeline.create_flowdata()

46

47 # Then we add the User-Agent we are interested in as evidence

48 iphone_ua = "Mozilla/5.0 (iPhone; CPU iPhone OS 11_2 like Mac OS X) AppleWebKit/604.4.7 (KHTML, like Gecko) Mobile/15C114"

49

50 flowdata.evidence.add("header.user-agent", iphone_ua)

51

52 # Now we process the FlowData using the engines in the Pipeline

53

54 flowdata.process()

55

56 # The device detection engine comes with additional metadata about each match

57

58 if flowdata.device.deviceid.has_value():

59 print('Device ID: ' + str(flowdata.device.deviceID.value()))

60 print("""

61 Consists of four components separated by a hyphen symbol:

62 Hardware-Platform-Browser-IsCrawler where each Component

63 represents an ID of the corresponding Profile.""")

64

65 if flowdata.device.useragents.has_value():

66 print('Matched useragents: ' + str(flowdata.device.useragents.value()))

67 print("The matched useragents")

68

69 if flowdata.device.difference.has_value():

70 print('Difference: ' + str(flowdata.device.difference.value()))

71 print("""

72 Used when detection method is not Exact or None.

73 This is an integer value and the larger the value

74 the less confident the detector is in this result.""")

75

76 if flowdata.device.method.has_value():

77 print('Method: ' + str(flowdata.device.method.value()))

78 print("""Provides information about the algorithm that was used to perform detection for a particular User-Agent.""")

51Degrees Device Detection Python 4.3Newer Version 4.4

onpremise/match_metrics.py