Start with the decision
Choose a task.
Follow the evidence.
Four routes through the library. Each moves from a working definition to an example, tool, or release check you can inspect.
Make product data usable
Resolve identity, measurements, compatibility, and purchase conditions, then verify the destination record.
Product data an agent can use without guessing. ↗
A practical product-data contract for variants, dimensions, availability, provenance, and unknown values, with a downloadable JSON example.
SKU vs GTIN: differences, barcodes, and variant IDs ↗
Compare SKU, GTIN, UPC, and variant IDs with examples. Check a product record in your browser for identifier and variant issues; download the review.
Missing GTIN: when to use identifier_exists in Google feeds ↗
Decide whether a missing GTIN is unknown or genuinely unassigned. Use six worked cases and an evidence worksheet before changing identifier_exists.
Product data ownership: resolve a price conflict ↗
A field-ownership register for PIM, ERP, storefront, and feed data, with a worked correction and explicit release checks.
Product dimensions: what 0.5 means & unit converter ↗
What does a product height or length of 0.5 mean? Convert it to millimetres and check whether you’re reading the product size or the shipping package.
Product dimensions in structured data across four retailers ↗
A 12-listing audit compares visible product and package dimensions with Schema.org markup at IKEA, Ashley, World Market, and Burrow.
Comparing product dimensions across country pages: a 30-listing audit ↗
Eight complete comparisons, twenty retrieval gaps and two axis gaps: a reproducible audit of displayed product dimensions on sampled IKEA US and GB pages.
Product compatibility data: prove the exact accessory match ↗
Separate compatible products from related products. Use exact model pairs, revisions, adapters, and source evidence, with a downloadable decision ledger.
Shipping and return policy data for shopping agents ↗
Compare delivery charges, handling time, return windows, and policy exceptions in one scoped record. Includes fictional offers and a reusable JSON worksheet.
Product feed specification: Shopify, Google, and ChatGPT ↗
Map 20 product feed fields across Shopify, Google Merchant Center, and ChatGPT. Compare IDs, price, stock, and variants; download the JSON reference.
Why feed price and Offer.price can differ without an error ↗
Reconcile regular and sale prices across a feed, product page, checkout, and structured data. Keep currency and context explicit; download eight review cases.
Sale price effective date: format, timezone & examples ↗
Format sale_price_effective_date for Google Merchant Center. Enter local start and end times, check the UTC offsets, and see a worked daylight saving example.
Can you copy a product feed unchanged? A 12-case test ↗
Inspect twelve synthetic product records or check your own JSON locally. Review explicit mappings, unresolved fields, and supplied evidence; download reproducible results.
ChatGPT product feeds: sale prices, stock changes, and stale-data checks ↗
Check current price and stock evidence against a ChatGPT product-feed snapshot. Includes a local checker, six fictional cases, and explicit timestamp rules.
Why a product feed check can pass while the records disagree ↗
Five reproducible synthetic source/feed pairs separate single-record checks from price agreement, exact identity and fresh evidence. Includes inputs, results and runner.
Does the product page match the variant you submitted? ↗
A six-case acceptance test for variant identity, price, availability, and missing facts, with reusable JSON fixtures.
Product variant URLs: what eight public pages actually selected ↗
An executed eight-variant study of URL selection, rendered options and JSON-LD offers, with captured facts and replayable extraction tests.
Google product category vs. product type: Shopify lookup ↗
Look up a Shopify category to find the mapped Google Shopping ID and breadcrumb. Compare google_product_category with your store’s product_type.
Shopify to Google product category mapping across three releases ↗
Compare Shopify’s August, October, and November 2026 mappings to Google Shopping. Inspect category IDs, worked examples, and reproducible results.
Content API 410 Gone: diagnose the sunset and review your migration ↗
Identify a Content API sunset error, find the integration owner, and review a Merchant API cutover with eight evidence checks and a downloadable worksheet.
Check the commercial decision
Reconcile the revenue, account for returns, and test whether stock supports more advertising.
ROAS calculator: break-even and contribution ↗
Calculate ROAS, contribution after advertising, and the break-even return for your margin. Includes worked examples and a margin comparison.
Why retail-media revenue and settled orders disagree ↗
Bridge ad-attributed sales to a defined order ledger, preserve unresolved differences, and keep bank payouts separate. Includes a worked USD example and CSV/JSON worksheet.
Is the campaign still profitable after returns? ↗
A worked order-cohort reconciliation for refunds, recovered inventory, return costs, and ad spend, with a reusable review template.
Can your stock support more ad spend? ↗
An inventory and ad-spend calculator with daily stock checks, a delayed-delivery example, and a downloadable decision worksheet.
A working contribution API integration: 14 acceptance cases ↗
Run a real, bounded contribution API check. Inspect exact requests and responses, preserve losses and null ratios, and hold mismatched currency or cohort metadata before calling.
Release agent-assisted work
Choose a bounded workflow, define acceptance, and count the effort needed to deliver it.
Agentic commerce starts with an operating model. ↗
A practical framework for choosing agent-assisted commerce work, setting decision rights, and proving that the result is worth the cost.
From request to release: a supervised commerce workflow. ↗
An original seven-stage operating checklist for turning agent-assisted commerce work into an inspectable, authorized, verified release.
How do you check AI product copy before publishing? ↗
A claim-by-claim review method, six failure cases, and a reusable evaluation brief for AI-assisted product descriptions.
Did AI save time after review and rework? ↗
Compare the full cost of accepted work, including preparation, supervision, review, and corrections. Includes a local calculator and a reusable time ledger.
Traffic fell: repair, refresh, or publish a new page? ↗
A practical editorial decision worksheet for separating technical faults, incomplete measurements, overlapping answers, and useful new research when traffic falls.
Measure visibility, attribution, and visits
Check access first, then separate exposure, visits, and outcomes before choosing an improvement.
Make a website easy for agents to find, read, and use. ↗
An evidence-based guide to crawler access, HTML, structured data, Markdown, llms.txt, feeds, and real tool descriptions.
AI visibility metrics: impressions, citations, referrals, and outcomes ↗
A source-linked metric dictionary for people and agents building AI visibility reports. Includes units, formulas, interpretation limits, and a versioned JSON download.
How to read Search Console’s generative AI report ↗
Measure Google AI Overviews and AI Mode exposure, avoid double counting, and turn an impression report into a useful content decision. Includes a review worksheet.
How to measure AI citations and visible brand attribution ↗
A repeatable rubric for checking whether an AI answer consulted, linked, displayed, or named your source. Includes a blank ledger and calibration examples.
How to find referral traffic in GA4, including AI ↗
Find referring sites in GA4, separate Referral from AI Assistant, and check Google AI traffic. Includes report steps and a downloadable review worksheet.
Why Search Console, GA4, and Vercel show different traffic numbers ↗
Compare clicks, sessions, and page views without forcing the totals to match. Includes a worked example and a reusable reconciliation worksheet.
Search impressions but no clicks: a diagnostic and planning calculator ↗
Work backward from a click target, test CTR assumptions, and choose a useful response to search exposure with few visits. Includes a local calculator and worked scenarios.
Measure AI visibility without confusing it with traffic. ↗
A measurement framework that separates crawler access, answer citations, referral visits, and qualified commercial outcomes.
Inspect the sources.
The source directory connects original documentation to the guides that cite it. Check the source notes before carrying a claim into your own work.
Bring the artifacts.
Agent access lists Markdown, JSON, downloads, and the calculation API. The public artifact repository includes the reproducible feed experiment and links back to its methodology.