This guide explains how to use the Geographic tool to create audiences based on users' physical locations. You can build segments by defining geographic areas and specifying how recently users must have visited those locations.
The tool allows you to add locations in three ways. You can use a single method or combine all of them to build your audience:
Search for Points of Interest (POIs) or specific addresses.
Upload a CSV file with a list of addresses or latitude/longitude coordinates.
Draw manual pins directly on the map.
Creating a Geolocation Audience in 3 Steps
Building a geo-audience follows a straightforward, three-step process.
Step 1: Initial Audience Setup
First, you will configure the basic details for your audience.
From the main navigation, select the option to create a Geographic audience.
On the setup screen, provide the following:
Audience Name: A descriptive name for your segment (e.g., "Buenos Aires Bank Visitors - Last 3 Months").
Country: The country where your audience is located.
Click "Continue" to proceed to the map interface.
Supported countries
The Geolocation tool currently supports audience creation in the following countries:
AR: Argentina
BO: Bolivia
BR: Brasil
BZ: Belice
CL: Chile
CO: Colombia
CR: Costa Rica
EC: Ecuador
GT: Guatemala
GY: Guayana
HN: Honduras
MX: México
NI: Nicaragua
PA: Panamá
PE: Perú
PY: Paraguay
SR: Surinam
SV: El Salvador
UY: Uruguay
VE: Venezuela
Step 2: Adding Locations to Your Map
Next, you will define the geographic areas for your audience. The map interface includes a search bar and a list on the left where your chosen locations will be collected.
The search bar allows you to find specific Points of Interest (POIs), lat/long points or individual street addresses.
To find Points of Interest (POIs):
Type a category and location into the search bar. For example: "banks in buenos aires"
A list of matching locations will appear. You can scroll down to load more results if available.
You can either select locations individually from the list or click "Select All" to add all loaded results to your map.
Each selected POI is added with a default radius of 100 meters, which can be edited individually in the location list.
To add a list of points:
This method is for adding a large number of locations from a pre-existing list. Both address-based and coordinate-based formats are supported.
Click the bulk upload icon (⬆️) located next to the search bar.
Prepare a CSV file according to one of the formats below. You will find templates you can download and fill using Microsoft Excel or Google Sheets at the end of this article.
Upload your file. After processing, the system will provide a count of successfully and unsuccessfully mapped points.
File Format 1: Addresses
This format requires a CSV file with two columns.
Header: address
Radius: A radius size in meters that can range between 100 and 5000.
Example
address, radius
"Av. Corrientes 900, Buenos Aires, Argentina", 500
"Cnel. Niceto Vega 4601, Buenos Aires, Argentina", 600
File Format 2: Latitude & Longitude
This format requires a CSV file with three specific columns.
Headers (in order): latitude, longitude, radius
Formatting Notes:
Coordinates must use a period (.) as the decimal separator and be expressed in decimal degrees.
The radius value must be in meters.
latitude,longitude,radius
-34.6037,-58.3816,500
-33.4176,-70.6012,1000
To create a pin manually
Use this method to target custom areas or locations that cannot be found via search.
Click anywhere on the map
Select the radius width on the locations bar.
Other use cases of the search bar:
Type a specific street address into the search bar.
Navigate to another city or neighborhood
Find a specific latitude/longitude using decimal degrees.
For example, "4.683, -74.045"
We don't support other coordinate systems
Step 3: Setting Timeframe Rules
The final step is to define how recently a user must have visited your defined locations.
Locate the Timeframe Rules dropdown at the bottom of the location list.
Select one of the following options:
Last 1 Month
Last 3 Months
Last 6 Months
Last 12 Months
After setting your timeframe rules, click the "Create " button. The new geolocation segment will be generated and will appear in your "Segments" table, where it can be activated on your desired external platforms.
Key considerations and limitations of geographic audiences
TTLs and static timeframe rules
Bear in mind that geo audiences don't refresh automatically. They are built using strictly the last X months that you select counted from the day you create it.
Geographical audiences have a time-to-live (TTL) of 180 days, which means that if not used, it will stop showing volume after that date.
Maximum and minimum radius
The minimum radius is 100m (0.1km) and the maximum is 5km. If any point is created outside those boundaries, we will set the radius of that point to the lower or higher value permitted.
Minimum and maximum points via bulk upload
You can upload from one (1) point up to 2,000.