Industry-Specific Event Filters

Learn how to effectively filter PredictHQ event data with industry-specific recommendations.

With so many events taking place, it is important to filter out the noise and focus only on events that are relevant to your business. Use this guide in conjunction with our APIs, such as Events API and Features API, and consult API Reference for detailed information.

These recommendations are intended as starting points and may need to be adapted for your specific locations. Test out these filters and contact our team for additional guidance.

Location Type

How a catchment area is defined for a store or location varies by industry as events impact industries differently. Setting the area too small may result in important events being missed, while an excessively large area can introduce unnecessary noise.

For stores and locations where proximity to events is important, such as those in Retail and Parking, a center point and radius approach is recommended. For industries like Transportation & Delivery, which may be influenced by broader regional events, city-level locations are advisable. We suggest the following location types as a starting point:

IndustryLocation Type

Accommodation

Center Point & Radius

Consumer Packaged Goods

City

Food and Beverage (also known as Restaurants)

Center Point & Radius

Grocery and Supermarkets

Center Point & Radius

Leisure, Travel and Tourism

City

Marketing

City

Parking

Center Point & Radius

Retail

Center Point & Radius

Transportation and Delivery

City

Other

City

To retrieve events for different location types, use the following approaches:

Center Point & Radius

Using latitude, longitude, and radius

  1. Determine the appropriate radius using the Suggested Radius API.

  2. Configuration:

    1. For the Events API, use the within field.

    2. For the Features API and Beam API, use the location field.

Using location IDs

  1. Create Saved Locations via Location Insights in Control Center or at scale using the Saved Locations API.

  2. Configuration:

    1. For the Events API, use the saved_location.location_id field.

    2. For the Features API, use the location field.

City Locations

Using place IDs

  1. Find the place ID for a city using the Places API.

  2. Configuration:

    1. For the Events API, use the place.scope field.

    2. For the Features API, use the location field.

For more information on defining locations by API, see API Overview.

Relevant Event Categories

With almost two dozen event categories available, knowing which ones are relevant to your business is essential. We strongly recommend using Demand Analysis to automatically identify important categories for your specific stores or locations. Access Demand Analysis via Control Center or the Beam API. Alternatively, explore these industry-level categories as a starting point:

IndustryRelevant Event Categories

Accommodation

concerts, conferences, expos, festivals, performing-arts

Consumer Packaged Goods

public holidays, performing-arts, conferences, conferences, community

Food and Beverage (also known as Restaurants)

public holidays, performing-arts, conferences, concerts, festivals

Grocery and Supermarkets

public holidays, performing-arts, conferences, conferences, community

Leisure, Travel and Tourism

public holidays, performing-arts, conferences, conferences, community

Marketing

public holidays, performing-arts, conferences, conferences, community

Parking

public holidays, community, concerts, expos, performing-arts

Retail

public holidays, performing-arts, community, conferences, festivals

Transportation and Delivery

public holidays, performing-arts, conferences, conferences, community

Other

public holidays, performing-arts, concerts, conferences, community, festivals, expos, sports

Minimum PHQ Rank

Setting a minimum PHQ Rank is important for focusing on events that are likely to influence your demand, helping to exclude those that are too small or irrelevant. We recommend the following PHQ Rank thresholds:

IndustryMinimum PHQ Rank

Accommodation

35

Consumer Packaged Goods

30

Food and Beverage (also known as Restaurants)

30

Grocery and Supermarkets

30

Leisure, Travel and Tourism

30

Marketing

30

Parking

35

Retail

50

Transportation and Delivery

30

Other

30

Last updated

© 2024 PredictHQ Ltd