The Campaigns Module: Automating Your Content Engine

The Campaigns section is the core of Super Programmatic SEO. This is where your configurations, keywords, and templates come together to automatically generate and publish content on autopilot.

Here is a complete breakdown of how to monitor and manage your automated content queues.

System Status & Global Limits

At the top of the Campaigns dashboard, you will find a real-time health check of your automation environment to ensure everything runs smoothly:

• System Status: Verifies that your plugin license is active, your server memory is sufficient (e.g., 512M), and your API Key is correctly configured. When you see “✅ All systems ready,” the engine is cleared to run.
• Global Daily Limit: Displays your current generation volume against your daily server cap. This tracker automatically resets at midnight based on your WordPress timezone settings (e.g., -07:00).
• Monthly Quota Status: The system actively monitors your generation volume against your specific license tier (capped at 50, 150, or 300 articles per month). If you hit your limit, active campaigns will safely pause and display a monthly_quota_reached status until the next billing cycle.

Core Campaign Processing Rules

The plugin’s processing engine operates under three strict rules to ensure maximum server stability and publishing consistency:

1. Sequential Processing: To prevent server timeouts and API rate-limit errors, only one campaign can run at a time.
2. Scheduled Publishing: Articles are not published randomly; they are pushed live strictly at the times you configure within each individual campaign’s settings.
3. Volume Control: Every campaign independently respects its own configuration for maximum articles per day and designated publishing days.

Managing Your Campaigns Dashboard

The main table provides a bird’s-eye view of all your programmatic workflows:

• Campaign Name: The internal name designated for your automation run.
• Template: Displays the template(s) attached to the campaign. Notice that you can assign multiple templates to a single campaign to aggressively diversify your programmatic footprint and rotate block architectures.
• Progress: A real-time tracker showing the exact number of articles successfully generated versus the total keywords in the campaign queue (e.g., 83 / 100 (83%)).
• Status: Instantly see if a campaign is Completed (All articles generated) or Paused.

Actions & Controls

You have granular control over how your campaigns execute through both row-level and bulk commands:

• Individual Row Actions: Hover over any campaign name to Edit its settings, view its generation History logs, Duplicate it to quickly clone a successful setup, or Delete it.
• Quick Toggles: Use the button in the Status column to manually Start or Pause a campaign queue instantly.
• Bulk Actions: Use the checkboxes to select multiple campaigns at once to Pause, Start, Delete, or Reconcile Data (which resyncs your database if you manually deleted generated posts).
• Process Single Article: Need to test a configuration right now? Use the Process Single Article button at the top of the dashboard to temporarily bypass the queue and force-generate one post immediately.

Creating a New Campaign: Step-by-Step Configuration

This campaign creation flow perfectly bridges the gap between raw data input and granular publishing control. For your documentation, breaking this down into two distinct phases—defining the content and controlling the output—will make it highly digestible for new users.

Here is a structured commentary and breakdown of the Campaign creation process based on your interface:

Section 1: Core Configuration & Keyword Input

This first section is designed to establish the foundational rules and raw materials for your automated content run.

• SPS Pro Shield (Smart Compatibility): A massive user-experience win. By automatically detecting existing SEO plugins like Yoast and optimizing the header hooks on the fly, you remove the anxiety users often feel about breaking their current site architecture. This is a “plug-and-play” feature that should be highlighted as a major technical advantage.
• Campaign Naming: A straightforward organizational step. Encouraging descriptive names keeps the main dashboard clean as users scale up to dozens of campaigns.
• Keyword Queue (The Engine Fuel): The rule here is beautifully simple: one keyword equals one complete article headline. Capping the recommendation at 100 keywords per campaign encourages users to build tightly grouped, highly relevant topical clusters rather than massive, unfocused lists.
• Articles Per Day (Built-in Throttling): The hard cap of 10 articles per day is a vital safety mechanism. It protects the user’s server from memory exhaustion, prevents API rate-limit timeouts, and ensures the publishing velocity looks natural to search engine crawlers. Tying this directly to the WordPress site’s local timezone ensures predictable publishing behavior.

Section 2: Advanced Scheduling & Template Mapping

This section transforms a basic bulk-generator into a precise programmatic publishing machine.

• Granular Publishing Days: Users are not forced into a relentless daily publishing schedule. By selecting specific days of the week, a campaign can be tailored to mimic a natural editorial calendar (e.g., publishing only on weekdays to target B2B search traffic).
• Time & Template Mapping (The Killer Feature): This is where the true power of the plugin shines. Users do not just pick a time; they map a specific time slot (from 00:00 to 23:00) directly to a specific Template.
  • Strategic Benefit: This directly supports the strategy of eliminating the programmatic footprint. A user can set Post #1 at 08:00 using an authoritative “How-To” template, and Post #2 at 14:00 using a conversational “Fixie Urbana” template—all within the exact same campaign queue.
• Execution Triggers: Providing the option to start immediately or schedule for later offers excellent workflow flexibility.
  • Failsafe Mechanism: The logic dictates that selecting “Start Immediately” will automatically pause any other currently running campaign. This perfectly enforces the core system rule that only one campaign can process at a time, protecting the user from accidental server overloads.

Documentation Pro-Tip: When finalizing this for the launch package, emphasize that the timezone settings in Section 1 and Section 2 rely entirely on their native WordPress configuration (Settings → General). This prevents support tickets from users wondering why their 08:00 AM post published at midnight.

Managing Campaign Execution: Manual Overrides & Troubleshooting

At the top of your main Campaigns dashboard, alongside the standard Add New button, you will notice two vital control buttons. These are your manual management tools, designed to give users direct control over the automated publishing engine and resolve server-side hiccups instantly.

Here is a breakdown of how to document these features for your users:

• Process Single Article (The Manual Override): While the system is designed to run seamlessly on autopilot based on your predefined time slots, you may occasionally need immediate output. Clicking this button forces the engine to bypass the scheduled waiting period and instantly generate the next pending keyword in your active campaign queue. This is incredibly useful for generating a quick test article to verify template formatting or pushing out a timely piece of content without having to alter the entire campaign schedule.
• Reset Stuck Campaign (The Failsafe): Programmatic SEO engines rely on background processes, third-party API connections, and server CRON jobs. Occasionally, a server memory timeout, a temporary API drop, or a WordPress execution limit might cause a campaign to freeze or pause unexpectedly. This red button acts as a secure, one-click reboot. Clicking Reset Stuck Campaign clears the bottleneck, re-processes the engine’s internal flow, and safely puts the campaign back into its normal state to wait for the next scheduled article.

Documentation Pro-Tip: Highlighting the Reset Stuck Campaign button prominently in your AppSumo documentation will drastically reduce your future support tickets. It reassures prospective buyers that if their server experiences a minor glitch, getting their programmatic engine back on track does not require any technical debugging—just a single click.