Appendix C: Category Mapping Rules

Overview

Nexus Clothing’s 90 unique product types are consolidated into 20 category groups for manageable priority assignment. Each group has a default priority and seasonal modifiers that adjust the priority for each of the four seasons.

The product type naming convention follows a hierarchical pattern:

{Gender}-{Department}-{SubCategory}-{Detail}

Examples:
  Men-Tops-T-Shirts
  Men-Bottoms-Pants-Jeans
  Men-Tops-Outerwear-Jackets-Puffer Jackets
  Headwear-Baseball-Fitted
  Accessories-Bags-Duffle Bags

Category Groups with Member Product Types

Group 1: T-Shirts

Product TypeCount
Men-Tops-T-Shirts1,101
Boys-Tops-T-Shirts139
Men-Tops-Crop-Top46
Men-Tops-Tank Tops23
Total1,309

Group 2: Long Sleeve Tops

Product TypeCount
Men-Tops-T-Shirts-Long Sleeve54
Total54

Group 3: Jeans & Pants

Product TypeCount
Men-Bottoms-Pants-Jeans473
Men-Bottoms-Stacked Jeans148
Boys-Bottoms-Jeans213
Men-Bottoms-Pants-Track Pants76
Men-Bottoms-Pants-Cargo50
Men-Bottoms-Stacked Track Pants14
Total974

Group 4: Sweatpants

Product TypeCount
Men-Bottoms-Pants-Sweatpants37
Men-Bottoms-Stacked Sweatpants57
Total94

Group 5: Shorts

Product TypeCount
Men-Bottoms-Shorts-Denim85
Men-Bottoms-Shorts56
Boys-Bottoms-Shorts37
Men-Bottoms-Shorts-Mesh32
Men-Bottoms-Shorts-Cargo24
Men-Bottoms-Shorts-Basic-Fleece23
Men-Bottoms-Shorts-Fashion-Shorts18
Women-Shorts9
Total284

Group 6: Swim Shorts

Product TypeCount
Men-Bottoms-Shorts-Swim-Shorts40
Total40

Group 7: Hoodies & Sweatshirts

Product TypeCount
Men-Tops-Hoodies & Sweatshirts237
Boys-Tops-Hoodies27
Total264

Group 8: Outerwear - Heavy

Product TypeCount
Men-Tops-Outerwear-Jackets-Puffer Jackets35
Men-Tops-Outerwear-Jackets-Coats-Shearling37
Total72

Group 9: Outerwear - Medium

Product TypeCount
Men-Tops-Outerwear-Jackets-Denim Jackets54
Men-Tops-Outerwear-Jackets-Varsity Jackets33
Men-Tops-Outerwear-Jackets-Fleece7
Men-Tops-Outerwear-Jackets-Sports Jackets10
Men-Tops-Outerwear-Vests31
Boys-Tops-Jackets-Coats41
Boys-Tops-Denim-Jackets24
Total200

Group 10: Outerwear - Light

Product TypeCount
Men-Tops-Outerwear-Jackets-Track Jackets29
Men-Tops-Outerwear-Jackets-Windbreaker10
Total39

Group 11: Headwear - Caps

Product TypeCount
Headwear-Baseball-Fitted262
Headwear-Baseball-Dad Hat260
Headwear-Baseball-Snapback242
Headwear-Baseball-Low Profile Fitted13
Total777

Group 12: Headwear - Cold Weather

Product TypeCount
Headwear-Knit Beanies123
Balaclavas48
Total171

Group 13: Headwear - Summer

Product TypeCount
Headwear-Bucket Hat51
Total51

Group 14: Joggers

Product TypeCount
Men-Bottoms-Joggers60
Boys-Bottoms-Joggers26
Total86

Group 15: Footwear - Sandals

Product TypeCount
Men-Footwear-Sandals & Slides58
Total58

Group 16: Footwear - Shoes

Product TypeCount
Men-Footwear-Shoes41
Women-Footwear-Shoes7
Total48

Group 17: Underwear & Socks

Product TypeCount
Men-Underwear336
Women-Underwear56
Socks116
Boys-Bottoms-Underwear15
Total523

Group 18: Accessories

Product TypeCount
Accessories146
Accessories-Bags-Duffle Bags63
Accessories-Bags-Smell Proof Bags53
Accessories-Bags41
Accessories-Jewelry39
Belts21
Accessories-Bags-Crossbody bags11
Total374

Group 19: Women - Apparel

Product TypeCount
Women-Tops30
Women-Leggings16
Women-Dresses-Mini Dresses9
Other Women-* types~25
Total~80

Group 20: Exclude

Product TypeCount
Bath & Body14
Household Cleaning Supplies-Cloth8
Household Cleaning Supplies-Steel<5
Household Cleaning Supplies-Sponge<5
Gift Cards<5
Insurance<5
UpCart - Shipping Protection<5
Test Category<5
Sample<5
Total~50

Seasonal Priority Matrix

This matrix defines the priority for each category group in each season. It is the core configuration that drives seasonal automation.

#Category GroupWinterSpringSummerFallDefault
1T-Shirts24533
2Long Sleeve Tops43143
3Jeans & Pants44354
4Sweatpants43143
5Shorts03513
6Swim Shorts02502
7Hoodies & Sweatshirts53153
8Outerwear - Heavy51043
9Outerwear - Medium43043
10Outerwear - Light24133
11Headwear - Caps33333
12Headwear - Cold Weather51032
13Headwear - Summer03422
14Joggers43243
15Footwear - Sandals02502
16Footwear - Shoes33333
17Underwear & Socks22222
18Accessories22222
19Women - Apparel23322
20Exclude00000

Reading the Matrix

  • Each cell contains the priority score (0-5) for that category in that season
  • 5 = maximum advertising push (green cells in the UI)
  • 0 = excluded from advertising entirely (grey cells)
  • The “Default” column is used when seasonal automation is disabled or when no season is active
  • Merchants can customize every cell in the Seasons UI

Key Seasonal Patterns

PatternCategoriesRationale
Winter peaksOuterwear - Heavy, Hoodies, Headwear - Cold WeatherPeak demand for cold weather items
Summer peaksShorts, Swim Shorts, T-Shirts, Sandals, Headwear - SummerPeak demand for warm weather items
Year-round stableHeadwear - Caps, Footwear - Shoes, Underwear & Socks, AccessoriesDemand consistent across seasons
Fall spikeJeans & PantsBack-to-school demand
Always excludedExclude group (Bath & Body, Household, Gift Cards)Not suitable for Google Ads

Tag Modifiers

Tag modifiers adjust the seasonal base priority up or down based on the product’s tags. They are applied after the seasonal priority is determined but before the final score is clamped to the 0-5 range.

TagTypeEffectReason
archivedOverrideSet to 0Product no longer active, must be excluded
DEAD50OverrideSet to 0Dead stock at 50% off, not worth advertising
warning_inv_1Adjustment-1Low inventory, reduce spend before stockout
warning_invAdjustment-1Inventory warning, deprioritize
in-stockAdjustment+1Available to ship, boost visibility
NAME BRANDAdjustment+1Premium brand, higher conversion rate
SaleAdjustment-1Already discounted, lower priority

Tag Application Order

Tags are evaluated in the order listed above. Override tags (archived, DEAD50) take immediate effect and short-circuit all further evaluation. Adjustment tags are cumulative but the final score is clamped to the 0-5 range.

EXAMPLE: Tag Modifier Application
==================================

  Product: "Jordan Craig Stacked Jeans"
  Category: Jeans & Pants
  Season: Winter
  Seasonal priority: 4

  Tags: jordan-craig, NAME BRAND, in-stock

  Step 1: Check overrides
    - No "archived" tag  -> continue
    - No "DEAD50" tag    -> continue

  Step 2: Apply adjustments
    - "NAME BRAND" -> +1 -> priority = 5
    - "in-stock"   -> +1 -> priority = 6 -> clamped to 5

  Final priority: 5
EXAMPLE: Override Tag
=====================

  Product: "Old Season Hoodie"
  Category: Hoodies & Sweatshirts
  Season: Winter
  Seasonal priority: 5

  Tags: archived, DEAD50, NAME BRAND

  Step 1: Check overrides
    - "archived" found -> OVERRIDE to 0
    - Return immediately (skip all other modifiers)

  Final priority: 0

New Arrival Boost

Products created within the configured threshold (default: 14 days) receive a minimum priority of 5, regardless of their category or seasonal assignment. This ensures new products get immediate advertising visibility.

SettingDefault ValueConfigurable
Days threshold14Yes (per store)
Minimum priority5Yes (per store)
Override locked productsNoNo (locked products are never auto-changed)

The new arrival boost is applied after tag modifiers but does not override exclusion tags. A new product tagged archived or DEAD50 still receives priority 0.