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".
Weekly and Monthly - Available with all the listed metrics within the schema
Note: Weekly feeds delivered monthly are delivered with full weeks only. If a week ends on a Tuesday, the data for that week will not be delivered until the full week is in a delivery (i.e. the following month)

File formats

CSV and Parquet

Regions

The following regions can be selected for the different regional chains:

  • Nationwide
  • State
  • DMA
  • CBSA

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:

  • Daily:* Delivered each day around 7 am EST
  • Weekly:* Linear metrics only feeds delivered Wednesday; Other feeds delivered each Thursday. Linear metrics are metrics which are linear derivatives of the visits metrics and are the set below indicated by 📅 Available for daily aggregation.
  • Monthly:* Delivered on the 6th of each month
Control files

Supported

Success file

Supported

Amazon SNS notification

Supported

Deliverables and Schemas

Metrics

📘

Metrics availability

Please 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.
Supported entity types: 'venue', 'complex', 'chain', and 'billboard'.

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:

  • 'under_10_min'
  • '10_min_or_longer'
  • 'all_visits'

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

Property Chain Tag

Estimated foot traffic in the location during the relevant time frame.
Foot-traffic is the extrapolated value of visits.

Total of: 1 column

long

5000000

foottraffic_per_sqft
📅 Available for daily aggregation
Property

The number of visits at the property during the relevant time frame by its size (square footage)
Not available for billboard-type entities

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

Property Chain Tag

The accumulative foot traffic generated by customers who live within 'X' miles of the property.

  • Total of: 14 columns*. Each represents a different value of X:
    0.3, 0.5, 0.7, 1, 2, 3, 5, 7, 10, 30, 50, 100, 250, 250+\

  • *Example: **'home_distance_estimated_foottraffic_50' means the sum of visits generated by customers who live within 50 miles of the property

long

40000

home_distance_percentage_X

📅 Available for daily aggregation

Property Chain Tag

The accumulative percentage of foot traffic generated by customers who live within 'X' miles of the property.

  • Total of: 14 columns*. Each represents a different value of X:
    0.3, 0.5, 0.7, 1, 2, 3, 5, 7, 10, 30, 50, 100, 250, 250+\

  • *Example: **'home_distance_percentage_50' means the percentage of visits generated by customers who live within 50 miles of the property out of the total foot traffic for the defined period.

double

25.485

work_distance_estimated_foottraffic_X

📅 Available for daily aggregation

Property Chain Tag

The accumulative foot traffic generated by customers who work within 'X' miles of the property.

  • Total of: 14 columns*. Each represents a different value of X:
    0.3, 0.5, 0.7, 1, 2, 3, 5, 7, 10, 30, 50, 100, 250, 250+\

  • *Example: **'work_distance_estimated_foottraffic_50'
    means the sum of visits generated by customers who work within 50 miles of the property

long

4000

work_distance_percentage_X

📅 Available for daily aggregation

Property Chain Tag

The accumulative percentage of foot traffic generated by customers who work within 'X' miles of the property.

  • Total of: 14 columns*. Each represents a different value of X:
    0.3, 0.5, 0.7, 1, 2, 3, 5, 7, 10, 30, 50, 100, 250, 250+\

  • *Example:**'work_distance_percentage_50' means the percentage of visits generated by customers who work within 50 miles of the property out of the total foot traffic for the defined period.

double

13.35

avg_visits_per_day

Property Chain Tag

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

Property Chain Tag

Estimated aggregation of foot traffic bucketed by the day of the week.

Total of: 7 columns
Each represents a different value of X:
monday, tuesday, wednesday, thursday, friday, saturday, sunday

  • *Example:**'visits_by_day_of_week_sunday' means the number of visits generated by the POI's customers on Sundays for the defined period.

long

5768

visits_by_hour_of_day_X

📅 Available for daily aggregation

Property Chain Tag

Estimated aggregation of foot traffic bucketed by the hours of the day.

Total of: 24 columns
Each represents an hour of the day.

  • *Example:**'visits_by_hour_of_day_02:00_03:00' means the number of visits generated by the POI's customers between 2am and 3am (exclusive).

long

1245

visits_by_dwell_time_X

📅 Available for daily aggregation

Property Chain Tag

Estimated aggregation of foot traffic bucketed by length-of-stay duration ranges.

Total of: 13 columns
Each represents a range of length-of-stay durations in minutes:
0-5, 5-10, 10-15, 15-30, 30-45, 45-60, 60-75, 75-90, 90-105, 105-120, 120-135, 135-150, 150 and more.

  • *Example: **'visits_by_dwell_time_90_105' means the number of visits generated by the POI's customers that stayed at the property between 90 to 105 (exclusive) minutes.

long

654

avg_dwell_time

📅 Available for daily aggregation

Property Chain Tag

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

Property Chain

Estimated unique visitors

Total of: 1 column

double

7000

median_visits_per_day

Property Chain

Describes the median visitation amount for a single day during the defined period.

Total of: 1 column

long

6745

median_dwell_time

Property Chain

The median length of stay in the analyzed POI.

Total of: 1 column

double

16.3

avg_visits_frequency

Property Chain

The mean number of visits made by visitors to the analyzed POI.

Total of: 1 column

double

2.5

visitors_percent_by_freq_X

Property Chain

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
Each represents a different value of X:
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30 or more

  • *Example:**'visitors_percent_by_freq_15' means the number of unique visitors percentage to the property within the defined period who visited the property between 10 to 15 times.

double

0.1234567

Rankings

category_group_ranking_by_visits_X

Property

This ranking metric presents the ranking of the analyzed POI within its category group based on the number of visits during the defined period.
The ranking is given within 4 different regions:

  • nationwide
  • state
  • dma
  • cbsa

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

Property

This ranking metric presents the ranking of the analyzed POI within its category based on the number of visits during the defined period.
The ranking is given within 4 different regions:

  • nationwide

  • state

  • dma

  • cbsa
    For each region 2 measurements are available:

    category_ranking_by_visits_nationwide- represents the actual ranking of the POI within the region. category_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.Total of: 8 columns

int

24

chain_ranking_by_visits_X

Property

This ranking metric presents the ranking of the analyzed POI within its chain based on the number of visits during the defined period.
The ranking is given within 4 different regions:

  • nationwide

  • state

  • dma

  • cbsa
    For each region 2 measurements are available:

    chain_ranking_by_visits_nationwide- represents the actual ranking of the POI within the region. chain_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 chain.Total of: 8 columns

int

8

category_group_ranking_by_visits_per_sqft_X

Property

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.
The ranking is given within 4 different regions:

  • nationwide

  • state

  • dma

  • cbsa
    For each region 2 measurements are available:

    category_group_ranking_by_visits_per_sqft_nationwide - represents the actual ranking of the POI within the region

    category_group_ranking_by_visits_per_sqft_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

15

category_ranking_by_visits_per_sqft_X

Property

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.
The ranking is given within 4 different regions:

  • nationwide
  • state
  • dma
  • cbsa
    For each region 2 measurements are available:
    • *category_ranking_by_visits
    • per_sqft_nationwide**- represents the actual ranking of the POI within the region. category_ranking_by_visits_per_sqft_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.Total of: 8 columns

int

33

chain_ranking_by_visits_per_sqft_X

Property

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.
The ranking is given within 4 different regions:

  • nationwide

  • state

  • dma

  • cbsa
    For each region 2 measurements are available:

    _chain_ranking_by_visits_per_sqft_nationwide- represents the actual ranking of the POI within the region. chain_ranking_by_visits_per_sqft_nationwide_total- represents the total number of entities taken into consideration for the ranking within the region(in this example "nationwide") for the specific chain.Total of: 8 columns

int

2

Same Store Metrics

same_store_visits
Chain

The total estimated visits generated by the set of “same stores” between start and end dates

long

471133095

same_store_visits_prev_year
Chain

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
Chain

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
Chain

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

Property Chain

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
Each represents a different value of X:
white, hispanic_or_latino, black, Asian, multi race, American indian or Alaska, native Hawaiian and other pacific islanders, other

  • *Example: **'census_potential_by_ethnicity
  • asian' means the population within the POI's potential trade area during the defined period identified as Asian.

double

1455

census_potential_by_education_X

Property Chain

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
Each represents a different value of X:
advanced degree, bachelors degree, college or associates degree, high school, elementary

  • *Example: **'census_potential_by_education
  • bachlors_degree' means the population older than 25 years within the POI's potential trade area during the defined period identified as having a bachelor's degree.

double

3989

  • *census_potential_by_marital_status
  • X**

Property Chain

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
Each represents a different value of X:
never married, married, divorced, widowed

  • *Example: **'census_potential_by_marital_status
  • married' means the population within the POI's potential trade area during the defined period identified as married.

double

12311

census_potential_avg_hhi

Property Chain

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

Property Chain

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

Property Chain

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
Each represents a different value of X:
Less than 5, 5 to 15, 15 to 18, 18 to 22, 22 to 25, 25 to 30, 30 to 35, 35 to 40, 40 to 45, 45 to 50, 50 to 55, 55 to 60, 60 to 65, 65 to 70, 70 to 75, 75 to 80, 80 to 85, 85 or more

  • *Example: **'census_potential_by_age
  • 5_to_15' means the population within the POI's potential trade area during the defined period between the ages of 5 and 15.

double

22768

census_potential_by_gender_X

Property Chain

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
Each represents a different value of X:
male or female

  • *Example: **'census_potential_by_gender
  • female' means the population within the POI's potential trade area during the defined period identified as female.

double

10453

census_potential_population

Property Chain

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

  • *census_captured_by_education
  • X**

Property Chain

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
advanced degree, bachelors degree, college or associates degree, high school, elementary

  • *Example: **'census_captured_by_education
  • bachlors_degree' means the audience older than 25 years within the POI's captured market during the defined period identified as having a bachelor's degree.

double

4032

census_captured_by_ethnicity_X

Property Chain

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
Each represents a different value of X:
white, hispanic_or_latino, black, Asian, multi race, American indian or Alaska, native Hawaiian and other pacific islanders, other

  • *Example: **'census_captured_by_ethnicity
  • asian' means the population within the POI's captured market during the defined period identified as Asian.

double

1442

census_captured_by_hhi_X

Property Chain

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
Each represents a different value of X:
less_than_10K, 10K_to_15K, 15K_to_20K, 20K_to_25K, 25K_to_30K, 30K_to_35K, 35K_to_40K, 40K_to_45K, 45K_to_50K, 50K_to_60K, 60K_to_75K, 75K_to_100K, 100K_to_125K, 125K_to_150K, 150K_to_200K, more_than_200K

  • *Example: **'census_captured_by_hhi_45K_to_50K' means the number of households within the POI's captured market during the defined period identified as having an income between 45K and 50K.

double

12654

census_captured_avg_hhi

Property Chain

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

Property Chain

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

  • *census_captured_by_marital_status
  • X**

Property Chain

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
Each represents a different value of X:
never married, married, divorced, widowed

  • *Example:
  • *'census_captured_by_marital_status
  • married' means the population within the POI's captured market during the defined period identified as married.

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

Property Chain

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

  • *popstats_potential_by_household_types
  • X**

Property Chain

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:
one_person_households, married_couple, male_householder, female_householder, non_family_households, households_with_children

  • *Example: **'popstats_potential_by_household
  • types_married_couple' means the number of households within the POI's potential trade area during the defined period identified as married couples.

popstats_potential_by_age_X

Property Chain

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
Each represents a different value of X:
Less than 5, 5 to 14, 14 to 18, 18 to 22, 22 to 25, 25 to 30, 30 to 35, 35 to 40, 40 to 45, 45 to 50, 50 to 55, 55 to 60, 60 to 65, 65 to 70, 70 to 75, 75 to 80, 80 to 85, 85 or more

  • *Example: **'popstats_potential_by_age
  • 35_to_40' means the population within the POI's potential trade area during the defined period between the ages of 5 and 14.

double

2657

popstats_potential_by_education_X

Property Chain

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
Each represents a different value of X:
doctorate_degree, professional_degree, masters_degree, bachelors_degree_only, associates_degree_only, some college, some high school, high school, elementary

  • *Example:
  • *'popstats_potential_by_education
  • doctorate_degree' means the population older than 25 years within the POI's potential trade area during the defined period identified as having a doctorate's degree.

double

2711

popstats_potential_by_hhi_X

Property Chain

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
Each represents a different value of X:
less_than_10K, 10K_to_15K, 15K_to_20K, 20K_to_25K, 25K_to_30K, 30K_to_35K, 35K_to_40K, 40K_to_45K, 45K_to_50K, 50K_to_55K, 55K_to_60K, 60K_to_65K, 65K_to_70K, 70K_to_75K, 75K_to_80K, 80K_to_85K, 85K_to_90K, 90K_to_95K, 95K_to_100K, 100K_to_125K, 125K_to_150K, 150K_to_175K, 175K_to_200K, 200K_to_250K, 250K_to_500K, more_than_500K

  • *Example: **'popstats_potential_by_hhi
  • 45K_to_50K' means the number of households within the POI's potential trade area during the defined period identified as having an income between 45K and 50K.

double

260

popstats_potential_by_ethnicity_X

Property Chain

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
Each represents a different value of X:
white, black, Asian, hispanic, other

  • *Example: **'popstats_potential_by_ethnicity
  • asian' means the population within the POI's potential trade area during the defined period identified as Asian.

double

2145

popstats_potential_avg_hhi

Property Chain

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

Property Chain

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

  • *popstats_captured_by_household_types
  • X**

Property Chain

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:
households, one_person_households, married_couple, male_householder, female_householder, non_family_households, households_with_children

  • *Example: **'popstats_captured_by_household
  • types_married_couple' means the number of households within the POI's potential trade area during the defined period identified as married couples.
    • Chain level data is available

popstats_captured_by_education_X

Property Chain

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
Each represents a different value of X:
doctorate_degree, professional_degree, masters_degree, bachelors_degree_only, associates_degree_only, some college, some high school, high school, elementary

  • *Example:
  • *'popstats_captured_by_education
  • doctorate_degree' means the population older than 25 years within the POI's potential trade area during the defined period identified as having a doctorate's degree.
    • Chain level data is available

double

2711

popstats_captured_by_hhi_X

Property Chain

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
Each represents a different value of X:
less_than_10K, 10K_to_15K, 15K_to_20K, 20K_to_25K, 25K_to_30K, 30K_to_35K, 35K_to_40K, 40K_to_45K, 45K_to_50K, 50K_to_55K, 55K_to_60K, 60K_to_65K, 65K_to_70K, 70K_to_75K, 75K_to_80K, 80K_to_85K, 85K_to_90K, 90K_to_95K, 95K_to_100K, 100K_to_125K, 125K_to_150K, 150K_to_175K, 175K_to_200K, 200K_to_250K, 250K_to_500K, more_than_500K

  • *Example: **'popstats_captured_by_hhi
  • 45K_to_50K' means the number of households within the POI's potential trade area during the defined period identified as having an income between 45K and 50K.
    • Chain level data is available

double

260

popstats_captured_by_ethnicity_X

Property Chain

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
Each represents a different value of X:
white, black, Asian, hispanic, other

  • *Example: **'popstats_captured_by_ethnicity
  • asian' means the population within the POI's potential trade area during the defined period identified as Asian.
    • Chain level data is available

double

2145

popstats_captured_avg_hhi

Property Chain

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

    • Chain level data is available

double

3655

popstats_captured_median_hhi

Property Chain

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

    • Chain level data is available

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

Property

The total dollar value (USD) of all sales generated for the analyzed POI during the defined period.

double

2324566.25

sales_transactions
📅 Available for daily aggregation

Property

The total number of sales transactions, which took place at the analyzed POI during the defined period.

double

34250

sales_average_ticket_size
📅 Available for daily aggregation

Property

The average dollar value per transaction generated at the analyzed POI during the defined period.

double

22.45

sales_per_sqft
📅 Available for daily aggregation

Property

The total dollar value (USD) of sales per sq ft generated at the POI during the defined period.

double

145.39

  • *category_group_ranking_by
  • sales_X**
    📅 Available for daily aggregation
    Property

This ranking metric presents the ranking of the analyzed POI within its category group based on the total sales during the defined period.
The ranking is given within 4 different regions:

  • nationwide
  • state
  • dma
  • cbsa
    For each region 2 measurements are available:
    • category_group_ranking_by_sales_nationwide* - represents the actual ranking of the POI within the region
    • category_group_ranking_by_sales_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

55

  • *category_ranking_by
  • sales_X**
    📅 Available for daily aggregation\

Property

This ranking metric presents the ranking of the analyzed POI within its category based on the total sales during the defined period.
The ranking is given within 4 different regions:

  • nationwide
  • state
  • dma
  • cbsa
    For each region 2 measurements are available:
    • category_ranking_by_sales_nationwide* - represents the actual ranking of the POI within the region.
    • category_ranking_by_sales_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. Total of: 8 columns

int

145

  • *chain_ranking_by
  • sales_X**
    📅 Available for daily aggregation\

Property

This ranking metric presents the ranking of the analyzed POI within its chain based on the total sales during the defined period.
The ranking is given within 4 different regions:

  • nationwide
  • state
  • dma
  • cbsa
    For each region 2 measurements are available:
    • chain_ranking_by_sales_nationwide* - represents the actual ranking of the POI within the region.
    • chain_ranking_by_sales_nationwide_total*- represents the total number of entities taken into consideration for the ranking within the region(in this example "nationwide") for the specific chain. Total of: 8 columns

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)
associated with the tag.

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 expand

Follow 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 order

Please 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 first

Placer 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.