Skip to main content

Documentation Index

Fetch the complete documentation index at: https://theoptimizer.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

MGID, RevContent, and NewsBreak each have distinct optimization mechanics, but share a common DNA: aggressive widget-level blocking, ROI-tiered bid adjustments, and rapid reactivation loops. This page covers the proven rule patterns for all three platforms, drawn from analysis of thousands of real active rules. Use the tabs to navigate to your platform — or read all three to spot the patterns that carry across networks.
RevContent automation centers on two core strategies: systematically pausing unprofitable widgets through spend and conversion thresholds, and dynamically adjusting bids using ROI-tiered increments. Analysis of 1,516 active RevContent rules shows 855 widget pause rules and 325 ROI-based bid adjustments — RevContent’s signature bid-tiering system is the foundation of performance optimization here.

Widget pausing — zero-conversion blocks

These rules form the first line of defense against unprofitable widgets. The pattern is consistent: identify widgets that spend money without converting, then pause them aggressively across different timeframes.

Quick kill: $25 spend, zero conversions (3-day window)

Pause widgets within 3 days of reaching $25 spend with zero traffic source conversions. This quick-reaction rule prevents early testing spend from accumulating into larger losses.Data Interval: Last 3 days | Scheduling: Every 6 hours
MetricOperatorValue
Amount SpentGreater than$25
Tracker ConversionsLess than1
Action: Pause Widget
Use alongside longer-lookback rules to catch widgets going cold mid-campaign. Pair with reactivation rules to retry proven performers after brief rest periods.

Medium-term spend cap: $55+ spend, zero conversions (10-day window)

Pause widgets after $55 spend over 10 days without any tracker conversions. This extended lookback catches sustained non-performers that slip through daily monitoring.Data Interval: Last 10 days | Scheduling: Every 8 hours
MetricOperatorValue
Amount SpentGreater or Equal to$55
Tracker ConversionsLess than1
Action: Pause Widget
Adjust thresholds by vertical: lower to 3540forhighfrequencytesting,raiseto35–40 for high-frequency testing, raise to 80–100 for slower conversion paths (nutra, VSL, subscription offers).

Long-term loss limit: $120+ spend, single conversion or less (30-day window)

Pause widgets exceeding $120 spend over 30 days with one or fewer tracker conversions. This rule targets high spend-to-conversion ratios that systematically drag down campaign profitability.Data Interval: Last 30 days | Scheduling: Daily at 8 AM
MetricOperatorValue
Amount SpentGreater or Equal to$120
Tracker ConversionsLess or Equal to1
Action: Pause Widget

High spend, zero landing page visits (high clicks, no LP clicks)

Pause widgets generating 100+ traffic source clicks but zero landing page clicks over 14 days, indicating a traffic-source-to-landing-page conversion failure.Data Interval: Last 14 days | Scheduling: Daily at 8 AM
MetricOperatorValue
Traffic Source ClicksGreater or Equal to100
LP ClicksLess than1
ImpressionsGreater or Equal to15
Action: Pause Widget
This pattern reveals broken landing pages, domain issues, or traffic that never reaches your funnel. Diagnose LP redirect settings and domain accessibility before re-enabling.

Fraud & quality detection

Suspicious conversion rate: publisher conversions > 15% of clicks (7-day window)

Pause widgets where tracker conversions exceed 15% of traffic source clicks over 7 days — an unusually high rate indicating potential fraud or misattribution.Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Publisher ConversionsGreater than15% of Traffic Source Clicks
Traffic Source ClicksGreater or Equal to50
Action: Pause Widget
High conversion rates (>15%) are rare in affiliate marketing and suggest either pixel flooding, publisher fraud, or misconfigurations.

High clicks on landing page, zero conversions (14-day funnel check)

Pause widgets with 50+ traffic source clicks, 10+ LP clicks, but zero tracker conversions over 14 days. This signals either a broken post-LP funnel or landing page quality issues.Data Interval: Last 14 days | Scheduling: Daily at 8 AM
MetricOperatorValue
Traffic Source ClicksGreater or Equal to50
LP ClicksGreater or Equal to10
Tracker ConversionsLess than1
Action: Pause Widget

Extremely low CTR: 20,000+ impressions below 0.1% CTR (30-day window)

Pause widgets reaching 20,000 impressions with a CTR under 0.1% over 30 days. This indicates severely poor publisher inventory or traffic source quality.Data Interval: Last 30 days | Scheduling: Daily at 8 AM
MetricOperatorValue
ImpressionsGreater or Equal to20,000
CTRLess than0.1%
Amount SpentGreater or Equal to$40
Action: Pause Widget

ROI-tiered bid management

The RevContent bid-adjustment system is the signature automation pattern: six distinct ROI tiers control bid increases and decreases in 10%, 20%, or 30% increments. These rules operate in parallel on a 12-hour cycle, creating a self-balancing system where widgets naturally trend toward profitability.

Tier 1 — critical loss: ROI below −35% (bid down 20%)

Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Amount SpentGreater than$20
Tracker ROILess than−35%
Traffic Source ConversionsGreater or Equal to1
Action: Decrease Widget Bid by 20%

Tier 2 — moderate loss: ROI −35% to −13% (bid down 15%)

Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Amount SpentGreater than$20
Tracker ROIGreater or Equal to−35%
Tracker ROILess than−13%
Traffic Source ConversionsGreater or Equal to1
Action: Decrease Widget Bid by 15%

Tier 3 — slight loss: ROI −13% to 0% (bid down 10%)

Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Amount SpentGreater than$20
Tracker ROIGreater or Equal to−13%
Tracker ROILess than0%
Traffic Source ConversionsGreater or Equal to1
Action: Decrease Widget Bid by 10%

Tier 4 — moderate profit: ROI 35% to 85% (bid up 10%)

Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Amount SpentGreater than$20
Tracker ROIGreater or Equal to35%
Tracker ROILess than85%
Traffic Source ConversionsGreater or Equal to1
Action: Increase Widget Bid by 10%

Tier 5 — strong profit: ROI 85% to 160% (bid up 20%)

Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Amount SpentGreater than$20
Tracker ROIGreater or Equal to85%
Tracker ROILess than160%
Traffic Source ConversionsGreater or Equal to1
Action: Increase Widget Bid by 20%

Tier 6 — exceptional profit: ROI > 160% (bid up 30%)

Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Amount SpentGreater than$20
Tracker ROIGreater than160%
Traffic Source ConversionsGreater or Equal to1
Action: Increase Widget Bid by 30% (capped at maximum bid)
Always set a maximum bid cap (e.g., $2.50) to prevent runaway costs. These six tiers running in parallel create a self-balancing feedback loop where widgets naturally migrate toward the profitable ROI bands.

Reactivating profitable widgets

Restart positive ROI widgets (7-day window)

Reactivate widgets showing positive tracker ROI (>0%) over the last 7 days, regardless of spend. This catches widgets that recovered quickly and deserve another chance.Data Interval: Last 7 days | Scheduling: Every 12 hours
MetricOperatorValue
Tracker ROIGreater than0%
Traffic Source ConversionsGreater or Equal to1
Action: Start Widget

Restart high-volume profitable widgets (30-day proven performer)

Reactivate widgets that spent $300+ over 30 days with tracker ROI above −30% and at least 1 conversion. These widgets have genuine historical profitability and deserve scaling.Data Interval: Last 30 days | Scheduling: Daily at 10 AM
MetricOperatorValue
Amount SpentGreater than$300
Tracker ROIGreater than−30%
Tracker ConversionsGreater or Equal to1
Action: Start Widget

Positive net revenue activation (14-day baseline)

Reactivate widgets with tracker net revenue above $0 over the last 14 days, using absolute profit rather than ROI percentage.Data Interval: Last 14 days | Scheduling: Daily
MetricOperatorValue
Tracker Net RevenueGreater than$0
Action: Start Widget

Campaign-level safety & scaling

Daily spend cap — $20 (testing phase)

Pause the entire campaign if daily spend exceeds $20 today. Use this as a safety valve during high-volume testing periods.Data Interval: Today | Scheduling: Every 2 hours
MetricOperatorValue
Amount SpentGreater or Equal to$20
Action: Pause Campaign

Daily spend cap — $15 (conservative brand testing)

Pause campaign after spending $15 today to limit exposure during initial publisher testing or A/B tests.Data Interval: Today | Scheduling: Every hour
MetricOperatorValue
Amount SpentGreater or Equal to$15
Action: Pause Campaign

Emergency spend stop: cost >= 300% of campaign payout (15+ days)

Pause campaign if cumulative cost over 15 days hits 300% of campaign payout — an emergency valve for sustained unprofitability.Data Interval: Last 15 days | Scheduling: Every 8 hours
MetricOperatorValue
CostGreater or Equal to300% of Campaign.payout
Action: Pause Campaign

Budget scale-up: spend at threshold + conversions > 4

Increase campaign budget by 20% if daily spend is at 85–90% of budget AND tracker conversions exceed 4 in the same day.Data Interval: Today | Scheduling: Every 4 hours
MetricOperatorValue
Amount SpentGreater or Equal to85% of Budget
Tracker ConversionsGreater or Equal to4
Tracker ROIGreater than0%
Action: Increase Campaign Budget by 20%

Creative performance management

Pause dead creatives: $300+ spend, zero conversions (30-day window)

Data Interval: Last 30 days | Scheduling: Daily at 7 AM
MetricOperatorValue
Amount SpentGreater than$300
Tracker ConversionsLess than1
Action: Pause Ad

Reactivate marginally viable creatives (90-day profitability test)

Data Interval: Last 90 days | Scheduling: Daily at 9 AM
MetricOperatorValue
Amount SpentGreater than$300
Tracker ROIGreater than−25%
Tracker ConversionsGreater than1
Action: Start Ad
Use 90-day lookback to avoid re-testing creatives too frequently. This creates a “seasonal rotation” where creatives cycle in and out as their performance drifts.

Implementation priority

Week 1 — blocking only. Start with the three widget pause rules plus the suspicious conversion rate fraud rule. Establish your zero-conversion floor before optimizing bids.Week 2 — introduce bid tiering. Add all six ROI-tier bid rules once widget baseline is clear. Let the tiering system run for 7 days to establish patterns.Week 3 — add campaign safety. Implement daily spend caps and emergency brakes. Monitor campaign-level metrics for 3–5 days before enabling budget scaling.Week 4+ — optimization & refinement. After 2–3 weeks of data, adjust spend thresholds and ROI tier bands based on your specific vertical. Reactivation rules work best on mature campaigns with 100+ historical conversions.