omni_email_marketing_roi
Calculate email campaign open rates, click-through rates, conversions, revenue, and net ROI from list size, rates, AOV, and cost to prevent manual arithmetic errors.
Instructions
Email Marketing Campaign ROI Calculator. Calculate open rates, click-through rates (CTR), conversion yields, total campaign revenue, and net ROI percentage. Discipline: FINANCE. Governing mathematical model / formula: ROI % = [(Campaign Revenue - Campaign Cost) / Campaign Cost] × 100.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_campaign_revenue (Total Campaign Revenue), campaign_roi_pct (Net Campaign ROI), total_clicks (Total Click-Throughs), total_orders (Total Orders Generated) using list_size (Email List Size (Recipients)), open_rate_pct (Open Rate (%) in %), ctr_pct (Click-Through Rate (CTR %) in %), conversion_pct (Purchase Conversion Rate in %), aov_input (Average Order Value (AOV)), campaign_cost (Total Campaign Cost). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Email Marketing Campaign ROI Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "email-marketing-roi"
category (string): "finance"
name (string): "Email Marketing Campaign ROI Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_campaign_revenue (Total Campaign Revenue): Formatted display string (e.g. '$4,500.00')
metrics.campaign_roi_pct (Net Campaign ROI): Formatted display string (e.g. '500.00%')
metrics.total_clicks (Total Click-Throughs): Formatted display string (e.g. '800 clicks')
metrics.total_orders (Total Orders Generated): Formatted display string (e.g. '36 orders')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_email_marketing_roi"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctr_pct | No | Click-Through Rate (CTR %) (%). Percentage of total delivered emails clicked. Default: 3.2. Min: 0.1. Max: 30. | |
| aov_input | No | Average Order Value (AOV). Average dollars spent per checkout. Default: 125. Min: 5. Max: 10000. | |
| list_size | No | Email List Size (Recipients). Total emails sent in blast. Default: 25000. Min: 100. Max: 5000000. | |
| campaign_cost | No | Total Campaign Cost. Copywriter, ESP fees, design. Default: 750. Min: 10. Max: 50000. | |
| open_rate_pct | No | Open Rate (%) (%). Average B2B/eCommerce open rate: 20-30%. Default: 24. Min: 1. Max: 90. | |
| conversion_pct | No | Purchase Conversion Rate (%). Clicks converting into paid orders. Default: 4.5. Min: 0.5. Max: 50. |