Skip to content
Available skills

set-up-product-segmentation skill

The skill an agent uses to choose the custom labels for your segments, tune Product Segmentation settings and product rules, and generate the feed, after you confirm each change.

set-up-product-segmentation sets where your segments go and what they are based on: the Merchant Center custom labels, the segmentation settings and product rules for Shopping and Performance Max. It previews every change, shows you what it would move between segments, and saves only the exact change you confirm.

Use it for

Custom labels, date range, margin (POAS), a target ROAS anchor, excluded campaigns and product rules.

Works through

The CLI settings, product-rules, feed-source-settings and feed commands, or MCP execute.

You get

A preview of each change, then a saved change you confirmed and a fresh feed.

The skill

Full file: on GitHub or at /.well-known/agent-skills/set-up-product-segmentation/SKILL.md.

pnpm dlx skills add product-metrics/skills \
  --skill set-up-product-segmentation

When an agent uses it

  • “Write my segments to custom label 2 instead of 0.”
  • “Judge my products on margin, not revenue.”
  • “Keep the winter jackets in Stars until the sale ends.”

Example conversation

You:    Judge my products on margin instead of revenue.
Agent:  productmetrics settings get --property-id ... --json
        productmetrics settings preview-strategy --property-id ... --body-file draft.json
        With margin (POAS) on: 38 products move between segments,
        11 of them out of Stars. 2 Stars are out of stock.

        I'll change one field: strategy_adjustments.margin_poas.enabled → true.
        Save it?
You:    Yes.
Agent:  productmetrics settings update ... --if-match '"4"'
        Saved. The feed updates tonight, or now if you want.

Example data.

Commands and tools it uses

StepCLI (operation)
Readproductmetrics settings get (settings.get), productmetrics feed-source-settings get, productmetrics product-rules list, productmetrics product-rules get-impact
Custom labelsproductmetrics feed-source-settings update (feed_source_settings.update)
Previewproductmetrics settings preview (settings.preview), productmetrics settings preview-strategy (settings.preview_strategy), productmetrics product-rules preview
Saveproductmetrics settings update (settings.update, with --if-match)
Product rulesproductmetrics product-rules create, update, toggle, reorder, delete
Feedproductmetrics feed generate (feed.generate)

Saves need the write scope and an editor or admin; the feed needs a Product Segmentation subscription. Merchant Center must be connected first: connect-google-ads.

Moving the segments to another custom label means campaigns that filter on the old label stop matching. The skill tells you which campaigns to change in Google Ads; you make that change.

Where next