skills/meta-analytics-ops/meta-roi-framework/SKILL.md
--- name: meta-roi-framework description: Calculates and presents the ROI of the client's social media and digital marketing investment using the Bodnar and Cohen (2012) formula: ROI = (TLV − COCA) ÷ COCA. Produces a step-by-step TLV calculation, COCA by channel, ratio benchmarks, attribution guidance, break-even analysis, a 12-month projection table, and consultant talking points for retainer justification. Invoke this skill when a client questions the value of the retainer, when preparing a pr
npx skillsauth add peterbamuhigire/social-media-skills skills/meta-analytics-ops/meta-roi-frameworkInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
SKILL.md; do not skip mandatory steps or required fields.references/ directory is added later, treat its files as the deeper source material and keep this SKILL.md execution-focused.Before generating the ROI analysis, collect the following from the consultant:
If the client cannot provide exact figures, ask for a reasonable estimate and document all assumptions in the output.
Generate all seven sections below in order.
Apply the formula from Bodnar and Cohen (2012):
TLV = Average transaction value × Transactions per year × Customer relationship length (years)
Walk through the calculation step by step:
| Input | Client value | |---|---| | Average transaction value | [Currency] [Amount] | | Average transactions per year per customer | [Number] | | Average customer relationship length | [Number] years | | Total Lifetime Value (TLV) | [Currency] [Amount] |
Worked example (Uganda context): A Kampala accounting firm charges UGX 1,200,000 per quarterly filing per client. The average client files 4 times per year and stays for 3 years. TLV = UGX 1,200,000 × 4 × 3 = UGX 14,400,000
Produce the same worked example using the client's actual figures.
Note: If the client serves both high-value and low-value customer segments, calculate TLV separately for each segment. Use the segment most relevant to the digital acquisition strategy as the primary figure.
Apply the formula:
COCA = Monthly social media spend ÷ New customers acquired per month via that channel
| Channel | Monthly spend allocated | New customers/month | COCA | |---|---|---|---| | Facebook (organic + ads) | [Currency] [Amount] | [Number] | [Currency] [Amount] | | Instagram (organic + ads) | [Currency] [Amount] | [Number] | [Currency] [Amount] | | WhatsApp (broadcast + referral) | [Currency] [Amount] | [Number] | [Currency] [Amount] | | LinkedIn (if applicable) | [Currency] [Amount] | [Number] | [Currency] [Amount] | | TikTok (if applicable) | [Currency] [Amount] | [Number] | [Currency] [Amount] | | Total (all channels combined) | [Currency] [Amount] | [Number] | [Currency] [Amount] |
Where channel-level attribution is not available: Use total monthly investment ÷ total new customers from digital channels as the blended COCA. Note this as an estimate in the output and recommend the client implement enquiry source tracking (see Section 4).
Where new customer numbers are unknown: Use enquiry volume as a proxy (COCA per enquiry) and apply the client's conversion rate to estimate COCA per customer. State all assumptions clearly.
The CAC Cap Rule (Kahan, 2022): Customer Acquisition Cost must not exceed 25% of average Customer Lifetime Value. Formula: CAC ≤ (CLV × 0.25). Apply this as the budget governance ceiling when presenting investment recommendations to clients or boards. If the current CAC exceeds 25% of CLV, the programme is structurally unprofitable regardless of gross revenue.
Calculate the ratio: TLV ÷ COCA
| Metric | Value | |---|---| | TLV | [Currency] [Amount] | | COCA | [Currency] [Amount] | | TLV:COCA ratio | [X]:1 |
Benchmark interpretation:
| Ratio | Interpretation | Action | |---|---|---| | 10:1 or above | Excellent — significant return on acquisition spend | Increase investment in what is working; scale the best-performing channel | | 5:1 to 9:1 | Healthy and sustainable | Maintain current approach; optimise underperforming channels | | 3:1 to 4:1 | Borderline viable — monitor closely | Identify the highest-COCA channel and reduce spend there; focus on conversion rate improvement | | Below 3:1 | Acquisition cost is too high relative to customer value | Either grow TLV (raise prices, add upsell, increase retention) or reduce COCA (better targeting, improved conversion funnel) |
State clearly where the client sits and what this means for the retainer decision.
If TLV cannot be calculated (e.g., the client cannot estimate relationship length): Use a conservative single-transaction value as TLV and note this understates the true return. Recommend the client track customer retention data.
Supplement the top-down ROI formula with a bottom-up model that works backwards from a revenue target through funnel conversion rates to required inquiry volumes (Kahan, 2022). This produces more defensible budget recommendations than working forwards from spend.
Step 1: State the quarterly revenue target in UGX. Step 2: Divide by average deal size → number of new clients needed. Step 3: Divide by opportunity-to-deal CVR (benchmark: 40%) → opportunities needed. Step 4: Divide by lead-to-opportunity CVR (benchmark: 25%) → qualified leads needed. Step 5: Divide by inquiry-to-lead CVR (benchmark: 3%) → total inquiries needed. Step 6: Allocate required inquiries by channel based on historical contribution or targets.
Reference meta-revenue-planning for the full worked example.
Pipeline Stage Weighting (Kahan, 2022): For quarterly revenue forecasting, weight pipeline opportunities by stage rather than counting all pipeline at full value.
Weighted pipeline = more realistic forecast than unweighted pipeline total.
Deal Velocity as an ROI Component: Faster conversion reduces the time-cost of capital and increases revenue per quarter at the same spend. Measure and report velocity in days at each funnel stage: inquiry-to-lead, lead-to-opportunity, opportunity-to-deal, and end-to-end. Include velocity targets in the ROI framework — they are as important as the cost targets (Kahan, 2022).
CLV by Acquisition Cohort (Zahay et al., 2024; Raaz, c.2023): Replace single-average CLV with cohort-based LTV calculation. Calculate CLV separately for customers acquired through each channel — organic social, paid social, referral, email, events. This reveals which channels produce durable, high-value customers vs. one-transaction buyers. Note the benchmark: average repeat customers spend 67% more in months 31–36 than in months 1–6 — a data point that consistently justifies retention investment over acquisition-only strategies.
Attribution Model Note: ROI calculations depend on how revenue is attributed to channels. Select an attribution model before the campaign begins, not after. See 06-digital-marketing-strategy references section for the full six-model attribution selection guide (Hanlon and Tuten, 2022). Apply the chosen model consistently across the full strategy period before switching.
For service businesses and B2B clients where direct digital attribution is difficult, implement the following tracking approach:
Step 1 — Enquiry source logging Ask the client to record where every new enquiry comes from. Log the following for every new enquiry:
| Field | Options | |---|---| | Enquiry date | DD/MM/YYYY | | Enquiry channel | WhatsApp / Facebook DM / Instagram DM / Phone call / Walk-in / Website form / Referral / Other | | Referral source (if applicable) | Which social content, post, or profile triggered the referral | | Converted to sale? | Yes / No / Pending |
Review this log monthly as part of the reporting cycle.
Step 2 — UTM link tracking Place UTM-tagged links in all social media bios and any posts that direct traffic to the website. Use Google Analytics (free) to see which platform and which specific posts drive website visits and form submissions. UTM parameters: source, medium, campaign, content.
Step 3 — Monthly enquiry source report Each month, count enquiries by source. This becomes the input for COCA calculation and shows directional channel performance.
Important caveat: Attribution is never perfect for social media. Social content influences purchasing decisions that are tracked to other channels (e.g., a customer sees an Instagram post, then calls the business directly). The goal of this methodology is directional understanding — not accounting-level precision.
Calculate how many new customers per month are needed to cover the social media investment:
Break-even customers = Monthly investment ÷ (TLV × Gross margin %)
| Input | Value | |---|---| | Monthly social media investment | [Currency] [Amount] | | TLV | [Currency] [Amount] | | Gross margin % | [%] | | TLV × Gross margin | [Currency] [Amount] | | Break-even customers per month | [Number — round up] |
Worked example (Uganda context): A Kampala interior design firm invests UGX 3,500,000 per month in social media (retainer + production). TLV per client is UGX 12,000,000. Gross margin is 35%.
Break-even = UGX 3,500,000 ÷ (UGX 12,000,000 × 35%) = UGX 3,500,000 ÷ UGX 4,200,000 = 0.83 → 1 new client per month breaks even
Produce the same calculation using the client's actual figures. Frame the result in plain language: "If social media brings in just [X] new customers per month, the investment pays for itself."
Build a monthly projection using a conservative new customer estimate (use the current monthly average, or the break-even number if current data is unavailable).
| Month | Projected new customers from social | COCA (est.) | TLV per customer | Monthly ROI | Cumulative ROI | |---|---|---|---|---|---| | Month 1 | | | | | | | Month 2 | | | | | | | Month 3 | | | | | | | Month 4 | | | | | | | Month 5 | | | | | | | Month 6 | | | | | | | Month 7 | | | | | | | Month 8 | | | | | | | Month 9 | | | | | | | Month 10 | | | | | | | Month 11 | | | | | | | Month 12 | | | | | | | Total | | | | | [Cumulative ROI] |
Monthly ROI formula: (TLV × customers acquired − Monthly investment) ÷ Monthly investment × 100
Note: These projections are estimates based on current trends. Revisit and update this table quarterly using actual customer acquisition data.
Use these points when presenting the ROI analysis to the client:
Framing the retainer fee Do not present the retainer as a standalone cost. Present it relative to TLV: "Our monthly investment of [amount] needs to bring in [break-even number] new customers to pay for itself. Based on current enquiry volumes, we are [above / at / approaching] that threshold."
The break-even argument "You do not need social media to bring in all your customers — only enough to justify the investment. At your TLV of [amount] and a gross margin of [%], you need [X] new customers per month from digital channels. We are currently tracking [Y] enquiries per month from social media."
Comparison to traditional marketing If data allows, compare COCA via social media to the client's cost per referral via traditional marketing (events, print advertising, sales calls). Social media at scale often has a lower COCA than traditional methods — use this comparison if the numbers support it.
When COCA is above the benchmark Do not deflect. Acknowledge it and recommend the specific action: "Our COCA is currently above the 5:1 benchmark. The most effective action is [grow TLV with a loyalty programme / improve our conversion rate from enquiry to sale / reduce ad spend on [underperforming channel] and reallocate to [higher-performing channel]]."
Long-term framing Social media builds brand equity that is not captured in COCA. Organic reach, follower growth, and content library value compound over time. The ROI calculation covers direct acquisition — the full picture includes brand value that is harder to quantify but real.
Hahn (2003)
When a client has a customer database and needs to prioritise who to contact first (for a campaign, a renewal, or a direct mail programme), apply FRAT scoring:
| Letter | Factor | Question | |---|---|---| | F | Frequency | How many times has this contact bought or enquired? | | R | Recency | How recently did they last buy or enquire? | | A | Amount | What is their average transaction value? | | T | Type | What type of product or service do they purchase? |
Score each contact on all four criteria (1–5 per factor). Sort by total score descending. The highest-scoring contacts are the most responsive and should be contacted first, most often, and with the most effort.
Hahn (2003)
Before committing to any direct marketing campaign (email, direct mail, WhatsApp broadcast), check budget viability:
For every UGX 20,000 (or equivalent USD $20) of projected revenue per transaction, the campaign can afford to invest UGX 1,000 (or USD $1) per contact reached.
Examples:
Use this to guide format decisions and campaign feasibility before recommending any outbound activity.
Output meets the standard if it:
Apply the ROI formula (Bodnar and Cohen, 2012): ROI = (TLV − COCA) ÷ COCA. Apply the POEM model when attributing spend across paid, owned, and earned channels.
Bodnar, K. and Cohen, J. (2012) The B2B Social Media Book. Hoboken: Wiley. Chaffey, D. (2024) Digital Marketing: Strategy, Implementation and Practice. 8th edn. Harlow: Pearson.
tools
Generates a foundational social media training guide for clients and their teams who are completely new to social media marketing, or who have been posting without any strategic understanding. Invoke when the user says "write a social media basics guide", "create a beginner training document", "the client doesn't understand social media", "start-here training", or when a client needs to understand social media before any strategy or content work begins. Distinct from training-client-team (operational handover of an existing strategy) and training-diy-content (content creation for self-managing clients). This skill covers what social media is, how it works, and how to approach it intelligently — the conceptual foundation that makes all downstream strategy work land.
tools
Generates a practical smartphone video production training guide for East African clients and content teams. Covers shooting, audio, lighting, framing, editing, and platform-specific formats using only a smartphone — no professional equipment required. Invoke this skill when a client or their team needs to produce their own social video content and requires a hands-on, jargon-free training document tailored to EA field conditions.
tools
Generates a complete DIY content creation handbook for clients who want to manage some or all of their own content after the initial strategy engagement. Invoke when the user says "write a DIY content guide", "create a self-managed content handbook", "the client wants to manage their own content", or when a handover guide is needed at the end of a strategy engagement. Output is a self-contained reference document — not a training presentation — that the client keeps and uses independently.
tools
Generates a complete 2-hour in-person training workbook for a client's internal team — employees who will assist with content creation or community management. Invoke when the user says "create a team training guide", "write a staff training workbook", "onboard our internal team on social media", or needs a printable workshop document for client employees. Output is a structured, print-ready workbook — not a presentation deck.