New data available
Refresh your browser to view the updates.
Upgrade to Unlock Map
Map Your Customers and Locations
Create segment heatmaps layered on your locations and customer data to spot opportunities fast.
Thanks! Your request has been received.
Ok
Oops! Something went wrong while submitting the form.
Upgrade to Unlock Analyze
Discover Your Top Segments In Seconds
Create segmentation reports from your customer data, mobile data, or locations.
Thanks! Your request has been received.
Ok
Oops! Something went wrong while submitting the form.
Upgrade to Unlock Activate
Build Custom Ad Audiences
Export your top PersonaLive segments across Meta, TikTok, Google, and more.
Thanks! Your request has been received.
Ok
Oops! Something went wrong while submitting the form.
Upgrade to Unlock Spend
Analyze Consumer Spend Patterns
Grow market share with insights from 100M+ credit card transactions.
Thanks! Your request has been received.
Ok
Oops! Something went wrong while submitting the form.
New Customer List
Upload Successful
Our system is processing your file.
Done
Buy Mobile Credits
New Credits Added
Thank you for your purchase. Your mobile credits are now available.
Done
New Locations
Upload Successful
Your locations are being processed and may take a few minutes to appear. You can leave this page while you wait or refresh to populate the data.
Done
Delete Record
Are you sure you want to remove this record?
CancelDelete permanently
Oops! Something went wrong while submitting the form.
New Segmentation Report
Upload Error
Our system ran into an issue while processing your report. Our team has been notified and is investigating the issue.
Ok
Set Selection
Set A
Select locations for Set A. Locations can appear in multiple sets.
Note: Choosing both radius-based and mobile-based locations in the same report may produce non-comparable results.
Radius Rings
Mobile Data
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Address
Source
Loading...
100
CancelConfirm
Site Attributes

Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value

Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value
Key: Value

Analyze

Locations
Customers
Watch Tutorials
Add Location
My Locations
Single
Compare
Radius Rings
Mobile Data
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Address
Source
Loading...
100
No results found
Start by adding a location or customer list
All of your locations and customer files will live here.
Start analyzing by adding a location or customer list.
Set A
4 locations
Loading...
No locations are selected for this set
Select Locations
Set B
4 locations
Loading...
No locations are selected for this set
Select Locations
Analyze
Segmentation
Columns
Analysis Metric
Loading...
Y-Axis
Loading...
Market Base
National
Match Type
Loading...
Radius
1 mi
View By
Loading...
Analysis Metric
Loading...
Market Base
National
Match Type
Loading...
Radius
1 mi
Set A
Set B
Group
Segment
Low Base Sizes Hidden
Percent
Base
Index
Raw Visits
Fetching data... Larger selections may take longer.
Loading...
00.00%
00.00%
000.0
00,000,000
No record selected
To view segmentation results, select a location or customer file on the left, then click Analyze.
No data to display
Try adjusting your filters to find what your looking for.
Includes mixed sources
MapActivate
New Customer List
File Formatting Guidelines
Please follow the formatting guidelines below to ensure a successful upload.
File Format
CSV Only
Required Fields
Customer ID and at least one (1) matching variable
Column Names
Match column names to the parameter names below (e.g. Address). Custom metrics (e.g. Spend) can have any name.
Matching Variables
Include as many clean matching variables as you can for a better match rate.
File Guidelines
Example File 1
Example File 2
Example File 3
Parameter
Description
Variable Type
Examples
Customer ID
A customer number (unique identifier) for matching back records after PII is removed. This field is required.
ID
871Y781983
1
Address
Full address including line 1 (street info), line 2 (apt #), city, state, and postal (zip) code.  Skip this if the components are split across columns.
Matching Variable
13924 S SPRINGS DR, CLIFTON, VA, 20124
1008 Race Street, Cincinnati, OH, 45202
Address Line 1
Primary address line. Include the street number and name. Skip if you are using the 'Address' field (full address in one column).
Matching Variable
1008 Race St
13924 S SPRINGS DR
Address Line 2
Secondary address line (if any). Skip if you are using the 'Address' field (full address in one column).
Matching Variable
Apt A
2E
319
City
Include full city name (no abbreviations). Skip if you are using the 'Address' field (full address in one column).
Matching Variable
Cincinnati
Miami
State
Abbreviated state letters or full state names allowed. Skip if you are using the 'Address' field (full address in one column).
Matching Variable
OH
Florida
Zip
5-digit code. Including the 4-digit extension may improve your match rate.  Skip if you are using the 'Address' field (full address in one column).
Matching Variable
45202
94303-5300
Full Name
Combined first and last name. Don't include prefixes (e.g. Mrs.) or suffixes (e.g. Jr.). Accents are allowed.
Matching Variable
John Smith
ZOE DOE
Lucia Gonzales
First Name
Don’t include prefixes (e.g. Mrs.). Accents are allowed.
Matching Variable
John
ZOE
Lucia
Last Name
Don’t include suffixes (e.g. Jr.). Accents are allowed.
Matching Variable
Smith
smith-jones
Pèrez
Email
Include a domain name (e.g. gmail.com). Remove spaces between the email address.
Matching Variable
example@email.com
john@gmail.com
Hashed Email
Emails should be converted to all lower case and then hashed with SHA-256.
Matching Variable
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Spend
Total amount spent by the customer. This is an example of a custom (amount) metric. It could be anything relevant to your business (total spent, order count, lifetime value, etc). This is not required.
Custom Metric
100.67
23
Subscriber
Indicates the customer is a subscriber. This is an example of a custom (category) metric. It could be anything relevant to your business (subscriber or not, customer type, etc). This is not required.
Custom Metric
Y
N
Freemium
Blockgroup
Census Block Group ID. This should be a 12 digit number.
Matching Variable
060371011101
170318426003
Latitude
Approximate latitude of an individuals residence. Must also include longitude.
Matching Variable
39.10955
Longitude
Approximate longitude of an individuals residence. Must also include latitude.
Matching Variable
-84.51767
clat
'Central Latitude'. Use 'clat' and 'clng' columns to search for individuals by first and last name within a specific radius around a known location. This is helpful when you have a customer's name but only an approximate location, like the vicinity of a coffee shop.
Matching Variable
39.10955
clng
'Central Longitude'. Use 'clat' and 'clng' columns to search for individuals by first and last name within a specific radius around a known location. This is helpful when you have a customer's name but only an approximate location, like the vicinity of a coffee shop.
Matching Variable
-84.51767
This is one example of a well formatted file; yours doesn't have to exactly match it. This example data file includes a Customer ID as well as First Name ,Last Name, Address, and Email for matching. It also includes two custom metrics: Spend and Subscriber.
Customer ID
First Name
Last Name
Email
Address Line 1
Address Line 2
City
State
Zip
Spend
Subscriber
1
John
Smith
john@gmail.com
1008 Race St
 
Cincinnati
OH
45202
100.67
Y
2
Zoe
Smith
zoe@gmail.com
1420 Main St
2E
Cincinnati
OH
45202
59.36
N
3
Allen
Jones
allen@gmail.com
990 W Bluegrass Ave
 
Louisville
KY
40215
12.99
N
4
Lisa
Gonzalez
lisa@gmail.cin
127 Rose St SW
 
Grand Rapids
MI
49507
77.93
Y
This is one example of a well formatted file; yours doesn't have to exactly match it. This example data file includes a Customer ID as well as First Name, Last Name, Email, Zip, Latitude, and Longitude. It also includes one custom metric: Customer Type. Providing the zip code allows us to look for individuals with the given name in the zip code. The lat, lng coordinates allow us to get more specific (at a household or census block group level).
Customer ID
First Name
Last Name
Email
Zip
Latitude
Longitude
Customer Type
1
John
Smith
john@gmail.com
45202
40.7128
74.006
Trial
2
Zoe
Smith
zoe@gmail.com
45202
34.0522
118.2437
Premium
3
Allen
Jones
allen@gmail.com
40215
41.8781
87.6298
Premium+
4
Lisa
Gonzalez
lisa@gmail.cin
49507
25.7617
80.1918
Trial
This is one example of a well formatted file; yours doesn't have to exactly match it. This example data file includes a Customer ID and an Email for matching. It also includes one custom metric: Average Order Total. We can only match this file using 1-to-1 email matches. Always include as many matching variables as you can, but this is an example where the only customer data you have available is email.
Customer ID
Email
Average Order Total
1
john@gmail.com
100.67
2
zoe@gmail.com
59.36
3
allen@gmail.com
12.99
4
lisa@gmail.cin
77.93
File Upload
Important: You are uploading data to Spatial.ai’s secure matching environment. PII is encrypted and deleted immediately upon matching. You may download your customer file consisting of Customer IDs and segment match levels with PII removed in the table on the Append page.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Match Column Names
We've matched 4 columns from your customer list. Please check if they're correct.
Address Line 1
City
State
Zip
Column
Preview
Guidelines
Example
Do Not Upload
customer_key
123 Main St
456 Cherry St
9 Apple Tree Ln
...
 
 
Do Not Upload
average_spend
1.69
5.88
3.71
...
 
 
Do Not Upload
fname
Jimmy
Jack
Lyden
...
 
 
Address Line 1
address_1
123 Main St
456 Cherry St
9 Apple Tree Ln
...
Include street number and name.
1008 Race Street
13924 S SPRINGS DR
City
city
Cincinnati
Louisville
Indianapolis
...
Include full city name.
Cincinnati
Louisville
State
state
OH
PA
MD
...
Abbreviated state letters or full state name allowed.
OH
Alabama
Zip
zip
45202
20124
94303-5300
...
5-digit codes are allowed. Including the 4-digit extension may improve your match rate.
45202
94303-5300
Column
Preview
Guidelines
Example
Action Needed (3)
Do Not Upload
customer_key
123 Main St
456 Cherry St
9 Apple Tree Ln
...
 
 
Do Not Upload
average_spend
1.69
5.88
3.71
...
 
 
Do Not Upload
fname
Jimmy
Jack
Lyden
...
 
 
Mapped (4)
Address Line 1
address_1
123 Main St
456 Cherry St
9 Apple Tree Ln
...
Include street number and name.
1008 Race Street
13924 S SPRINGS DR
City
city
Cincinnati
Louisville
Indianapolis
...
Include full city name.
Cincinnati
Louisville
State
state
OH
PA
MD
...
Abbreviated state letters of full  state name allowed.
OH
Alabama
Zip
zip
45202
20124
94303-5300
...
5-digit codes are allowed. Including the 4-digit extension may improve your match rate.
45202
94303-5300
Mapped (4)
Action needed (3)
Column
Preview
Guidelines
Example
Address Line 1
address_1
123 Main St
456 Cherry St
9 Apple Tree Ln
...
Include street number and name.
1008 Race Street
13924 S SPRINGS DR
City
city
Cincinnati
Louisville
Indianapolis
...
Include full city name.
Cincinnati
Louisville
State
state
OH
PA
MD
...
Abbreviated state letters of full  state name allowed.
OH
Alabama
Zip
zip
45202
20124
94303-5300
...
5-digit codes are allowed. Including the 4-digit extension may improve your match rate.
45202
94303-5300
Column
Preview
Do Not Upload
fname
Jimmy
Jack
Lyden
...
Do Not Upload
lname
Chase
Schroder
Foust
...
Do Not Upload
customer_key
2938476
0037456
3966532
...
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Specify Market Base
Choosing a proper market base helps identify which segments your customer base over-indexes on relative to the nearby general population.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Would you like to map this customer data?
If so, Spatial.ai will retain the latitude and longitude of your customers jittered up to 25 meters.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Confirm Details
Customer List
Name
my-customer-list.csv
Size
2.5MB
Mapped Columns
Total Spend
Churn
None
Market Base
National
OH, KY, IN
BackNextSubmit
New Location
*
*
*
*
Use this field to give this location a unique name. If left blank, only the address will be shown.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Brand
Use this field to associate a brand with this location. If the brand isn’t listed, enter the brand name or a custom label (e.g., “Prospective Locations”).
Select one...
Group
Use this field to group your locations.This could be a brand name or location type (e.g. Prospective Locations).
Unlabeled
BackNextAdd Location
New Brand Locations
Select a brand to add every location currently in our records for it.
Brand
Select one...
Geography
National
BackAdd Locations
New Location List
File Formatting Guidelines
Please follow the formatting guidelines below to ensure a successful upload.
File Format
CSV, TSV
Required Fields
Address or all of the following in separate columns: Address Line 1 Address Line 2 City State ZIP
Column Names
Match column names to the parameter names below (e.g. Address).
Matching Variables
Include as many clean matching variables as you can for a better match rate.
File Guidelines
Example File
Parameter
Description
Variable Type
Examples
Brand
The brand name associated with this location.
Custom Field
Lululemon
Group
The display name used to organize your locations. If not included, Brand will be used by default.
Custom Field
Lululemon, Prospective Sites
Address
Full address including line 1 (street info), line 2 (apt #), city, state, and postal (zip) code.  Skip this if the components are split across columns.
Matching Variable
13924 S SPRINGS DR, CLIFTON, VA, 20124
1008 Race Street, Cincinnati, OH, 45202
Address Line 1
Primary address line. Include the street number and name. Skip if you are using the 'Address' field (full address in one column).
Matching Variable
1008 Race St
13924 S SPRINGS DR
Address Line 2
Secondary address line (if any). Skip if you are using the 'Address' field (full address in one column).
Matching Variable
Apt A
2E
319
City
Include full city name (no abbreviations). Skip if you are using the 'Address' field (full address in one column).
Matching Variable
Cincinnati
Miami
State
Abbreviated state letters or full state names allowed. Skip if you are using the 'Address' field (full address in one column).
Matching Variable
OH
Florida
Zip
5-digit code. Including the 4-digit extension may improve your match rate.  Skip if you are using the 'Address' field (full address in one column).
Matching Variable
45202
94303-5300
This is one example of a well formatted file; yours doesn't have to exactly match it. This example data file includes a Site ID and all required Address fields. It also includes two custom metrics: Sales and Drive thru. Note that blank Address Line 2 fields are fine and will not disrupt file processing.
Brand
Address Line 1
Address Line 2
City
State
Zip
Sales
Drive Thru
Lululemon
9506 Nowell Drive
 
Bethesda
MD
20817
4,000,000
Y
Lululemon
6 N Bridge Place
 
Mount Kisco
NY
10549
3,000,000
Y
Lululemon
6215 Avenida Cresta
 
la jolla
CA
92037
2,000,000
Y
Lululemon
279 W KEY PALM RD
 
BOCA RATON
FL
33432
1,000,000
N
Lululemon
1382 Stable Bend Lane
 
Winston Salem
NC
27106
500,000
N
...
...
 
...
...
...
...
...
This is one example of a well formatted file; yours doesn't have to exactly match it. This example data file includes a Customer ID as well as First Name, Last Name, Email, Zip, Latitude, and Longitude. It also includes one custom metric: Customer Type. Providing the zip code allows us to look for individuals with the given name in the zip code. The lat, lng coordinates allow us to get more specific (at a household or census block group level).
Customer ID
First Name
Last Name
Email
Zip
Latitude
Longitude
Customer Type
1
John
Smith
john@gmail.com
45202
40.7128
74.006
Trial
2
Zoe
Smith
zoe@gmail.com
45202
34.0522
118.2437
Premium
3
Allen
Jones
allen@gmail.com
40215
41.8781
87.6298
Premium+
4
Lisa
Gonzalez
lisa@gmail.cin
49507
25.7617
80.1918
Trial
This is one example of a well formatted file; yours doesn't have to exactly match it. This example data file includes a Customer ID and an Email for matching. It also includes one custom metric: Average Order Total. We can only match this file using 1-to-1 email matches. Always include as many matching variables as you can, but this is an example where the only customer data you have available is email.
Customer ID
Email
Average Order Total
1
john@gmail.com
100.67
2
zoe@gmail.com
59.36
3
allen@gmail.com
12.99
4
lisa@gmail.cin
77.93
File Upload
Drag and drop CSV or
choose file
Incorrect file type. Please upload a CSV file.
file-name.csv
75.1 MB
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Match Column Names
We've matched 4 columns from your list. Please check if they're correct.
Address Line 1
City
State
Zip
Column
Preview
Guidelines
Example
Do Not Upload
customer_key
123 Main St
456 Cherry St
9 Apple Tree Ln
...
 
 
Do Not Upload
average_spend
1.69
5.88
3.71
...
 
 
Do Not Upload
fname
Jimmy
Jack
Lyden
...
 
 
Address Line 1
address_1
123 Main St
456 Cherry St
9 Apple Tree Ln
...
Include street number and name.
1008 Race Street
13924 S SPRINGS DR
City
city
Cincinnati
Louisville
Indianapolis
...
Include full city name.
Cincinnati
Louisville
State
state
OH
PA
MD
...
Abbreviated state letters or full state name allowed.
OH
Alabama
Zip
zip
45202
20124
94303-5300
...
5-digit codes are allowed. Including the 4-digit extension may improve your match rate.
45202
94303-5300
Column
Preview
Guidelines
Example
Action Needed (3)
Do Not Upload
customer_key
123 Main St
456 Cherry St
9 Apple Tree Ln
...
 
 
Do Not Upload
average_spend
1.69
5.88
3.71
...
 
 
Do Not Upload
fname
Jimmy
Jack
Lyden
...
 
 
Mapped (4)
Address Line 1
address_1
123 Main St
456 Cherry St
9 Apple Tree Ln
...
Include street number and name.
1008 Race Street
13924 S SPRINGS DR
City
city
Cincinnati
Louisville
Indianapolis
...
Include full city name.
Cincinnati
Louisville
State
state
OH
PA
MD
...
Abbreviated state letters of full  state name allowed.
OH
Alabama
Zip
zip
45202
20124
94303-5300
...
5-digit codes are allowed. Including the 4-digit extension may improve your match rate.
45202
94303-5300
Mapped (4)
Action needed (3)
Column
Preview
Guidelines
Example
Address Line 1
address_1
123 Main St
456 Cherry St
9 Apple Tree Ln
...
Include street number and name.
1008 Race Street
13924 S SPRINGS DR
City
city
Cincinnati
Louisville
Indianapolis
...
Include full city name.
Cincinnati
Louisville
State
state
OH
PA
MD
...
Abbreviated state letters of full  state name allowed.
OH
Alabama
Zip
zip
45202
20124
94303-5300
...
5-digit codes are allowed. Including the 4-digit extension may improve your match rate.
45202
94303-5300
Column
Preview
Do Not Upload
fname
Jimmy
Jack
Lyden
...
Do Not Upload
lname
Chase
Schroder
Foust
...
Do Not Upload
customer_key
2938476
0037456
3966532
...
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Confirm Details
Location List
Name
my-location-list.csv
Size
2.5MB
Location Count
150
Radii
1, 3, 5 (default)
Mapped Columns
Total Spend
Churn
None
BackNextSubmit
New Mobile Report
File Formatting Guidelines
Please follow the file format guidelines specific to your mobile data provider to ensure a successful upload.
Important: Mobile data files must be uploaded in CSV or TSV format (they can be zipped). 'Census Block Group ID' or 'Latitude' and 'Longitude' are required; it is recommended to include both if possible. 'Visitor ID' is required to generate visit frequency statistics. Ensure header column names exactly match one of the Example Names below. Incorrect formatting can lead to an upload error or inaccurate results.
Placer.ai: It is recommended that you upload the unaltered zip file which you received. Please upload either shape file or CSV format.
Watch Tutorial
Azira: You can upload a ‘Common Evening and Daytime Expanded Report’ or a similar report from Azira without any additional formatting. You may upload the CEL visit data or the entire downloaded zip file.
Unacast: Upload the file with "Catchment Area Origins", "Trade Area" or similar in the title. This contains data for visitation origin. Please ensure you only include data for visitation from home not work (e.g. "habit_area_type" should always be "HOME" in the file)
File Guidelines
Parameter
Description
Example Names
Census Block Group
A location component is necessary to segment mobile data records.
CBG, Blockgroup, Blockgroup ID, BG, Common Evening Census
Latitude
A location component is necessary to segment mobile data records. Must also include 'Longitude'.
Latitude, Lat
Longitude
A location component is necessary to segment mobile data records. Must also include latitude.
Longitude, Lng
Location/POI ID
The ID for the place being visited. We need this field to accurately determine what market(s) this data should be compared to.
Location ID, POI ID, Polygon Name, Polygon ID
Visitor ID
We can use this field to remove/reduce outliers. Additionally, it allows us to calculate frequency of visit statistics.
Visitor ID, Hashed Ubermedia ID
Date
Allows us to report the time range of the data.
Date, Visit Date
Visit Count
Allows you to include data aggregated at a visitor level or not. In the dataset, each row could represent a visitor (when you include this parameter) or a visit (without this parameter).
Visit Count, Visits
Site Address & File Upload
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Review File Details
Foot Traffic Report
Name
my-foot-traffic-report.csv
Size
2.5MB
Site Address
123 Main St, Cincinnati, OH, 45202
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
New Polygon Location
Draw Polygon
Polygon is too large. Click 'Reset' to try again.
0 credits
Buy more
Specify Date Range
Select a date range for visits to the location. For most reports we recommend using the past 12 months to account for seasonal fluctuation and ensure significant data volume.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Enter Site Address
Please enter the address for your polygon site.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Review Details
Custom Polygon
Site Address
123 Main St, Cincinnati, OH, 45202
Date Range
Past 12 Months
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Edit Group
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
CancelSave
Edit Location Details
Use this field to give this location a unique name. If left blank, only the address will be shown.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Group
Use this field to group your locations.This could be a brand name or location type (e.g. Prospective Locations).
Unlabeled
CancelSave
New Customer List
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
New Address
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
New Brand
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
New Location List
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
New Mobile Report
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
New Custom Polygon
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Loading...
This is some help text...
Loading...
Verify
Loading...