Documentation
Welcome to the SEO Campaigner documentation. Here you will find everything you need to install, configure, and get the most out of the SEO Campaigner desktop application and WordPress plugin.
Quick Links
Getting Started Guide — Install and set up SEO Campaigner in under 10 minutes.
Changelog — See what’s new in the latest version.
Roadmap — Upcoming features and improvements.
FAQ — Answers to common questions.
System Requirements
Desktop Application
Operating System: Windows 10 or later (64-bit). macOS and Linux support coming soon — see our roadmap.
Memory: 4 GB RAM minimum, 8 GB recommended.
Disk Space: 200 MB for installation, plus space for local data storage.
Internet: Required for license activation, rank tracking, keyword research, and syncing with WordPress sites.
Display: 1280×720 minimum resolution.
WordPress Plugin (CAB A/B Testing)
WordPress: Version 6.0 or later.
PHP: Version 7.4 or later (PHP 8.0+ recommended).
MySQL: Version 5.7 or later, or MariaDB 10.3 or later.
SSL: HTTPS is required for secure communication between the desktop app and your site.
REST API: WordPress REST API must be enabled (it is by default on standard installations).
Installation
Installing the Desktop App
1. Download the installer from your My Account > Downloads page after purchasing.
2. Run the .exe installer file. On first launch, Windows SmartScreen may display a warning — click “More info” then “Run anyway.” This is standard for new applications without an EV code signing certificate.
3. The app installs to your user directory and creates a desktop shortcut automatically.
4. Launch SEO Campaigner from the shortcut or Start menu.
Installing the WordPress Plugin
1. Log into your WordPress admin dashboard.
2. Navigate to Plugins > Add New > Upload Plugin.
3. Click “Choose File” and select the CAB A/B Testing Plugin .zip file from your downloads.
4. Click “Install Now” and wait for installation to complete.
5. Click “Activate” to enable the plugin.
6. You will see a new SEO Campaigner menu item in your WordPress admin sidebar.
License Activation
Activating the Desktop App
1. Open SEO Campaigner and go to Settings > License.
2. Enter your license key (found in your order confirmation email or at My Account > License Keys).
3. Click “Activate.” The app will validate your key with our license server.
4. On success, you will see a green “Active” badge and your license tier (Single, 3-Site, or 5-Site).
Activating the WordPress Plugin
1. In your WordPress admin, go to SEO Campaigner > Settings.
2. Enter the same license key used in the desktop app.
3. Click “Activate License.” The plugin will verify your key and register your site URL.
4. Once activated, all plugin features are unlocked and the plugin can communicate with the desktop app.
Managing Activations
Each license key has a limited number of site activations depending on your tier. You can manage your activations from My Account > License Keys. To move a license to a new machine or site, deactivate it first from the current installation (Settings > License > Deactivate), then activate on the new machine. If you need to reset activations, contact support@seocampaigner.com.
Connecting Your WordPress Site
1. In the desktop app, go to Sites > Add Site.
2. Enter your WordPress site URL (e.g., https://yoursite.com).
3. The app sends a discovery request to your site’s REST API to detect the SEO Campaigner plugin.
4. If the plugin is installed, activated, and licensed, the connection is established automatically.
5. You will see your site appear in the sidebar with its name, URL, and connection status.
Troubleshooting connection issues: Ensure your site uses HTTPS. Verify the WordPress REST API is accessible by visiting https://yoursite.com/wp-json/ in a browser — you should see a JSON response. Check that no security plugin is blocking REST API access. Confirm the CAB A/B Testing plugin is activated and the license key is entered in the plugin settings.
Feature Guide
Keyword Research
The keyword research tool helps you discover and evaluate keywords for your content strategy. Navigate to Keywords > Research in the desktop app. Enter a seed keyword or phrase and select your target location. SEO Campaigner returns a list of related keywords with estimated monthly search volume, keyword difficulty score (0-100), CPC estimates, and SERP features present.
You can save keywords to your portfolio, organize them into groups by topic or campaign, and track them in the rank tracker. Use the “Export” button to download keyword lists as CSV files for sharing with your team or importing into other tools.
Rank Tracking
Monitor your search engine rankings over time with daily automated tracking. Go to Rankings > Add Keywords to start tracking. For each keyword, SEO Campaigner records your current position, URL ranking, and SERP features. The dashboard shows trend charts with historical data, so you can see how your rankings change over time.
You can filter by date range, keyword group, or ranking change. The “Winners and Losers” view highlights keywords with the biggest ranking movements in the selected period. Set up email alerts to get notified when a keyword moves above or below a threshold position.
A/B Testing
The A/B testing system runs through the WordPress plugin and is controlled from either the desktop app or the WordPress admin panel. To create an experiment, navigate to Experiments > New Experiment. Select the page you want to test, choose the element to test (title tag, meta description, H1 heading, or content block), and create your variant.
The plugin automatically splits incoming traffic between the original and variant versions. It tracks impressions, clicks (for title/meta tests via search console data), time on page, and custom conversion events. The results page shows a real-time comparison with statistical significance indicators so you know when you have enough data to declare a winner.
Best practice: run tests for at least 2-4 weeks to account for weekly traffic patterns. Test one variable at a time for clear attribution. Start with high-traffic pages where even small improvements have a meaningful impact.
Competitor Analysis
Monitor your competitors’ SEO performance from Competitors > Add Competitor. Enter a competitor’s domain URL to begin tracking. SEO Campaigner will identify keywords they rank for, track their ranking positions alongside yours, and highlight content gaps — topics they cover that you do not.
The “Head-to-Head” view lets you compare your rankings with a specific competitor across your shared keyword set. The “Opportunities” tab shows keywords where your competitor ranks in positions 1-10 but you do not yet rank, representing potential content targets.
Site Audit
Run a comprehensive technical SEO audit from Audit > New Audit. The crawler scans your WordPress site and checks for missing or duplicate title tags and meta descriptions, broken internal and external links (404 errors), images missing alt text or that are too large, heading structure issues (missing H1, skipped heading levels), pages with thin content (low word count), mobile usability issues, page speed indicators, XML sitemap issues, and robots.txt configuration problems.
Each issue is categorized by severity (Critical, Warning, Notice) with specific recommendations for fixing it. You can re-run audits to verify your fixes are working and track your site health score over time.
Multi-Site Management
If your license supports multiple sites, you can connect and manage all of them from a single desktop app installation. Each site gets its own workspace with separate keyword portfolios, rank tracking, competitor lists, and audit history. Use the site switcher in the top-left corner to switch between sites instantly. The “Portfolio Overview” screen shows aggregated data across all connected sites.
Settings and Configuration
Desktop App Settings
General: Set your default tracking location and language. Configure how often rank tracking data refreshes. Choose your preferred date format and timezone.
License: View your license status, tier, and activation count. Activate or deactivate your license. View your license key.
Notifications: Configure email alerts for ranking changes, audit issues, and experiment completions.
Data: Export all your data, clear local cache, or reset the application to defaults.
About: View the current application version, check for updates, and access release notes.
WordPress Plugin Settings
License: Enter and manage your license key. View connection status with the desktop app.
API: View the REST API endpoint URL and authentication status. Enable or disable specific API endpoints.
Experiments: Set default traffic split percentages. Configure minimum sample sizes for statistical significance. Set up conversion tracking events.
Advanced: Enable debug logging for troubleshooting. Configure cache behavior. Set up custom REST API authentication methods if your site uses non-standard security.
Troubleshooting
“License activation failed”: Verify your license key is entered correctly with no extra spaces. Check your internet connection. If you have reached your activation limit, deactivate from another machine first or contact support.
“Cannot connect to WordPress site”: Ensure the site URL uses HTTPS. Verify the CAB A/B Testing plugin is installed and activated. Check that no security plugin or firewall is blocking REST API requests. Test by visiting https://yoursite.com/wp-json/ in a browser.
“Rank tracking not updating”: Rank data refreshes daily. If data appears stale, check your internet connection and verify your license is active. Go to Settings > Data > Force Refresh to trigger a manual update.
“A/B test not splitting traffic”: Verify the experiment is set to “Running” status. Check that the test page URL matches exactly. Clear any page caching on your WordPress site, as aggressive caching can prevent the plugin from serving variants.
“Windows SmartScreen warning on install”: This is normal for new applications. Click “More info” then “Run anyway.” We are in the process of obtaining an EV code signing certificate to eliminate this warning. The application is safe to install.
For any issues not covered here, contact our support team at support@seocampaigner.com with your license key, application version (found in Settings > About), and a description of the problem.