Define how to detect your user's location

Detect your users' location by selecting and prioritizing a detection policy. You can also define the order in which these policies apply. There are predefined detection policies, but you can create custom scripts to give more flexibility to your definitions.

Avant de commencer

Role required: analytics_admin

Pourquoi et quand exécuter cette tâche

There are four methods by which you can detect a user's location. Prioritize the method by using the Order field and select if the policy should be active or not.

Remarque :

If a detection provider isn't active or a script doesn’t return a response, the system default policy of Explicit Opt-in is implemented.

The available detection policy providers are:

User country

Uses the Country code [country] column stored in the User table [sys_user].

Country Customer script

A custom script that can be loaded onto the ServiceNow Platform to determine the user's location and returns the country's ISO 3166-2 code.

Remarque :

If a customer script is defined but the Active field isn't selected, the next priority in the Order table will be activated.

Policy Customer Script

A custom script that can be loaded onto the ServiceNow Platform to determine the user’s consent policy and return one of the policy names from the Usage Insights Consent Policy table [sys_analytics_detection_policy_provider].

Remarque :

If a customer script is defined but the Active field isn't selected, the next priority in the Order table is activated.

GeoIP

An IP-based detection provider that identifies a user's geographical location using an internal service. This provider is the default option if no detection policies are selected.

Procédure

1. Navigate to All > Platform Analytics Administration > UX Analytics settings > Detection Policy Providers.
   The Usage Insights Detection Policy Providers page displays.
2. Select any of the detection policy providers to update its Active status and change the order in which the policy is enforced.
   Remarque :

   To enforce a policy, it must be active.
3. Facultatif : Select either Country Customer Script or Policy Customer Script and enter a script to determine either the user’s location or the user’s consent policy, and to return a value.
   Remarque :

   You can use the system property glide.analytics.consent.script_timeout to define the run time of the script. For more information, see Usage Insights related properties.
   For more information on using scripts, see JavaScript syntax editor.