Setting up Sitecore IP Geolocation

Abstract

Install and activate the Sitecore IP Geolocation service.

The Sitecore IP Geolocation service provides information about the location and owner of an IP address beyond that provided by a reverse DNS lookup. IP Geolocation information includes the country, state, city, and the registered company name of every visitor.

You can use IP Geolocation lookups to create conditional renderings or personalization rules that show different content based on the visitor's location.

The Sitecore IP Geolocation module is fully compatible with Sitecore Experience Manager (CMS-only mode).

  • Sitecore IP Geolocation is included in the initial version of Sitecore Experience Platform 8.1 (Sitecore XP) and all later versions by default, and is tested with all subsequent updates. This means you only need to subscribe to the Sitecore IP Geolocation service.

  • Enable IP Geolocation for your standalone (all-in-one), Content Delivery, and Processing servers.

To activate the Sitecore IP Geolocation Service on Sitecore XP, you must subscribe to the Sitecore IP Geolocation service through the Sitecore Support portal. The Sitecore IP Geolocation service is free of charge and with unlimited lookups per month.

In the \App_Config\Sitecore\Marketing.Tracking\Sitecore.Analytics.Tracking.config file, the Analytics.PerformLookup property must be set to true on every CD instance.

  1. Go to the Sitecore Support & Self-Service Portal, and click Create Service Requests.

    Note

    The number of widgets you see in the portal depends on your permission level.

    CreateServiceRequests.png
  2. Click IP Geolocation Agreement.

    ActivteIPGeoSubscription.png
  3. In the IP Geolocation Agreement dialog, enter your account and contact details.

    IPGeoAgreement.png
  4. To confirm your subscription, accept the Sitecore® IP Geolocation Terms of Service.

    TermsOfService.png

Now your subscription is complete.

Note

After you have activated your subscription, it may take some time for the system to update the license information. When the system has updated, the Sitecore IP Geolocation service will automatically conduct geolocation lookups.

It is common to have a firewall set up between your Content Management and Content Delivery servers. To ensure that the Sitecore IP Geolocation service works correctly in all scenarios, you must configure your firewall settings to allow requests to the service.

Add a firewall rule to allow HTTPS protocol for:

  • geoIp-ces.cloud.sitecore.net

  • Discovery-ces.cloud.sitecore.net

When requests come from a reverse proxy server to your Sitecore instance that you want to track as the valid IP addresses of a client (not as the IP addresses of a proxy), use the following setting.

  • In Sitecore.Analytics.Tracking.config change the Analytics.ForwardedRequestHttpHeader setting to the value: X-Forwarded-For