Manage ad delivery, track detailed metrics, and optimize your advertising performance by setting up the MediaOS Ad Server across your WordPress website and newsletters.
Why Use the MediaOS Ad Server? #
The MediaOS Ad Server brings together ad delivery, tracking, and CRM integration into a single platform. It captures impressions, clicks, hovers, and engagement rates automatically, giving you real-time insights across your digital advertising efforts. Designed to be blocker-proof, the MediaOS Ad Server continuously regenerates randomized code to bypass ad-blockers and ensure full ad visibility for your audience.
Setting Up Your Website with the MediaOS Ad Server #
Downloading the WordPress Plugin #
To start, log into MediaOS and navigate to Delivery on the left sidebar. From the top menu, select the Ad Server tab. In the Websites section, click New Website and follow the prompts to Download the WordPress Plugin.
After downloading the plugin, go to your WordPress admin area. Click Plugins > Add New > Upload Plugin, then upload the .zip file you downloaded. Once uploaded, activate the MediaOS Services plugin by clicking the checkbox next to it in the Installed Plugins list.
Note: The MediaOS Ad Server only works with WordPress websites.
Configuring Your Site #
After activating the plugin, return to MediaOS and click Proceed to Next Step. Fill out your website’s name and URL, toggle WordPress Enabled, and enter your WordPress Admin login credentials. This links MediaOS with your site and pulls data like pages, post types, and categories.
Click Assigned Products and select the products you want available on your website, such as Time-based or CPM-based offerings. Products can only be assigned to one site. After finalizing your selections, click Connect. Your site’s status will display as up-to-date under the Version field.
Ad Widgets for Ad Placements #
Inside WordPress, go to Appearance > Widgets. Select your preferred widget location, like Footer, and click + to add a new block. Search for MediaOS Ad Server, select it, and configure which ad sizes and units you want displayed.
You can prioritize which types of ads appear (time-based vs. CPM-based) and customize the widget settings to fit different pages or ad slots across your site.
Running Ads On Your Website #
Setting Up Ads Through Proposals #
In MediaOS, navigate to Sales, select a proposal, and click Edit. Search for your connected website and click Add to Proposal. Select the Unit/Size, choose a Date Range, and optionally specify Website Categories to better target ads. Click Add Items to assign creatives to the open fields.
MediaOS automatically pulls live category data from WordPress, ensuring you can always target your ads to the correct content in real time.
Embedding Ads Manually #
You can also embed ad units manually by navigating to the Embed Guide in the Websites section of MediaOS. Choose Ad Unit, copy the provided HTML code, and paste it into an HTML block anywhere inside your WordPress site.
Note: Changes to ads, targeting, or creative assignments may take 15–30 minutes to reflect live.
Fallback options are available to fill empty slots with Google Ads or default placeholders if needed.
Setting Up the Ad Server for Newsletters #
In the Newsletters section of the Ad Server page, click New Website. Select the ad unit you want to embed, then copy the HTML code next to the active ad. Paste the code into your email newsletter template. MediaOS will track impressions and clicks automatically.
Note: Newsletter ads must be time-based, use the timeline scheduler, and have the Concurrent Limit set to 1 for compatibility.
Managing the Ad Server Inside of MediaOS #
Setting Up Products for the Ad Server #
When creating products for ad server use, ensure you choose Time Range/Start and End Date as the Product Type. Enable Multiple Ad Units, set measurement units to Pixels, and decide whether you want to use the timeline scheduler.
After creating the product, click Manage and configure Ad Sizes (recommended: 300x250, 728x90, 100x100). Edit the product settings to allow assigning multiple creatives per sold item.
Next, under Websites, connect the product to your WordPress site by selecting Ad Server, choosing your product, and configuring options like ad rotation timing and display settings.
Selling the Ad Server to Advertisers #
MediaOS provides enhanced audience targeting through CRM integrations. Ads can be targeted by author, page category, tags, or by reader type (known vs. unknown). Build segmented audiences using the Audiences feature under Members, grouping readers by attributes or behaviors for hyper-targeted campaigns.
Example: Political advertisers can target only left-leaning audience groups while excluding others, ensuring maximum relevance for each ad served.
Forecasting tools like Forecast Inventory help predict ad server availability based on your targeting parameters.
Assigning Assets to Line Items #
When uploading ad creatives, make sure files are JPEG, PNG, or other web-safe formats. PDFs are not supported. Each uploaded ad must have a target URL attached to ensure it is clickable and tracks properly.
Troubleshooting Ad Display Issues #
If an ad is not appearing, hover over the ad inside the Ad Library and click the info icon to view details. Check that the creative is assigned correctly, the ad size matches the device screen size, and that the line item is active.
You can also go to Delivery > Line Items, filter by Running Between Today, and confirm whether the line item is actively scheduled for today.
See this article for more information on how to troubleshoot your Ad Server.
Using the Ad Server in WordPress #
If you are using the MediaOS Theme, you can customize ad placements through Customize > Advertisement Options.
For full page editing, click Edit with Elementor, search for MediaOS Ad Block, and add it to your page.
If you are not using the MediaOS Theme, simply use the HTML Block inside WordPress and paste the embed code manually where you want the ad to appear.
Viewing Ad Server Analytics #
Access Reports in MediaOS, scroll to Delivery, and expand Ad Metrics to run reports by clicks, impressions, or hovers. Customize your reports and click Run Report for real-time ad performance metrics.
Additionally, you can view stats by visiting a specific account’s Stats tab for account-specific ad performance.
Note: You can also automatically pull ad server reports onto client invoices. Navigate to System Settings > General Settings, search Ad Server, and toggle Include Ad Server Report to ON.
Reports on invoices will show clicks, impressions, and engagement metrics for the last 30 days—or backdate intelligently if a line item has recently ended.
Including Ad Server Reports on Invoices #
MediaOS allows you to automatically attach ad server reports to invoices, providing clients with visibility into ad delivery metrics. To enable this setting, click on your profile picture at the bottom of the navigation menu and choose System Settings. Click on General Settings, then type "Ad Server" into the search bar.
Find the toggle for Include Ad Server Report and turn it on.
Note: The invoice must include the specific line item you want the ad server report generated for in order for it to appear. The report will cover the past 30 days leading up to the invoice generation date. If the line item ended earlier, the report will automatically adjust, tracking back 30 days from the final activity date to ensure accurate reporting.
