FAIR

Federated and Independent Repositories

AdPageX

Plugin Banner

AdPageX

by adpagex

Download
Description

AdPageX makes it easy to integrate and manage Google AdSense for Search (AFS) on any WordPress website. Set up monetized search ads in minutes — no coding needed.

With AdPageX you can:

  • Place ads exactly where you want — after any paragraph, before content, after images, after headings, or inside custom HTML elements
  • Target specific page types — posts, pages, homepage, search pages, category archives, and tag pages
  • Target specific devices — desktop, tablet, or mobile only
  • Show a Read More button to gate premium content and display an ad before revealing the rest of the article
  • Enable Rewarded Ads — show a rewarded ad triggered by a Read More button click or a custom CSS selector, with configurable cooldown periods
  • Manage multiple placements — create as many configurations as you need and switch the active one from Settings
  • Insert via shortcode or PHP — [adpagex id="..."] or <?php echo adpagex('...'); ?>

Supported Ad Locations

  • After / Before paragraph #N
  • After / Before full content block
  • After / Before image #N
  • After / Before heading #N
  • Inside a custom element (by ID)

Rewarded Ads

AdPageX supports Google Ad Manager rewarded ads. Trigger them from a Read More button or any custom CSS selector. Configurable cooldown prevents users from seeing the same rewarded ad too frequently.

Coming Soon

  • Google AdSense display ads
  • Google Ad Manager (GAM)
  • Outstream video ads
  • ASAS (AdopX Smart Ad Shield)

Privacy & External Services

This plugin connects to the AdopX API (api.adopx.com) to fetch the ad script for your placement. The following data is sent when you save a placement:

  • Your Publisher ID (pub-ID)
  • Your Style ID
  • Your site URL
  • Ad placement settings (target element, keyword count, sponsored link count)
  • Reward configuration (if rewarded ads are enabled)

No personal visitor data is collected or transmitted. The API response is a JavaScript ad script stored in your WordPress database.

By using this plugin you agree to the AdopX Terms of Service and Privacy Policy.

This plugin also loads the Google AdSense for Search (AFS) script from google.com:

  • Script URL: https://www.google.com/adsense/search/ads.js
  • Loaded on: frontend pages where an active ad placement is configured and enabled
  • Data sent: ad impressions and search events are reported to Google as part of normal AFS ad delivery
  • Google Terms of Service
  • Google Privacy Policy

Automatic Installation (Recommended)

  1. Go to Plugins Add New in your WordPress admin
  2. Search for AdPageX
  3. Click Install Now then Activate

Manual Installation

  1. Download the plugin zip file
  2. Go to Plugins Add New Upload Plugin
  3. Upload the zip and click Install Now, then Activate

First Setup

  1. After activating, go to AdPageX Placements in the admin menu
  2. Click Add New Placement
  3. Enter your AdSense for Search Publisher ID and Style ID
  4. Choose where the ad should appear (location and position)
  5. Select which page types and devices should show the ad
  6. Click Save Placement
  7. Go to AdPageX Settings and set your new placement as Active

The ad will now appear automatically on your site.

Where do I get my Publisher ID and Style ID?

Log in to your Google AdSense account, go to Ads By ad unit Search ads, and create or view an existing AFS unit. Your Publisher ID starts with partner-pub- and the Style ID is a numeric code.

What is AdSense for Search (AFS)?

Google AdSense for Search lets you embed a search box on your website. When a visitor searches, Google shows relevant sponsored results alongside organic results and you earn revenue from clicks.

Will this plugin work with my theme?

AdPageX inserts ads into post content via the standard the_content WordPress filter and uses wp_enqueue_script() / wp_enqueue_style() for assets. It is compatible with all standard WordPress themes.

Can I show ads only on mobile or only on desktop?

Yes. Each placement has a Device Targeting option where you can restrict display to desktop, tablet, mobile, or any combination.

What is a Rewarded Ad?

A rewarded ad is a full-screen ad that users can choose to watch in exchange for accessing gated content. AdPageX supports rewarded ads via Google Ad Manager. You can set a cooldown (in minutes) so the same user is not shown the ad again too soon.

How does the Read More button work?

When enabled, the plugin splits the post content at the insertion point. Visitors see the beginning of the post and a Read More button. Clicking the button triggers the rewarded ad (if configured) or simply reveals the rest of the content.

Can I use multiple placements at the same time?

Currently only one placement is active at a time. You can create multiple placements and switch between them in Settings.

Does this plugin store visitor data?

No. AdPageX does not collect or store any personal visitor data. The only data sent externally is your publisher configuration (to fetch the ad script from the AdopX API).

Is this plugin GDPR compliant?

AdPageX itself does not collect personal data. However, Google AdSense for Search may set cookies as part of ad delivery. You should disclose this in your site’s privacy policy and cookie notice in accordance with GDPR and applicable local law.

How do I insert an ad manually using a shortcode?

Use [adpagex id="YOUR_PLACEMENT_ID"] in any post, page, or widget. The placement ID is shown in the Placements list in the admin dashboard.

How do I insert an ad in a PHP template?

Add this to your theme template:

The ad is not showing. What should I check?

  1. Make sure the placement is set as Active in Settings
  2. Make sure the Status of the placement is set to Enable
  3. Confirm the page type (post, page, etc.) is checked under Where to Display
  4. Check the device type matches your current device
  5. Try clearing your page cache if you use a caching plugin

1.0

  • Initial release
  • AdSense for Search (AFS) integration
  • 9 ad insertion locations: after/before paragraph, content, image, heading, custom element
  • Read More button with content gating
  • Rewarded Ads support (Google Ad Manager)
  • Device targeting (desktop / tablet / mobile)
  • Page type targeting (posts, pages, home, search, category, archive)
  • Multiple placements with single active selection
  • Shortcode [adpagex id="..."] and PHP helper adpagex()
Back to top