Overview
Accessing Location Manager: Location Manager can be accessed either directly in the Ads Manager Targeting set-up page, via the "Location Manager" tile from the hamburger menu, or by signing into https://locations.groundtruth.com.
Location Manager: A dedicated tool which allows you to create and maintain a list of business locations called Location Groups (LG).
Location Group (LG): A custom targeting list of POIs (Points of Interests) that a user can create and manage. Unlike GroundTruth's standard Brand or Category lists which is available across all Tenants and Accounts, a Location Group lives under a dedicated Account. Once created, the Location Group can be saved, easily updated, and reused across multiple campaigns (all within the same Account).
Point of Interest (POI): A POI can also be referred to as a (business) address or a location.
Once a Location Group is created, it can be used for various purposes including:
- Radial targeting
- Blueprint (or On-Premise) targeting
- Visit measurement
- Location Audience
- Neighborhood Audience
Location Manager Homepage
The Location Manager homepage lists all location groups under the selected Account with new location groups are added to the top. Location groups are only accessible within the Account they were built in. This page gives an overview of:
- The number of locations within each location group, as well as their breakdown to "Accepted Locations", "Invalid Addresses", "Locations Conflict", and "Rejected Locations" tabs.
- Status of Location Audience (see Audience Targeting column) and Neighborhood Audience (see Neighborhood targeting column). To build these audiences, click on the Build Targeting text under the "Action" column. Learn more about these features in Location Group Targeting Enhancements.
Creating a Location Group & Adding Locations to a Location Group
- In Location Manager, click the "+ New Location Group" button.
- Enter your Location Group Name & Location Group Description (both fields are required), click Continue.
- In the newly created location group, click the "+ Add Locations" button and choose from 3 options to add your locations:
Select From our System: Select POIs by brands, categories, other location groups, POIs, or lat/long coordinates from our POI database, and filter based on city, state, DMA, or zip code. Review all potential locations and remove unwanted ones using the "open" button before finalizing the selection.
Upload a Location File: Upload a file with a list of handpicked addresses. Important: Use the available template by clicking "Download" in the dialog box and make sure to include a company name for each address. Company name fields have a max length of 64 characters.
Add Locations Manually: Manually enter addresses, making sure to include a business name for each address. Recommended option if adding 5 or less POIs.
Once a location group has been created, it cannot be deleted. You may delete the contents within the location group, but the location group itself will remain and is available for future use.
Understanding Location Status Tabs
When choosing to add addresses from a file or manually, the system will attempt to match the addresses with existing POIs in our database. The addresses will then be classified to 4 topics (accessible through tabs, within the location group page).
- "Accepted Locations" - addresses that were matched with existing POIs already created in the GroundTruth database
-
"Invalid Addresses" - addresses that were not matched with any POI, and could not be geocoded to be added as new locations (suggests there is a problem with the address)
- Users can return to this tab at any point, and try to edit the address and business name of each Invalid location
- Once changes have been made and saved, the location will be matched again with our POI Database and, and if no match was found, will be resent to geocoding
-
"Locations Conflict" - addresses that were matched with multiple POIs (from which the user should choose) or addresses that were not matched with any POI and can be added as new location.
- Users can return to this tab at any point and choose which of the matched POIs they would like to add as "Accepted Locations". When possible, the user will be able to create new POIs from their input addresses
-
"Rejected Locations" - addresses that could not be be accepted due to the location being deemed sensitive, or unusable for targeting or tracking visits. GroundTruth is committed to user privacy and follows strict data collection guidelines. Here are example of locations that may be rejected:
- Prohibited Locations (e.g. Nuclear Power Plants, Adult Entertainment)
- Consumer Protected Locations (e.g. Places of Worship, Family Planning)
The locations in the Accepted Locations tab will become active immediately. Location that are sorted into other tabs will require additional action before they can be accepted.
Understanding POI Status
Within a Location Group, locations are sorted into 4 tabs (depending on Location Status), each tab features a "Status" column to indicate the status of each location (aka POI, or point of interest).
"Accepted Locations" Tab
-
Blueprinted: The location is active and blueprinted.
- Blueprinted can be visualized by clicking on the eye icon
.
- If you have any questions regarding the blueprints, you can communicate directly with us through by clicking on the comment icon
.
- Blueprinted can be visualized by clicking on the eye icon
- Radial Xm: The location is active but the boundaries cannot be determined accurately. The location will be used with a radius of X meters. The exact reason for not blueprinting can be viewed in the next column: ‘Reason’.
- Radial Xm (Pending Blueprinting): The location is active but has not been reviewed by the blueprinting team yet. Meanwhile, the location will be used with a radius of X meters.
- Rejected: The location is not active and won't be used for Targeting or Tracking visits. The reason for Rejection can be viewed in the next column: ‘Reason.’
- Sensitive: The location is not active, as it was classified as sensitive, and will not be used as part of the location group.
"Invalid Locations" Tab
Locations in this tab are not valid, as our system could not geocode (identify and generate a lat/long) for it. These addresses will not be used as part of the location group.
"Locations Conflict" Tab
Following the User Input row, the system will provide other similar POIs for the users consideration. The use needs to select the checkbox to the left of the row that best matches the location details, then click to save.
- User input: Indicates the original address and business name that was added by the user (gray row).
- Best match: Indicates the POI with the best match to the user's input.
- Possible match: Indicates POIs with possible match to the user's input (up to 3 possible matches).
- Add as new: The address and business name combination does not yet exist in our database and needs to be saved as a new POI.
"Rejected Locations" Tab
Locations in this tab are rejected, as our system deemed the location either sensitive or unusable for targeting or tracking visits. If you have any questions regarding the rejected locations, reach out to us using the feedback feature by clicking the comment icon .
Subscribe to your Location Group(s)
As a default, you will be automatically subscribed to receive status notifications upon creation of a new Location Group. You'll receive email alerts about key changes, like blueprint progress, for you POIs (points of interests; aka the locations within your Location Group)
These alerts are delivered as a single, consolidated daily digest email summarizing all POI status changes from the past 24 hours across your subscribed Location Groups. You will only receive an email on days when the status changes occur.
- Unsubscribing: You can easily opt out from receiving notifications at any time using the Unsubscribe button in Location Manger. Opting out is managed on an individual Location Group basis, meaning you will continue to receive updates for all other groups you're subscribed to.
- Campaign Status: For quick reference, the daily digest email includes an Active Campaign column indicating whether the Location Group is currently part of an active ad campaign.
The auto-subscribe feature was released November 14, 2025. For any Location Groups created before this date, you will need to manually subscribe to receive email notifications.
Comments
Can Location Group names be made to be a 'sortable' column? Also have the 'sort' selection stick from session to session? Meaning if I set it to sort ascending.. have it stay that way even if I log out and come back in later.
Thanks
Don
Hi Don,
The sorting function is not available in the current version. I will get in touch with our product and technology team to put in a feature request.
In the meantime, please note that there is a search box function to quickly find any location group.
Thank you
The GroundTruth Team
Please sign in to leave a comment.