HeroMatrix Changelog & Release Notes

All notable changes and updates to HeroMatrix: The Profit-First Product Labelizer are documented below. This project follows Semantic Versioning.

[1.0.0] - 2026-10-30

Added

• 6-Tier Superhero Product Segmentation: Automatically segments Google Ads Shopping and Performance Max products into Superhero, Hero, Sidekick, Anti-Hero, Villain, and Ghost custom labels, with automatic cascading when specific tiers are disabled.
• 4 Profit & ROAS Evaluation Modes:
  • ROAS Mode: Pure ROAS evaluation using Google Ads conversion value and cost.
  • Flat Margin Mode: Multiplies a global margin rate by live catalog prices from Google Ads to enforce unit-margin CPA and spend caps without an external margin spreadsheet.
  • Variable Margin Mode: Evaluates per-product unit margins (dollar, percentage, or Price minus COGS) from Google Sheets, with automatic fallback to flat margin rates or account-level defaults.
  • Hybrid Margin Mode: Grades converting sellers by ROAS while capping 0-sale bleeder spend using per-product unit margins.
• Fractional Attribution & Conversion Lag Safeguards:
  • Minimum sales threshold prevents tiny fractional conversions from triggering distorted CPA calculations.
  • Stabilized CPA calculation for fractional sellers between 0.50 and 1.0 conversions.
  • Lookback offset option to exclude recent days and account for conversion lag.
• Permanent Villain Suppression: Optional Google Sheets ledger that tracks and permanently isolates chronic 0-sale budget bleeders across rolling lookback windows.
• Conversion Action Filtering & ID Normalization:
  • Filter conversions by a specific Google Ads Conversion Action ID (supports Primary and Secondary conversion actions).
  • Regex and callback-based Product ID formatter to match Merchant Center and Margin Sheet item IDs.
• Automated Google Sheets Reporting & Dry Run Mode:
  • Generates a Merchant Center supplemental feed tab (Products), an executive summary dashboard with a distribution chart (Overview), a historical Label Trends log, and an execution Logs tab.
  • Built-in Dry Run mode to preview label distributions in test tabs before modifying live production feeds.