Revive Adserver platform help — free open-source self-hosted ad server for managing display and email newsletter ads across websites, apps, and video players. Use when setting up Revive Adserver on your own server to manage ad campaigns, email newsletter zone only shows one banner and you need multiple ads rotating, ads not displaying after installation or PHP upgrade, geo-targeting rules aren't matching the right countries or cities, XML-RPC API calls failing with authentication errors, campaign statistics not tracking impressions or clicks correctly, trying to decide between self-hosted Revive and hosted alternatives like AdButler or Epom, or need to integrate Revive ad zones into your email newsletter. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or managed hosted ad serving without self-hosting (use /sales-adbutler or /sales-epom).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Revive Adserver platform help — free open-source self-hosted ad server for managing display and email newsletter ads across websites, apps, and video players. Use when setting up Revive Adserver on your own server to manage ad campaigns, email newsletter zone only shows one banner and you need multiple ads rotating, ads not displaying after installation or PHP upgrade, geo-targeting rules aren't matching the right countries or cities, XML-RPC API calls failing with authentication errors, campaign statistics not tracking impressions or clicks correctly, trying to decide between self-hosted Revive and hosted alternatives like AdButler or Epom, or need to integrate Revive ad zones into your email newsletter. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or managed hosted ad serving without self-hosting (use /sales-adbutler or /sales-epom).
argument-hint
[describe your Revive Adserver question or ad serving goal]
/sales-adbutler [question] or /sales-epom [question]
Direct-sold ad management for local publishers
/sales-broadstreet [question]
Budget ad serving for bloggers (no server required)
/sales-adplugg [question]
Email deliverability (SPF/DKIM/DMARC)
/sales-deliverability [question]
If the question is Revive-specific, continue to Step 3.
Step 3 — Revive Adserver platform reference
Read references/platform-guide.md for the full platform reference — capabilities, pricing, data model, API overview, email zone setup, integration recipes.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
Focus on the user's specific situation:
First-time setup: Download from revive-adserver.com/download (not GitHub ZIP). Latest is v6.0.6 (March 2026). Requires PHP 7.2.5+ (v5.x) or PHP 8.1+ (v6.0.x, tested through PHP 8.5), MySQL 4.1+/PostgreSQL 8.1+ (MariaDB works as MySQL-compatible), and any FastCGI web server (Apache, Nginx, IIS 7+, lighttpd, FrankenPHP) or Apache with mod_php. Run the web installer, create your first advertiser, campaign, banner, and zone.
Email newsletter ads: Create a zone with type "Email/Newsletter". Only one active banner can serve per email zone (no JavaScript, no cookies). For multiple ads, install the "Multiple Ads in an Email Zone" plugin. Only image banners work in email zones.
API automation: Built-in XML-RPC v2 API at /api/v2/xmlrpc/. Auth with base64 user:password. Manage advertisers, campaigns, banners, zones, and pull statistics programmatically. Third-party REST API plugin available for purchase.
Choosing Revive vs alternatives: Revive is best when you need full control, zero platform fees, and can manage your own server. For managed hosting with less ops burden, use AdButler ($179/mo) or Epom ($149/mo). For budget no-code, use AdPlugg (free-$79/mo).
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about version compatibility and email zone limitations that may be outdated.
Email zones support only one active banner — without the paid "Multiple Ads in an Email Zone" plugin, only one banner can be active per email/newsletter zone at a time. No JavaScript or cookies in email.
PHP version compatibility is strict — v6.0.x requires PHP 8.1+ (tested through PHP 8.5); v5.4.0+ supports PHP 7.2.5 up to 8.1.x; v5.3.0+ supports PHP 7.2.5 up to 8.0.x; v4.2–v5.2.1 require PHP 7.0.8+ but do NOT support PHP 8. Upgrading PHP can break your installation.
Don't download from GitHub — GitHub ZIP contains development files. Always download releases from revive-adserver.com/download.
Email zones only support image banners — text banners and HTML banners don't work in email/newsletter zones. Use image creatives only.
Geo-targeting requires MaxMind GeoLite2 — you must download and configure the GeoLite2 database separately. Requires a free MaxMind account.
/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Installing Revive Adserver for the first time
User says: "I want to set up my own ad server on my VPS to manage newsletter ads. How do I install Revive?"
Skill does: Walks through server requirements (PHP 8.1+ for v6.0.x, MySQL/MariaDB or PostgreSQL, a FastCGI web server like Apache/Nginx), downloading from official site, running the web installer, creating the admin account, and setting up the first advertiser/campaign/zone
Result: User has a working Revive Adserver installation ready to serve ads
Example 2: Setting up email newsletter ad zones
User says: "How do I add Revive ads to my email newsletter?"
Skill does: Explains creating an Email/Newsletter zone type, the one-active-banner limitation, image-only requirement, how to get the zone invocation code, and the Multiple Ads plugin for rotating multiple banners
Result: User has email ad zones generating trackable ad tags for their newsletter
Example 3: Automating campaign management via API
User says: "I want to create campaigns and pull stats from Revive programmatically"
Skill does: Shows the XML-RPC v2 API at /api/v2/xmlrpc/, authentication with base64 credentials, creating a campaign via ox.addCampaign, pulling daily statistics, and available PHP wrapper packages on Packagist
Result: User can programmatically manage their Revive installation
Troubleshooting
Ads not displaying on website
Symptom: Zone invocation code is placed but no ads appear
Cause: No active banners linked to the zone, campaign dates haven't started, or delivery rules exclude the current visitor
Solution: Check that banners are linked to the zone and campaign dates include today. Test with delivery rules temporarily disabled. Check browser console for JavaScript errors in the zone invocation code.
Email zone shows broken image
Symptom: Email/newsletter zone tag shows a broken image icon in the email client
Cause: The Revive server is unreachable from the email client, or the banner URL has changed
Solution: Verify the Revive server URL is publicly accessible (not localhost). Check that the banner image still exists. Test the image URL directly in a browser. Ensure your server's SSL certificate is valid — many email clients block mixed content.
Installation fails after PHP upgrade
Symptom: Revive dashboard shows errors or blank page after upgrading PHP
Cause: PHP version incompatibility — v6.0.x requires PHP 8.1+; v4.2–v5.2.1 don't support PHP 8 at all
Solution: Check the compatibility matrix: Revive v5.3.0+ supports PHP 7.2.5–8.0.x, v5.4.0+ supports PHP 7.2.5–8.1.x, and v6.0.x requires PHP 8.1+ (tested through PHP 8.5). Either downgrade PHP or upgrade Revive to a compatible version.
