Marketing Measurement
Calculate ROAS, marketing efficiency and new-customer CAC with explicit attribution, spend and customer rules.
At a glance
Marketing Measurement is an AI skill for sales & marketing and finance & operations teams that you can use in Claude Code, Codex, or type.com.
- Updated
What it does
- Separate business sales from overlapping platform revenue claims.
- Show the formula and scope behind every ROAS, MER and CAC result.
- Flag incomplete spend feeds, customer history and attribution settings.
Before you start
- Revenue Definitions and the business's approved sales measure.
- Marketing spend, attribution settings and qualified customer history.
See an example
Example output from a sample run. Company names and figures are sample data.
Marketing measurement: Northwind Goods, August (USD)
Headline: paid media returned 3.33x on business net sales. Fully loaded MER was 2.50x, and new-customer CAC was 80.
| Metric | Numerator | Denominator | Result |
|---|---|---|---|
| Meta platform ROAS | Meta-claimed revenue 70,000 | Meta spend 20,000 | 3.50x |
| Google platform ROAS | Google-claimed revenue 50,000 | Google spend 10,000 | 5.00x |
| Media-only efficiency | Business net sales 100,000 | Paid media spend 30,000 | 3.33x |
| Fully loaded MER | Business net sales 100,000 | Marketing cost pool 40,000 | 2.50x |
| New-customer CAC | Marketing cost pool 40,000 | 500 new customers | 80 / customer |
Watch out: Meta and Google together claim 120,000 in revenue, but the business made 100,000. Platform numbers overlap, so don't add them up as sales.
Inputs used: Shopify net sales (reconciled), Meta and Google spend exports, agency and creative costs (10,000), first-order history back to Jan 2024. Attribution: 7-day click, 1-day view on both platforms.
How to use Marketing Measurement
- type.com: Choose Use Skill to add Marketing Measurement to your type.com workspace.
- Claude Code: Download the skill and extract it into
~/.claude/skills/marketing-measurement/(or.claude/skills/marketing-measurement/in a project). Then ask Claude to use Marketing Measurement. - Codex: Download the skill and extract it into
~/.agents/skills/marketing-measurement/(or.agents/skills/marketing-measurement/in a repository). Then ask Codex to use Marketing Measurement.
AI agents can read this page as Markdown or fetch the raw SKILL.md.
Frequently asked questions
What is Marketing Measurement?
Marketing Measurement is an AI skill for sales & marketing and finance & operations teams that you can use in Claude Code, Codex, or type.com.
What does Marketing Measurement do?
Calculate ROAS, marketing efficiency and new-customer CAC with explicit attribution, spend and customer rules.
What do I need to use Marketing Measurement?
Revenue Definitions and the business's approved sales measure; Marketing spend, attribution settings and qualified customer history.
Can I use Marketing Measurement in Claude Code or Codex?
Yes. Marketing Measurement is a standard Agent Skills folder with a SKILL.md file. Download it and extract it into ~/.claude/skills/ for Claude Code or ~/.agents/skills/ for Codex.
Who created Marketing Measurement?
The type.com team created Marketing Measurement. The type.com team reviews every skill before it is published in the Skills Library.
Related skills
- Budget PacerProject month-end spend from a trailing run rate across campaigns and clients, flag over- and under-delivery beyond a tolerance, and recommend per-campaign daily budgets that reconcile exactly to each client's committed total.
- BFCM Cohort QualityFind out if last Black Friday's new customers were worth it: contribution, repeats and payback vs October and January buyers, by discount, source and product.
- Holiday Support MacrosPrepare your support team for BFCM: forecast holiday tickets and staffing, find policy gaps and stale macros, and generate holiday macros built only from your written policies.
- Holiday Shipping Cutoff CheckerFind the last day customers can order on each shipping service and still get it by the holiday, check every delivery promise against it, and plan the switch to expedited and e-gift cards.
- BFCM Live PulseTurn hourly sales and ad spend into a BFCM status update with sales pacing, budget guardrails, checkout alerts, code-use anomalies and stock risk.
- BFCM Offer & Discount Config QACheck your Shopify BFCM discounts against the offer plan before launch: stacking, sale windows, who gets each discount, code limits and free shipping, with test carts and a dated fix list.
Related guide
Browse the technical files
--- name: marketing-measurement description: Configure and calculate ROAS, marketing efficiency ratio (MER), and new-customer CAC using a business's approved revenue, spend, customer and attribution definitions. Use when marketing dashboards disagree, when setting attribution windows, or when comparing platform claims with actual sales. --- # Marketing Measurement ## Shared definitions prerequisite Read and apply the [Revenue Definitions skill](https://type.com/library/skills/revenue-definitions) before this workflow. If installed as sibling folders, read `../revenue-definitions/SKILL.md`; otherwise load the installed skill by name or obtain its published instructions. Reuse the business's existing approved definition file. If it is missing, establish it with Finance through that skill; never infer approval or overwrite another client's rules. Build a reusable measurement specification and a source-backed metric table. Keep revenue accounting separate from attribution. Leave monthly client narrative, budget pacing, cohort LTV and media execution to their respective workflows. ## Agree the measurement basis Read the Finance-approved revenue definition and any existing `marketing` section of `finance/revenue_definitions.json`. Confirm the period, entity, markets, channels, timezone, reporting currency and revenue version. Resolve missing choices with Marketing and Finance: - Which sales measure and business scope belong in each numerator? - Which spend sources and costs belong in each denominator? - Which purchase/conversion event, attribution model, click/view windows and date basis apply per platform? - What counts as a new customer, at what identity grain, over what history? - Which periods are mature enough to compare, and when do late conversions/refunds restate results? Record the agreed specification, approvers, effective date and source settings evidence. Reuse existing definitions rather than creating a conflicting contract. Retain established library marketing keys and document additional detail separately where consumer support is unverified. ## Build trusted inputs Use connected ad platforms, approved warehouse models, financial cost records or supplied exports. Save the query/script, mapping and parameters. **Revenue:** use the approved deduplicated sales report for business totals. Record its reconciliation status. Platform conversion values are separate claimed revenue and may use different refund, tax and shipping treatments. **Spend:** define a cost taxonomy and one authoritative source per cost category: media, agency, creative, influencer, affiliate or other approved marketing costs. Specify cash versus accrual, currency and allocation period. Do not count both an ad-platform cost and the invoice paying for it. Deduplicate overlapping campaign/account totals. Missing networks/costs are unknown, never zero. **Customers:** count distinct identities whose first qualifying purchase falls in the period under the approved rule. Do not substitute orders, platform conversions or first purchases visible in a short export. Record historical coverage, identity matching, guest/merged customer handling, cancelled/refunded first purchases and marketplace visibility. If identities cannot be joined across channels, report a scoped denominator or withhold enterprise-wide CAC; do not assume every marketplace buyer is new. **Attribution:** capture actual account/report settings or request parameters, including click and view windows, model, conversion action, conversion-versus-interaction date, timezone and extraction time. A label typed into a configuration file does not prove the export used it. Mark unverified settings and avoid direct comparisons where settings differ. ## Calculate explicit formulas | Metric | Formula | Required label | |---|---|---| | Platform ROAS | That platform's attributed purchase value ÷ that platform's ad spend | Platform, conversion event, model/window, date basis and value treatment | | First-party attributed ROAS, if available | Deduplicated revenue credited by the agreed first-party model ÷ matched ad spend | Model, coverage, identity gaps and allocation policy | | MER | Approved business net sales ÷ approved total marketing spend | Included sales channels and cost categories; display as x | | Paid-media efficiency, if only media is available | Approved business net sales ÷ paid-media spend | Media-only; do not label fully loaded MER | | New-customer CAC | Approved acquisition/marketing cost pool ÷ distinct qualifying new customers | Exact cost pool, customer scope and history coverage | Never sum Meta, Google and TikTok claimed revenue and call it total sales. Do not average daily/channel ratios: aggregate aligned numerators and denominators, then divide. First-party attribution must conserve the eligible revenue total, including unattributed revenue, with each order allocated no more than once in total. If the business calls spend ÷ revenue “MER,” preserve the original label in the mapping but display the formula prominently and label the normalized output **marketing spend as % of revenue**. Do not silently invert it. Use N/A with a reason for missing or zero denominators. Flag negative revenue periods and explain their effect. A new-customer count of zero does not imply zero CAC. With incomplete inputs, show supported components and label affected ratios unavailable or explicitly partial. ## Interpret with care Platform ROAS measures attributed performance, not incremental causal lift or profit. MER includes organic and returning-customer revenue; it is not channel attribution. Period CAC is not automatically cohort CAC or CAC payback. Align scope and maturity before period comparisons. Split or flag changes in attribution settings, revenue rules, FX policy and cost coverage. Do not infer that a campaign caused a revenue change from correlation alone. ## Deliver and verify Return the measurement specification and a table with metric, value, numerator, denominator, period/scope, source references, definition version, attribution settings, data-through date and completeness status. Summarize measurement gaps with owners and next checks. Reuse these outputs in Client Report Builder rather than duplicating its presentation workflow. Synthetic check: business net sales 100,000; Meta spend 20,000 and claimed revenue 70,000; Google spend 10,000 and claimed revenue 50,000; other approved marketing cost 10,000; 500 qualified new customers. Platform ROAS is 3.50x and 5.00x; media-only efficiency is 3.33x; fully loaded MER is 2.50x; CAC using that same approved 40,000 cost pool is 80. Claimed revenue of 120,000 is not sales. These figures are illustrative, never a benchmark. Do not change budgets, campaigns, attribution settings or customer records.