Description: This plugin enables geolocation features within the platform, allowing you to enrich contact data and create automations based on their geographic location.
What is it for? (Practical examples)
Using the Geolocation module is essential for:
- Audience segmentation: Precisely identifying the geographic location of your contacts (latitude and longitude) based on their registered address.
- Proximity automations: Launching marketing campaigns or specific notifications when a contact is located within or enters a defined radius (e.g., 5 Km) from a physical location or point of interest.
- Data enrichment: Ensuring that every new registered customer automatically has associated geographic coordinates, improving the quality of the database.
Main features
- Automatic geocoding of contacts: Converts the street address (street, city, postal code) of your customers into precise geographic coordinates (latitude and longitude).
- Proximity triggers for Marketing: Allows defining a geographic area (central point and radius in Km) and automatically includes contacts located within that area in marketing campaigns.
- Data synchronization: Periodically updates geographic data of existing customers who have not yet been geolocated.
- Maps integration: Enables the use of Google Maps libraries in other sections of the platform (for example, for map visualization or address autocomplete).
How to configure
To use geolocation features, it is necessary to connect the system to the Google Maps service via an API key.
| Option | Description |
|---|---|
| API Key (Api Key) | Unique key provided by Google to access mapping and geocoding services. |
Configuration steps:
1. Access the Google Maps plugin configuration section.
2. Follow the external guide provided to obtain your Google Maps API Key.
3. Enter the API Key in the designated field and save the settings.
Note: Without a valid API key, no geolocation features (synchronization or marketing triggers) will be active.
Automatic integrations
The plugin works in the background to keep data updated and to interact with Marketing modules.
Automatic contact synchronization
- New registrations: When a new customer registers or is manually added, the system immediately attempts to calculate and save their geographic coordinates.
- Scheduled update: The system periodically (automatically) checks existing customers who do not yet have valid geographic coordinates, trying to complete the missing data.
Location-based Marketing triggers
The plugin adds a new option to the Marketing Automation module, called Customer Geolocation.
This feature allows defining an action (such as sending an email or adding to a list) that triggers when:
1. A contact enters a defined area: A central point (Latitude and Longitude) and a radius in kilometers are specified. The contact is included in the automation if their recorded location falls within this radius.
2. Mass import: It is possible to apply the trigger also to all contacts already present in the database who meet the defined geographic criteria.
