Industry Trends
Industry Trends provide insights into the overall trend of specific retail categories by region. It is especially useful for evaluating the COVID-19 recovery.
This feed reflects the Industry Trends section's data available now in the Placer.ai platform.
Files Delivery
Product optimization
Kindly be aware that this feed is optimized to mirror the latest compilation of chains available in Placer’s Chains Catalog on the UI platform. Consequently, the list of chains forming the foundation of the feed may undergo occasional updates and expansions.
-
Once enabled, files will be uploaded to your cloud bucket (AWS/GCS) or SFTP server (see Delivery Details for further details) once a week or month (based on your configuration).
-
Files will be located under this path:
/placer_industry_trends/export/analytics/industry_trends_vm/[weekly/monthly]/
- upload date, example: 2022-03-22 -
Each delivery includes a CSV file for each year (2018, 2019, 2020, 2021) of the industry-trend data for that year. The CSV Schema is detailed below.
-
In addition to the industry-trend data, a Chain-Coverage file is provided with each delivery.
-
Each file is GZip compressed
Data Retention and Usage
Placer's algorithms and data constantly improve, therefore we include all the history in every export. We strongly suggest not to use data provided in old exports with new ones to avoid data anomalies.
Schema - Industry-Trends Data
Each row represents aggregated industry data for a defined aggregation time frame, Region, and Category.
Supported aggregation time frames: Weekly and Monthly.
Supported Regions: Nationwide, State, DMA and CBSA (MSA).
Supported Categories such as Clothing, Electronics store, etc. as explained in the Venue Categories.
Categories may be updated
Note that every once in a while Placer may update the categories based on customer feedback. In these cases, feed customer will be given a 2 weeks notice in advance.
Field | Description | Type | Example |
---|---|---|---|
region_type | Included types: 'Nationwide', 'State', 'DMA' & 'CBSA' are supported | String | DMA |
region_name | Region's name | string | DMA, 662 - Abilene-Sweetwater, TX |
region_code | Region's code | string | 662 |
category | Industry Category | string | Clothing, Electronics store |
start_date | Data start date | YYYY-MM-DD | 2020-01-06 |
end_date | Data end date (inclusive) | YYYY-MM-DD | 2020-01-12 |
category_foottraffic | The category's total estimated foot-traffic | number | 2528 |
category_foottraffic_previous_year | The category's total estimated foot-traffic for the previous year | number | 8973 |
category_foottraffic_previous_week OR category_foottraffic_previous_month | The category's total estimated foot-traffic for the previous week | number | |
yoy_weekly_change OR yoy_monthly_change | Year over year weekly change in percentage | percentage | 0.81 |
wow_change OR mom_change | Week-over-week change in percentage | percentage | -0.49 |
category_group | Business domains | string | Apparel, Electronics |
industry_id | Identification of the specific industry | string |
Schema - Chain Coverage
Each export folder will include a chain-coverage file, used for:
- Understanding which Chains are included in each Category.
- Evaluating the current venue level coverage (compared to the official number) of each chain.
Column | Description | Type | Example |
---|---|---|---|
id | Placer's Chain ID | string | '59ae96a9173f562d3c355488' |
name | Chain name | string | 'Dick's Sporting Goods' |
category | Chain Category | string | 'Apparel' |
sub_category | Chain Sub-category | string | 'Sporting Goods Shop' |
coverage | Placer's coverage compared to the official number of venues | percent | 0.9 |
category_group | Business domains | string | Apparel, Electronics |
Sample
Use the following files to review the delivery format structure.
The actual delivery will include more data (more history/industries/regions).
Link to Sample file
Updated 9 months ago