Knowledge base

Dynamic Parameters

What are Dynamic Parameters?

As the name implies, Dynamic Parameters are “dynamic,” which is a little different than the rest of the Netbiscuits Device Detection parameters.

Most Device Detection parameters are static, in that they are hard-coded into our device database, retrieved, and sent to matching devices. Dynamic Parameters are an extra set of parameters that can only be determined from within the user’s browser. Bandwidth and Geolocation are two great examples.

These dynamic tests are run in the user’s browser, after Device Detection has downloaded. Therefore, the way to access these parameters is a little different to accessing Static Parameters, and the procedure can be seen below.

How can I use Dynamic Parameters?

  1. First of all, make sure you’ve completed the steps in the How can I use the JavaScript Device Detection? section.
  2. Make sure that you configure all the Dynamic Parameters that you want to use, save, and re-copy and re-paste the JavaScript code block. For additional details about the individual Dynamic Parameters, see the Parameters Detail section below.
  3. Dynamic Parameters are not available until after the client-side tests have completed. Therefore you need to use a callback function within the JavaScript code block.

    Below is an example of a Dynamic Parameter code block that includes Bandwidth and uses a callback function called fill():

    // DD init
    var dd = dd || undefined;
    if (dd !== undefined) {
        dd.dynamic.init({
            // use the dynamic benchmark parameter
            benchmark : true,
            // use a callback function
            callback: fill
        });
    }
    // DD custom callback (optional)
    function fill() {
        var bandwidth = dd.dynamic.result.bwd.bandwidthScore;
        $('#bandwidth').html(bandwidth);
    }
    

Parameter Details

All of the Dynamic Parameters can be configured on the Detection Code page. Please remember that any changes you make must be saved, and the updated code block must be re-copied and re-pasted to your website.

The Dynamic Parameters section includes toggles for each of these parameters, and all are described in detail below.

Bandwidth Detection

Bandwidth Detection Dynamic Parameter option

With Bandwidth Detection enabled, Device Detection will measure the user’s current bandwidth by downloading a small file and tracking the time it takes to do so.

You can choose whether the small file is downloaded from Netbiscuits’ server (which could incur a slight latency between the user’s device and the Netbiscuits server) or from some other server that you designate (which will require you to copy the small file and add it to your server).

Advanced Apple Device Detection

Advanced Apple Device Detection Dynamic Parameter option

With Advanced Apple Device Detection enabled, Device Detection will perform benchmarking tests on any Apple devices in order to determine the exact generation and type of iPhone or iPad with a 97% accuracy.

This advanced testing adds a small amount of extra processing time, but typically no more than 100ms.

Technical information about Apple Device Detection

Netbiscuits Advanced Apple Device Detection has three tiers: Level 1, 2 and 3. If Advanced Apple Device Detection is turned off, Level 1 will be used. If it is turned on, the micro-benchmarking will be used, which is Level 3. For information on activating Level 2 (which is Level 1 with additional information from the display dimensions of the device) see the Level 2 heading, below.

Level 1 – User Agent

Level 1 Apple Detection is used if you set Advance Apple Device Detection to off. If you are using Level 1 Apple Detection, the information provided is taken directly from the User Agent String. The categories here are broad and some precision is lost. Listed below are the category groupings for Level 1 detections.

  • iPhone 1, 3G, 3GS (iOS 1, 2 3)
  • iPhone 3G, 3GS, 4 (iOS 4)
  • iPhone 3GS, 4, 4S (iOS 5)
  • iPhone 3GS, 4 , 4S, (iOS 6)
  • iPhone 4, 4S, 5, 5C, 5S (iOS 7)
  • iPhone 4S, 5, 5C, 5S, 6, 6 Plus (iOS 8)

These identifications are based solely on the iOS versions of the device, and thus, every possible device that could have that iOS installed is in each category.

Level 2 – User Agent + Device Dimensions

To narrow down the device a little, while still not performing a full micro-benchmarking on the device, Level 2 uses the information gathered from the User Agent and adds the dynamic parameter Device Dimensions to get a more accurate reading on the possible Apple devices. Listed below are the category groupings for Level 2 detections.

  • iPhone 1, 3G, 3GS
  • iPhone 4, 4S
  • iPhone 5, 5C, 5S
  • iPhone 6
  • iPhone 6 Plus

As you can see, cross referencing the iPhone dimensions with the iOS vastly increases the accuracy of the detection.

Level 3 – Micro Benchmarking

If complete accuracy is required in your iPhone detection, Level 3 may be what you require. It uses micro benchmarking to accurately determine the device name of all accessing iPhones. Listed below are the category groupings for the Level 3 detections.

  • iPhone 1, 3G, 3GS
  • iPhone 4
  • iPhone 4S
  • iPhone 5, 5C
  • iPhone 5S
  • iPhone 6
  • iPhone 6 Plus

Note: The iPhone 5 and 5C are technically identical in terms of hardware and so cannot be told apart.

Cookie Detection Dynamic Parameter option
With Cookie Detection enabled, Device Detection can determine whether JavaScript cookies can be set on the user’s device.

This includes not only devices that are not physically capable, but also devices where privacy-conscious users may have deactivated cookies.

Geolocation Detection

Geolocation Dynamic Parameter option

With Geolocation Detection enabled, Device Detection will attempt to determine the user’s geolocation, first by trying to use the device’s GPS, and falling back to JavaScript alternatives if necessary.

Profiles

Parameter Profile Dynamic Parameter option

A Profile is a custom collection of parameters (meaning, not the default collection, which includes all the parameters). If you have a custom profile created, you can select it from the dropdown in this option.

Learn more about Profiles!

YouTube aktivieren?

Auf dieser Seite gibt es mind. ein YouTube Video. Cookies für diese Website wurden abgelehnt. Dadurch können keine YouTube Videos mehr angezeigt werden, weil YouTube ohne Cookies und Tracking Mechanismen nicht funktioniert. Willst du YouTube dennoch freischalten?