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.
Before you begin
Role required: analytics_admin
About this task
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.
Note:
The available detection policy providers are: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.
- 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.Note: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].Note: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.