Premium Export
Overview
Premium Export enables the delivery of Placer data at scale for businesses looking to enhance their in-house data analytics capabilities with accurate location data.
This feed provides delivery of various location metrics, allowing you to combine up-to-date location data into your first-party data and build internal reports, applications, and dashboards.
Configuration
Configuration aspect | Available options descriptions |
|---|---|
Data granularity | Daily - Available with the metrics explicitly specified and tagged with "Available for daily aggregation". |
File formats | CSV and Parquet |
Regions | The following regions can be selected for the different regional chains:
|
Feeds time frame | The feed's timeframe can be configured to any period within the last 3 years. |
Delivery methods | Please refer to the following Delivery Details for all supported Premium export feed delivery options. |
Delivery Schedule | Here is the delivery scheduling for each of the available feeds:
|
| Control files | Supported |
| Success file | Supported |
Supported |
Deliverables and Schemas
Metrics
Metrics availabilityPlease note that not all metrics are available for all types of entities in all possible granularities.
Please refer to the definitions and structure of each metric:
Column | Description | Type | Example |
|---|---|---|---|
publication_date | Data publication date | ISO-8601 | 2024-08-01 |
version_code | Calibration version code | string | 2.1.0 |
id | Placer's entity ID | string | '5965fca0173f564b883c222e' |
name | Entity name | string | 'McDonald's' |
type | Entity type. | string | 'venue' |
time_frame | Data aggregation resolution. Supported values: 'weekly' and 'monthly'. | string | 'monthly' |
start_date | Data start date. | ISO-8601 | 2018-04-15 |
end_date | Data end date (inclusive) | ISO-8601 | 2018-04-15 |
region_type | The regional chain type. 'nationwide', 'state', 'dma' & 'cbsa' are supported. Only available for entities of type 'chain'. Note: CBSA is the union of MSAs & micro-MSAs | string | 'state' |
region_name | Region's name. Only available for entities of type 'chain.' | string | 'California' |
region_code | Region's code. Only available for entities of type 'chain.' | string | 'CA' |
lat | The entity's latitude. Only available for entities of type 'venue' or 'complex' | double | 37.786099 |
lng | The entity's longitude. Only available for entities of type 'venue' or 'complex' | double | -121.46352 |
ticker_symbol | The stock exchange ticker symbol | string | 'MCD' |
company_name | If available, the parent company chain name. | string | 'McDonald's' |
visit_duration_segmentation | Displays the visit duration segmentation used for the generation of the raw reported data. The values within this column may fall into one of the following categories:
| string | 'under_10_min' |
Basic Visit Metrics
The set provides foot traffic data, breakdowns by time of day, day of week, and dwell times, as well as distance metrics to home and work locations.
Column | Description | Type | Example |
|---|---|---|---|
foottraffic 📅 Available for daily aggregation
| Estimated foot traffic in the location during the relevant time frame. Total of: 1 column | long | 5000000 |
foottraffic_per_sqft | The number of visits at the property during the relevant time frame by its size (square footage) Total of: 1 column | double | 10.91 |
Advanced Visit Metrics
This set provides visitor counts, visit frequency data and other statistics beyond basic foot traffic metrics.
Column | Description | Type | Example |
|---|---|---|---|
home_distance_estimated_foottraffic_X 📅 Available for daily aggregation
| The accumulative foot traffic generated by customers who live within 'X' miles of the property.
| long | 40000 |
home_distance_percentage_X 📅 Available for daily aggregation
| The accumulative percentage of foot traffic generated by customers who live within 'X' miles of the property.
| double | 25.485 |
work_distance_estimated_foottraffic_X 📅 Available for daily aggregation
| The accumulative foot traffic generated by customers who work within 'X' miles of the property.
| long | 4000 |
work_distance_percentage_X 📅 Available for daily aggregation
| The accumulative percentage of foot traffic generated by customers who work within 'X' miles of the property.
| double | 13.35 |
avg_visits_per_day
| Describes the average visitation amount for a single day during the defined period. Total of: 1 column | double | 5984.44 |
visits_by_day_of_week_X
| Estimated aggregation of foot traffic bucketed by the day of the week. Total of: 7 columns
| long | 5768 |
visits_by_hour_of_day_X 📅 Available for daily aggregation
| Estimated aggregation of foot traffic bucketed by the hours of the day. Total of: 24 columns
| long | 1245 |
visits_by_dwell_time_X 📅 Available for daily aggregation
| Estimated aggregation of foot traffic bucketed by length-of-stay duration ranges. Total of: 13 columns
| long | 654 |
avg_dwell_time 📅 Available for daily aggregation
| Describes the average visit length of stay in minutes during the defined period in the analyzed POI. Total of: 1 column | double | 15.6 |
unique_visitors
| Estimated unique visitors Total of: 1 column | double | 7000 |
median_visits_per_day
| Describes the median visitation amount for a single day during the defined period. Total of: 1 column | long | 6745 |
median_dwell_time
| The median length of stay in the analyzed POI. Total of: 1 column | double | 16.3 |
avg_visits_frequency
| The mean number of visits made by visitors to the analyzed POI. Total of: 1 column | double | 2.5 |
visitors_percent_by_freq_X
| Each bin of this metric represents the estimated number of unique visitors that visited the analyzed POI a certain number of times. Total of: 13 column
| double | 0.1234567 |
Rankings | |||
category_group_ranking_by_visits_X
| This ranking metric presents the ranking of the analyzed POI within its category group based on the number of visits during the defined period.
For each region 2 measurements are available: category_group_ranking_by_visits_nationwide - represents the actual ranking of the POI within the region category_group_ranking_by_visits_nationwide_total- represents the total number of entities taken into consideration for the ranking within the region(in this example "nationwide") for the specific category group. Total of: 8 columns | int | 35 |
category_ranking_by_visits_X
| This ranking metric presents the ranking of the analyzed POI within its category based on the number of visits during the defined period.
| int | 24 |
chain_ranking_by_visits_X
| This ranking metric presents the ranking of the analyzed POI within its chain based on the number of visits during the defined period.
| int | 8 |
category_group_ranking_by_visits_per_sqft_X
| This ranking metric presents the ranking of the analyzed POI within its category group based on the number of visits per square feet during the defined period.
| int | 15 |
category_ranking_by_visits_per_sqft_X
| This ranking metric presents the ranking of the analyzed POI within its category based on the number of visits per square feet during the defined period.
| int | 33 |
chain_ranking_by_visits_per_sqft_X
| This ranking metric presents the ranking of the analyzed POI within its chain based on the number of visits per square feet during the defined period.
| int | 2 |
Same Store Metrics | |||
same_store_visits | The total estimated visits generated by the set of “same stores” between start and end dates | long | 471133095 |
same_store_visits_prev_year | The total estimated visits generated by the set of “same stores” in the same data period in the previous year | long | 428157654 |
same_store_yoy_pct_change | The % difference generated by the set of “same stores” between start and end dates, and the same data period in the previous year | float | 10.0372937 |
same_store_count | The number of entities included in the same store subset for this month/week | int | 1200 |
Demographics
Placer offers demographics associated with a location or chain's True Trade Area.
Census Potential Trade Area
This set provides demographic information based on Census ACS 2023 dataset for the potential trade area of a property or a chain.
Column | Description | Type | Example |
|---|---|---|---|
census_potential_by_ethnicity_X
| The demographic (based on Census ACS dataset) distribution of the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by ethnicity bins. Total of: 8 columns
| double | 1455 |
census_potential_by_education_X
| The demographic (based on Census ACS dataset) distribution of the analyzed POI's potential market population older than 25 years (considering the 70% top most visited CBGs), segmented by education bins. Total of: 5 columns
| double | 3989 |
| The demographic (based on Census ACS dataset) distribution of the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by marital status bins. Total of: 4 columns
| double | 12311 |
census_potential_avg_hhi
| The average household income (based on Census ACS dataset) of the analyzed POI's potential market households (considering the 70% top most visited CBGs). Total of: 1 column | double | 4563 |
census_potential_median_hhi
| The median household income (based on Census ACS dataset) of the analyzed POI's potential market households (considering the 70% top most visited CBGs). Total of: 1 column | double | 3545 |
census_potential_by_age_X
| The demographic (based on Census ACS dataset) distribution of the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by age bins. Total of: 18 columns
| double | 22768 |
census_potential_by_gender_X
| The demographic (based on Census ACS dataset) distribution of the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by gender bins. Total of: 2 columns
| double | 10453 |
census_potential_population
| The total population within the analyzed POI's potential market population (considering the 70% top most visited CBGs). Total of: 1 column | double | 19879 |
Census Captured Trade Area
This set provides demographic information based on Census ACS 2023 dataset within the captured trade area (based on actual visits) of a property or a chain.
Column | Description | Type | Example |
|---|---|---|---|
| The demographic (based on Census ACS dataset) distribution of the captured market audience older than 25 years(considering 70% of the traffic volume), segmented by education bins. Total of: 5 columns
| double | 4032 |
census_captured_by_ethnicity_X
| The demographic (based on Census ACS dataset) distribution of the captured market audience (considering 70% of the traffic volume), segmented by ethnicity bins. Total of: 8 columns
| double | 1442 |
census_captured_by_hhi_X
| The distribution of the households (based on Census ACS dataset) within the captured market audience (considering 70% of the traffic volume), segmented by household income bins. Total of: 16 columns
| double | 12654 |
census_captured_avg_hhi
| The average household income (based on Census 2023 dataset) within the captured market audience (considering 70% of the traffic volume). Total of: 1 column | double | 76243.98 |
census_captured_median_hhi
| The median household income (based on Census ACS dataset) within the captured market audience (considering 70% of the traffic volume). Total of: 1 column | double | 113777.22 |
| The demographic (based on Census ACS dataset) distribution of the captured market audience (considering 70% of the traffic volume), segmented by marital status bins. Total of: 4 columns
| double | 11599 |
Popstats Potential Trade Area
This set provides demographic information based on STI:Popstats 2024 dataset for the potential trade area of a property or a chain.
Column | Description | Type | Example |
|---|---|---|---|
popstats_potential_population
| The total population (based on STI:Popstats) within the analyzed POI's potential market population (considering the 70% top most visited CBGs). Total of: 1 column | double | 30546 |
| The demographic (based on STI:Popstats) distribution of the analyzed POI's potential market households (considering the 70% top most visited CBGs), segmented by household types. Total of: 6 columns Each represents a different value of X:
| ||
popstats_potential_by_age_X
| The demographic (based on STI:Popstats) distribution of the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by age bins. Total of: 18 columns
| double | 2657 |
popstats_potential_by_education_X
| The demographic (based on STI:Popstats) distribution of the analyzed POI's potential market population older than 25 years(considering the 70% top most visited CBGs), segmented by education bins. Total of: 9 columns
| double | 2711 |
popstats_potential_by_hhi_X
| The distribution of the households (based on STI:Popstats) within the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by household income bins(in USD). Total of: 26 columns
| double | 260 |
popstats_potential_by_ethnicity_X
| The demographic (based on STI:Popstats) distribution of the analyzed POI's potential market population (considering the 70% top most visited CBGs), segmented by ethnicity bins. Total of: 5 columns
| double | 2145 |
popstats_potential_avg_hhi
| The average household income (based on STI:Popstats) of the analyzed POI's potential market households (considering the 70% top most visited CBGs). Total of: 1 column | double | 3655 |
popstats_potential_median_hhi
| The median household income (based on STI:Popstats) of the analyzed POI's potential market households (considering the 70% top most visited CBGs). Total of: 1 column | double | 3433 |
Popstats Captured Trade Area
This set provides demographic information based on STI:Popstats 2024 dataset within the captured trade area (based on actual visits) of a property or a chain.
Column | Description | Type | Example |
|---|---|---|---|
| The demographic (based on STI:Popstats 2024) distribution of the analyzed POI's captured market households (considering the 70% top most visited CBGs), segmented by household types. Total of: 7 columns Each represents a different value of X:
| ||
popstats_captured_by_education_X
| The demographic (based on STI:Popstats 2024) distribution of the analyzed POI's captured market population older than 25 years(considering the 70% top most visited CBGs), segmented by education bins. Total of: 9 columns
| double | 2711 |
popstats_captured_by_hhi_X
| The distribution of the households (based on STI:Popstats 2024) within the analyzed POI's captured market population (considering the 70% top most visited CBGs), segmented by household income bins(in USD). Total of: 26 columns
| double | 260 |
popstats_captured_by_ethnicity_X
| The demographic (based on STI:Popstats 2024) distribution of the analyzed POI's captured market population (considering the 70% top most visited CBGs), segmented by ethnicity bins. Total of: 5 columns
| double | 2145 |
popstats_captured_avg_hhi
| The average household income (based on STI:Popstats 2024) of the analyzed POI's captured market households (considering the 70% top most visited CBGs). Total of: 1 column
| double | 3655 |
popstats_captured_median_hhi
| The median household income (based on STI:Popstats 2024) of the analyzed POI's captured market households (considering the 70% top most visited CBGs). Total of: 1 column
| double | 3433 |
Retail Sales
Available to Retail Sales customers, this metric set provides sales estimates and traffic counts for POIs.
Column | Description | Type | Example |
|---|---|---|---|
sales 📅 Available for daily aggregation
| The total dollar value (USD) of all sales generated for the analyzed POI during the defined period. | double | 2324566.25 |
sales_transactions
| The total number of sales transactions, which took place at the analyzed POI during the defined period. | double | 34250 |
sales_average_ticket_size
| The average dollar value per transaction generated at the analyzed POI during the defined period. | double | 22.45 |
sales_per_sqft
| The total dollar value (USD) of sales per sq ft generated at the POI during the defined period. | double | 145.39 |
| This ranking metric presents the ranking of the analyzed POI within its category group based on the total sales during the defined period.
| int | 55 |
| This ranking metric presents the ranking of the analyzed POI within its category based on the total sales during the defined period.
| int | 145 |
| This ranking metric presents the ranking of the analyzed POI within its chain based on the total sales during the defined period.
| int | 34 |
POI metadata
Please refer to the following page for the POI metadata schema.
Metadata for Tags
Customers that request a metadata file for feeds that contain tags (i.e. the feed's entity list is defined using tags) will receive a tags_entities_mapping.csv file to supplement their analysis toolkit.
The tag-entities mapping file helps to bridge the relationship between tags and the entities they contain, offering a clear data structure that enhances the traceability and usability of the delivered tag-based data.
The metadata file includes the following schema:
Column | Description | Type | Example |
|---|---|---|---|
tag_id | The identifier of the tag. | string | '636371ee42a729232a6b755e' |
tag_name | The name of the tag. | string | 'My Tag' |
entity_id | The identifier of the entity associated with the tag. | string | '5965fca0173f564b883c222e' |
entity_type | The type of entity (i.e. venue, complex, chain or billboard) | string | 'venue' |
This file helps for efficient correlation feed entities with the originating tags, enabling streamlined data validation, filtering, and analysis.
Sample files
Sample Premium Export (CSV file)
Grow and expandFollow our announcements regarding additional attributes (metadata) and metrics.
New metadata attributes will be announced and delivered to you once released.
Please contact your customer support manager to receive new/additional metrics as part of your feed.
Columns orderPlease be aware that the order of columns may change slightly due to the continuous addition of data to the export and its associated metadata.
Privacy comes firstPlacer is a privacy-first company, and like all our products this feed conforms to our privacy policy as described in our Trust Center. In situations where the content of this feed conflicts with our privacy policy, the conflicting data points will be redacted from the files.
Updated 4 days ago
