Quick start

  • Basically Devizer operates in three simple steps:
  • 1. Customer device Black box data is automatically collected on your web application.
  • 2. Black box data is automatically sent to Devizer platform.
  • 3. You make a REST API request and get data with Devizer score.
  • Follow these simple steps to have integrate Devizer within a few minutes.

Step 1

Description

BlackBox data is collected with Devizer script automatically for every visitor.

Each collected BlackBox Has Its Own unique identifier (VisitorID).

Integration

You need to install the JavaScript agent. The agent is required to send requests to our identification backend.

The JavaScript is a high-performance agent that collects multiple device and browser signals and sends them to the our Fingerprint API for processing, JavaScript for installation on your WEB site is:

copied

<script type="text/javascript">
    var Devizer = {
        waitMilliSecondsToBulkSendProperties: 5000,
        onPropertiesUpdate: function(properties, propertiesAsString) {
            var req = new XMLHttpRequest();
            req.onreadystatechange = function() {
                if (req.readyState == XMLHttpRequest.DONE) {
                    if (req.status === 200) {
                        let data = {};
                        try {
                            data = JSON.parse(req.response);
                        } catch (e) {
                            console.error('Failed to get visitor_id');
                            return;
                        }
                        window.localStorage.setItem('userExternalDeviceId', data.visitor_id);
                    }
                }
            }            
            req.open('GET', 'https://product.devizer.pro', true);
            req.setRequestHeader('DAPROPS', propertiesAsString);
            req.send(null);
        }
    }
</script>
<script type="text/javascript" src="https://product.devizer.pro/clientSide.js?t=3" async></script>

Hint

In some cases the creation of the Black Box may occur when not all device data has been collected.

Place the Devizer js code and js library connection at the end of the body tag to avoid such situation.

Step 2

Description

BlackBox information is automatically sent to our service for each visitor.
So you shouldn't be worry about that, just save VisitorID in order to make future requests.

By default, the VisitorID variable is stored in localStorage.
You can manage it by by editing the following part of the code:

    }
    window.localStorage.setItem('userExternalDeviceId', data.visitor_id);
}

Step 3

Enrichment and Scoring

We enrich data with available device properties and apply our sophisticated ML models in order to provide you with the most accurate assessment of the device.

Integration

You need to make POST request to our REST API For Getting Results with device score assessment.

Request HTTP Endpoint:

POST https://api.devizer.pro/getter

Request body

Request body must include json with following data:

Json keys domain_name * visitor_id **
Type str str
Required yes yes

* domain_name - the name of the domain on which the Java script is located (you need to agree with the Devizer support service)

** visitor_id - VisitorID which is stored on Step 2 (you should save it to your database as soon as it's value becomes available).

Request body example:

{                     
    "domain_name": "your-domain-name",
    "visitor_id": "643045452729eb8cfcb38327",   
}

Response Description

The endpoint returns JSON structured response.

JSON Attributes General Features: visitor_id error device_type device_score Mobile_features: manufacturer model_external model_internal os_name browser_name browser_version PC_features: video_adapter monitor_size os_name os_version browser_name browser_version
Type str str str str str str str str str str str str str str str str
Description Unique visitor ID Internal error Device type Device based client score Device manufacturer Device brand model Device internal manufacturer model Device operating system name Device browser name Device browser version Device video adapter manufacturer Device monitor size Device operating system name Device operating system version Device browser name Device browser version
copied
    
    {
        "visitor_id": "643190512729eb8cfcb38329",
        "error": null,
        "device_type": "Mobile Phone",
        "device_score": "A",
        "mobile_features": {
            "manufacturer": "Xiaomi",
            "model_external": "Note 8 Pro",
            "model_internal": "SM-A015F",
            "os_name": "Android",
            "os_version": "11",
            "browser_name": "Chrome",
            "browser_version": "111.0.0.0"
            },
        "pc_features": {
            "video_adapter": null,
            "monitor_size": null,
            "os_name": null,
            "os_version": null,
            "browser_name": null,
            "browser_version": null
        }
    }    

Results interpretation

Devizer is designed to give your full understanding behind every score

Customer evaluation:

- score with rate "A" indicates high overall assessment of the device (including high solvency of the client)

- score with rate "E" indicates low overall assessment of the device (including low solvency of the client)

Standard thresholds for each state are:

State Very high solvency of the client High solvency of the client Middle solvency of the client Low solvency of the client Very low solvency of the client
Trashold A B C D E