Help Center

What: The Geofencing Listener uses the geolocation of a visitor and their proximity to other geolocations to throw events, which can be used to trigger dialogues or make profile updates. For example, a dialogue can be shown to visitors within a certain radius of a location.

Why: This type of listener is best for location-based use cases. Use this listener to tailor personalized messages to visitors in certain geographical areas. For example, alert visitors of a new store opening or highlight local deals.

Installing BlueConic plugins

Installing the Geofencing Listener plugin to your BlueConic tenant is the first step in using this insight. By default, this plugin is not installed in BlueConic.

To install, navigate to BlueConic settings > Plugins, click the Add plugin button at the top right, and register the external URL below.

https://plugins.blueconic.net/listener_geofencing/index.xml

For more detailed instructions, review the article Overview: What are BlueConic plugins? If you need further assistance, reach out to BlueConic Support.

Configuring the Geofencing Listener

1. Open your Geofencing Listener through the Listeners page in the main navigation menu. Enter a name for your listener to save it for later.
2. In the "Where" section, choose the channels you want this listener to be activated on. Here, you can select all pages on all channels or narrow it down to a limited set of pages and channels.
   
3. Optional: Next to "Use HTML5," check whether you want to enable the use of HTML5 for this listener always or only on mobile. By default, the IP address is used to determine the geolocation of a visitor. Using the HTML5 geolocation API will result in a more precise location. Enabling this option will trigger an alert in the browser asking for permission to access the location of the visitor.
   
4. Next to "Rules," add geolocation rules for your listener. When you click Add geolocation rule, an empty rule will appear for you to configure the following fields:
   • Define event: Create a new event or select an existing event from the dropdown menu. This event will be thrown to all visitors that fall within the configured location radius.
   • Context: This is where you can indicate the additional information you want to collect from the visitor that falls within the radius (i.e., what their device location is or how close they are to the configured location). The context is made of predefined sets of key/value pairs that are passed in an additional event that is thrown by the Geofencing Listener. The name of this additional event is “<configured event name>:context”. You can subscribe to this additional event in a listener and then read from its context to make profile updates. For more information, review this article on using the "eventContext" for defining a value.
     • Example: When you have configured the event “Profile in proximity,” the additional event that is thrown is “Profile in proximity:context”.
   • Define distance: Enter the distance in kilometers or miles that you want the listener to extend from a location.
   • Define geolocation: Enter the location you want to extend the distance radius from. You can do this by entering an address, entering latitude and longitude points, or setting it as your current location.
     
5. Make sure to save your listener and switch the toggle ON when you are ready to activate it.