Locations
Locations are the bricks and mortar locations of your stores, events, or other information that are related to the brands in your account. You can import postal codes and other additional information to curate a directory of physical locations, and then use that directory with our template API to create targeted, personalised campaigns.
On this page:
Adding a Location
To add a location, navigate to the locations tab: Data > Locations, then click Add Location.
Creating a Single Location
Name
Provide a name for the location that is relevant so it can be a secondary identifier.
Identifier
The identifier is unique to the location, and you can use it to identify your store, even if you have two that share the same postal code (for example, stores that share the same shopping centre).
Brand
Select the brand that the location relates to.
Owner
The owner will default to you, though you can change it if required.
Description
This information appears in the user interface and can provide additional information about the location.
Address
Provide your address, this is to complete the location of your brand, alongside your postal code.
Postal Code
Give the postal code of your location. This allows us to identify the location for use in targeted campaigns (UK Only)
Country Code
Apply the two letter country code, related to the address and postal code. This uses Alpha 2 Code.
Grid Reference
Provide the latitude and longitude of your location. If there is no grid reference provided then we will use the postal code.
Additional Data
Provide additional data that is relevant to the location; for example, whether you can reserve online and collect in-store, or if there is a delivery service.
Importing a CSV of Locations
To import multiple locations, click the Import Locations link.
You will need to select a CSV uploaded into the File Manager in order to be able to proceed.
Field Mapping
Once you have uploaded your CSV and clicked Next, you will be asked to map your CSV headings to the required fields.
Location Field Requirements
There are some required fields, for you to import your CSV of locations successfully. The table below details this information.
| Field Name | Description | Mandatory |
|---|---|---|
| identifier | This is unique to the location. | Yes |
| brand_id | The brand that relates to the location. | Yes |
| name | A secondary, cosmetic identifier. | Yes |
| postal_code | The postal code of your location. Providing this information allows for identification of where the location is (UK only). | Yes |
| country_code | A two letter country code, related to the address and postal code. This uses Alpha 2 Code with one exception. Both UK and GB will refer to the United Kingdom. | Yes |
| description | This information is only used within Adestra, and can provide additional context to other users. | No |
| address | The physical address of the location, used alongside your postal code. | No |
| grid_ref | Provide the latitude and longitude of your location. This can be accepted as (x,y) or as x,y. | No1 |
| latitude | If you wish to supply the grid reference as separate values, you can use this to provide the latitude. If you use this, you must supply a longitude value also. | No1 |
| longitude | The longitude of the location. If you use this, you must supply a latitude value also. | No1 |
| data | Any additional data that you wish to call on for this location. This should be provided in a JSON format. | No |
1 A grid reference or a latitude and longitude can be used, but not both. Once the CSV file is selected, you will need to ensure the mandatory fields are mapped across. Once complete, you can click "Import".
Note: Grid references, created by latitude and longitude, require double quotations.
Location Overview
Once you have completed the form and saved your location, you will be shown it's overview. Here all the information provided will be summarised.
Using Your Locations
You'll be able to use the locations held on a brand to be pulled into your campaigns. This uses our Template API and will allow you to also find the nearest location (for UK postal codes only).