Back

Define locations for analytics based on IP addresses

NOTE

This customization is only available for self-hosted systems.

One of the Response Tracking Analytics that Blue can provide is the location of the rater based upon their IP address. A list of IP addresses does not hold much value to the average user and is difficult to display on any kind of chart. So, to make the IP address based location data more useful, Blue can group a range of IP addresses together under a single caption which can then be included when Response Tracking Analytics are exported or when they are charted in the Response Rate Monitor.

For example, an organization may use a range of IP addresses for their internal network:

172.85.96.20 - 172.85.96.78

Therefore this range of IP addresses could be assigned the caption:

"Internal" 

To assign a caption to a range of IP addresses, the BlueFillOutAnalyticsDataConfig.config XML file must be edited with this information. Please contact the Explorance Customer Support to make changes to this file.

For example, IP addresses 192.168.0.0 through 192.168.1.0 could be referred to as "Local".

In the XML file it would look like this:

<List>
<StartIP>192.168.0.0</StartIP>
<StartIP>192.168.0.0</StartIP>
<EndIP>192.168.1.0</EndIP>
<LocationName>Local</LocationName>
</List>

Each range of IP addresses should follow the same tag structure and should be placed inside the <FALocations> tag. IP addresses not defined in the config file are labeled Other.

If the range of IP addresses overlap or conflict, the last range that matches the IP address in question is the one that will be selected.

BEST PRACTICE

Make the last entry included in the config file an IP range from 0.0.0.1 - 255.255.255.255 and assign it a custom default caption like this:

<List>  
<StartIP>0.0.0.1</StartIP>  
<StartIP>0.0.0.1</StartIP>  
<EndIP>255.255.255.255</EndIP>  
<LocationName>Unknown</LocationName>  
</List>

Since this covers all possible IP addresses, this caption will always be used, unless the IP falls within another range defined earlier in the file.

IMPORTANT

To map all existing responses to the updated labels for the IP ranges, the following steps must be completed:

  1. For each project using location analytics, navigate to Project Management - Export/Import Responses.
  2. Click Update Location Analytics.
Related Articles

InFillout (FO) task

InSet up the response rate monitor

InSet up the response rate monitor

Back to top

Copyright © 2025

Explorance Inc. All rights reserved.