Jump to: navigation, search

GeoIP Information

Turning on Geolocation

Web Engagement Server 8.5 can collect information about a visitor's IP address, as well as converting this information into the visitor's geolocation coordinates. This capability is turned off by default.

To convert IP addresses into geolocation coordinates, Web Engagement Server uses a library and a GeoDB file (GeoLite2-City.mmdb) provided by MaxMind.

Web Engagement installs GeoLite2-City.mmdb automatically into Web Engagement installation dir\apps\your application\resources\geo. However, you may need to upgrade it to the most recent version. To do that, follow these steps:

  1. Download the GeoLite2-City.mmdb file from MaxMind.
  2. Place the downloaded file into Web Engagement installation dir\apps\your application\resources\geo.
  3. Deploy your application.

Before you start your Web Engagement Server, make sure that the following options from the [privacy] section have the appropriate values:

  • collectActualIPs = true
  • collectForwardedIPs = true
  • geoMode = COUNTRY, CITY, or LOCATION

Verifying Geolocation Coordinates

There are two ways to determine whether your geolocation coordinates are being calculated properly:

  • Use the Advanced Reporting Dashboard and view the results in the map widget
  • Inspect the Cassandra database and find one or more VisitStarted events

If the transformation is working, the data object of your VisitStarted events will contain one of the following fields, depending on the value of the geoMode option: location, city, or countryCode.

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on August 5, 2016, at 16:16.