本文へ移動
cccskills
無料GitHub で公開

"ecom-promo-roi"

"Calculate and analyze promotional ROI including incremental sales lift, margin impact, and promo type comparison. Use this skill when the user needs to evaluate whether a promotion was profitable, compare promotion types, simulate promo scenarios, or optimize promotional spending — even if they say 'was this sale worth it', 'which promo type works best', 'are we giving away too many discounts', or 'plan our next promotion'.".

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.3 KB
  • examples/sample_scenario.md4.3 KB
  • references/promo-testing.md10.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Promotion ROI Analysis

Framework

IRON LAW: Measure INCREMENTAL Sales, Not Total Sales During Promo

A promotion that generates $100K in revenue during a sale week looks great —
until you realize $80K would have happened anyway (baseline). The incremental
lift is only $20K. If the discount cost $25K in margin, the promo LOST money.

Promo ROI = (Incremental Revenue × Margin - Promo Cost) / Promo Cost

Key Metrics

MetricFormula
Incremental RevenuePromo period revenue - Baseline revenue (what would have happened without promo)
Promo CostDiscount amount + marketing spend + operational cost
Promo ROI(Incremental Gross Profit - Promo Cost) / Promo Cost
Cannibalization Rate% of promo sales that would have occurred at full price
Pull-Forward Rate% of promo sales that are just earlier purchases (customers would have bought next week anyway)

Promo Type Comparison

TypeMechanismProsCons
% Discount20% off everythingSimple, high trafficErodes brand, trains discount-waiting
$ OffNT$200 off orders >NT$1000Drives AOV upLess exciting for low-AOV customers
BOGOBuy one get one freeMoves inventory fast50% margin hit, attracts deal-seekers
Gift with purchaseFree item with min spendProtects price perceptionCost of gift, may not drive incremental
Flash saleTime-limited deep discountUrgency, high engagementOperational stress, cannibalization
Loyalty pointsEarn/redeem pointsBuilds retention, deferred costComplex to manage, redemption liability

Analysis Steps

Phase 1: Establish Baseline

  • What would revenue have been without the promo? (prior period, prior year same period, or control group)
  • Account for seasonality, day-of-week effects, and trend

Phase 2: Calculate Incremental Impact

  • Total promo revenue - baseline = incremental
  • Subtract cannibalization and pull-forward estimates
  • Calculate gross profit on incremental (not revenue)

Phase 3: Calculate Full Cost

  • Discount dollars given up
  • Marketing spend (ads, email, creative production)
  • Operational cost (warehouse overtime, customer service spike)

Phase 4: Compute ROI and Decide

  • ROI > 0: Promo was profitable
  • ROI < 0 but strategic (new customer acquisition, inventory clearance): May still be justified
  • ROI < 0 with no strategic rationale: Don't repeat

Output Format

# Promo ROI Report: {Promotion Name}

## Promo Summary
- Type: {discount type}
- Period: {dates}
- Offer: {details}

## Results
| Metric | Value |
|--------|-------|
| Total Revenue (promo period) | ${X} |
| Baseline Revenue (estimated) | ${X} |
| **Incremental Revenue** | **${X}** |
| Incremental Gross Profit | ${X} |
| Promo Cost (discount + marketing + ops) | ${X} |
| **Promo ROI** | **{X%}** |

## Profitability Assessment
{Profitable / Unprofitable — with context}

## Recommendation
{Repeat / Modify / Discontinue — with rationale}

Gotchas

  • Baseline estimation is the hardest part: The accuracy of your ROI depends on how well you estimate what would have happened without the promo. Use prior year same period as a starting point, adjust for trend.
  • Post-promo dip is real: Sales often drop BELOW baseline after a promotion (customers pulled purchases forward). Include the dip period in your analysis.
  • Discounts are addictive: Customers learn to wait for sales. Track the % of revenue sold at full price over time — if it's declining, you have a discount dependency problem.
  • New vs existing customer mix matters: A promo that acquires 500 new customers at negative ROI may be worth it if their LTV justifies the acquisition cost. Track separately.

References

  • For A/B testing promotional offers, see references/promo-testing.md

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

"Implement and select ad bidding strategies from manual CPC to automated target-CPA and target-ROAS. Use this skill when the user needs to choose a bidding strategy, set up automated bidding, or optimize bid parameters — even if they say 'what bidding strategy should I use', 'target CPA setup', or 'smart bidding configuration'.".

日本語の概要は準備中です。原文の説明を表示しています。

charlieviettq/awesome-agent-skill262026年7月20日 更新

"Optimize advertising budget allocation across campaigns using marginal returns analysis. Use this skill when the user needs to distribute budget across multiple campaigns, optimize spend pacing, or maximize overall ROAS under budget constraints — even if they say 'how to split my ad budget', 'campaign budget optimization', or 'diminishing returns on ad spend'.".

日本語の概要は準備中です。原文の説明を表示しています。

charlieviettq/awesome-agent-skill262026年7月20日 更新

"Build CTR prediction models for estimating ad click-through rates from features. Use this skill when the user needs to predict click probability, build an ad ranking model, or evaluate ad creative performance — even if they say 'predict click rate', 'ad relevance scoring', or 'which ad will get more clicks'.".

日本語の概要は準備中です。原文の説明を表示しています。

charlieviettq/awesome-agent-skill262026年7月20日 更新

"Implement Generalized Second Price auction for ad slot allocation and pricing. Use this skill when the user needs to understand search ad auctions, compute ad positions and costs-per-click, or analyze bidding dynamics — even if they say 'how does Google Ads auction work', 'ad rank calculation', or 'second price auction for ads'.".

日本語の概要は準備中です。原文の説明を表示しています。

charlieviettq/awesome-agent-skill262026年7月20日 更新

"Implement VCG mechanism for incentive-compatible ad slot allocation with truthful bidding. Use this skill when the user needs to design a truthful auction mechanism, compute externality-based payments, or understand why platforms may prefer GSP over VCG — even if they say 'truthful auction design', 'VCG payments', or 'incentive-compatible mechanism'.".

日本語の概要は準備中です。原文の説明を表示しています。

charlieviettq/awesome-agent-skill262026年7月20日 更新

"Explain blockchain fundamentals including distributed ledger architecture, consensus mechanisms, and block structure. Use this skill when the user needs to understand blockchain concepts, evaluate whether blockchain fits a use case, or design a blockchain-based solution — even if they say 'how does blockchain work', 'do I need blockchain', or 'distributed ledger'.".

日本語の概要は準備中です。原文の説明を表示しています。

charlieviettq/awesome-agent-skill262026年7月20日 更新

charlieviettq のスキルをすべて見る

このスキルの問題を報告する