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.
Note
This specialized listener was created outside the BlueConic product development team and does not come preinstalled in the BlueConic platform. It is not a fully supported BlueConic plugin.
Configuring the Geofencing Listener
- Open your Geofencing Listener in the Listeners tab on the main navigation menu. Enter a name for your listener to save it for later.
- 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.
- Optional: 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.
- Add geolocation rules for your listener. When you click "Add a 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, see 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.
- Make sure to Save your listener and switch the toggle to On when you are ready to activate it.