WP-AdAgent (Pubcontext Semantic DSP)

Prebid.js Header Bidding Plugin for WordPress with Semantic Audience Matching

Features • Installation • Quick Start • Configuration • Documentation

Overview

WP-AdAgent enables WordPress publishers to implement semantic-aware programmatic advertising without any technical integration. The plugin bridges Prebid.js header bidding with Pubcontext's 4D semantic matching engine to optimize publisher revenue through intelligent creative matching and dynamic floor price adjustment.

How It Works

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   WordPress     │────▶│   WP-AdAgent     │────▶│  Pubcontext API │
│   Page Load     │     │  Context Extract │     │  Semantic Match │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                 │                        │
                                 ▼                        ▼
                        ┌──────────────────┐     ┌─────────────────┐
                        │   Prebid.js      │◀────│  Dynamic Floor  │
                        │   Auction        │     │  Adjustment     │
                        └──────────────────┘     └─────────────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │   Ad Rendered    │
                        │   Higher CPM! 💰 │
                        └──────────────────┘

Admin UI Screenshots

Main Dashboard - Overview of ad performance and revenue metrics

Settings Page - Configure Pubcontext API and semantic matching

Prebid Configuration - Select and configure header bidding partners

Placements Manager - Create and manage ad placements visually

Gutenberg Block - Insert ad placements directly in the editor

Features

For Publishers

Feature	Description
One-Click Setup	No coding required - configure everything from WordPress admin
Semantic Matching	AI-powered content analysis for better ad relevance
Dynamic Floor Pricing	Automatic floor adjustment based on content-ad alignment
Visual Placement Manager	Create and manage ad slots with an intuitive UI
Gutenberg Block	Insert ad placements directly in the block editor
Real-Time Analytics	Track impressions, revenue, and optimization metrics
Supply Chain Transparency	Full ads.txt and supply chain configuration

For Advertisers (via Pubcontext DSP)

Lower Wastage - Target only high-intent placements
Better ROI - Audience precision matching
Semantic Transparency - Know exactly where your ads appear

Revenue Impact

┌────────────────────────────────────────────────────────────┐
│                    Expected Revenue Lift                    │
├────────────────────────────────────────────────────────────┤
│  Traditional Programmatic  │████████░░░░░░░░░│  $2.00 CPM  │
│  With WP-AdAgent           │████████████████░│  $3.50 CPM  │
│                            │                  │             │
│  Revenue Lift: 60-80% on matched inventory                 │
└────────────────────────────────────────────────────────────┘

Installation

From WordPress Admin

Go to Plugins > Add New
Search for "WP-AdAgent" or "Pubcontext"
Click Install Now then Activate

Manual Installation

# Download the plugin
wget https://github.com/pubcntext/WP-AdAgent/releases/latest/download/wp-adagent.zip

# Extract to WordPress plugins directory
unzip wp-adagent.zip -d /path/to/wordpress/wp-content/plugins/

# Or clone for development
git clone https://github.com/pubcntext/WP-AdAgent.git wp-content/plugins/wp-adagent

Requirements

Requirement	Version
WordPress	6.0 or higher
PHP	7.4 or higher
MySQL	5.7 or higher

Quick Start

Step 1: Get Your API Key

Sign up at Pubcontext Dashboard
Create a new property for your WordPress site
Copy your API key

Step 2: Configure the Plugin

WordPress Admin > Pubcontext > Settings

Paste your API Key
Click Test Connection to verify
Enable Semantic Matching
Save changes

Step 3: Configure Prebid Bidders

WordPress Admin > Pubcontext > Prebid Configuration

Select your header bidding partners (AppNexus, Rubicon, etc.)
Enter your bidder-specific parameters
Set auction timeout (default: 3000ms)
Save configuration

Step 4: Create Ad Placements

WordPress Admin > Pubcontext > Placements > Add New

Field	Example Value
Placement ID	`sidebar-300x250`
Ad Unit Code	`/1234567/homepage/sidebar`
Sizes	`300x250, 300x600`
Base Floor	`$2.50`
Floor Cap	`$8.00`

Step 5: Insert Placements in Content

Using Gutenberg Block:

Edit a page or post
Add block: Pubcontext Ad Placement
Select your placement from dropdown
Publish!

Using Shortcode:

[pubcontext_placement id="sidebar-300x250"]

Using PHP Template Tag:

<?php pubcontext_placement('sidebar-300x250'); ?>

Configuration

Plugin Settings

Setting	Description	Default
`API Endpoint`	Pubcontext API URL	`https://api.pubcontext.com/match`
`API Key`	Your Pubcontext API key	-
`Semantic Matching`	Enable/disable semantic optimization	Enabled

Prebid Settings

Setting	Description	Default
`Prebid Version`	Prebid.js library version	`7.49.0`
`Auction Timeout`	Max time for bids (ms)	`3000`
`Price Floors`	Enable dynamic floor pricing	Enabled

Placement Settings

Field	Description	Required
`Placement ID`	Unique identifier (slug format)	Yes
`Ad Unit Code`	Prebid ad unit path	Yes
`Sizes`	Supported ad sizes (JSON array)	Yes
`Base Floor`	Minimum CPM price	Yes
`Floor Cap`	Maximum floor limit	No
`Page Rules`	Target specific post types/categories	No
`Context Tags`	Manual semantic tags	No

Architecture

wp-adagent/
├── wp-adagent.php                    # Main plugin file
├── README.md                         # This file
├── readme.txt                        # WordPress.org readme
├── composer.json                     # PHP dependencies
├── package.json                      # JS dependencies
│
├── includes/
│   ├── plugin.php                    # Plugin initialization
│   ├── constants.php                 # Global constants
│   │
│   ├── admin/
│   │   ├── class-admin.php           # Admin menu & pages
│   │   ├── class-settings.php        # API settings
│   │   ├── class-prebid-config.php   # Prebid configuration
│   │   ├── class-placements.php      # Placement CRUD
│   │   └── class-supply-chain.php    # Supply chain config
│   │
│   ├── frontend/
│   │   ├── class-scripts.php         # Script enqueuing
│   │   └── class-blocks.php          # Gutenberg blocks
│   │
│   ├── api/
│   │   ├── class-rest-endpoints.php  # WordPress REST API
│   │   └── class-pubcontext-client.php # Pubcontext API client
│   │
│   └── utils/
│       ├── class-encryption.php      # API key encryption
│       └── class-logger.php          # Debug logging
│
├── assets/
│   ├── js/
│   │   ├── pubcontext-init.js        # Frontend initialization
│   │   ├── context-extractor.js      # Semantic context extraction
│   │   └── admin/                    # Admin JS files
│   │
│   ├── css/
│   │   ├── admin.css                 # Admin styles
│   │   └── blocks.css                # Block editor styles
│   │
│   └── images/
│       └── screenshots/              # Admin UI screenshots
│
├── templates/
│   ├── admin/                        # Admin page templates
│   └── blocks/                       # Block templates
│
└── languages/
    └── wp-adagent.pot                # Translation template

REST API

Get Configuration

POST /wp-json/pubcontext/v1/config

Response:

{
  "placements": [...],
  "prebid": {
    "version": "7.49.0",
    "bidders": [...],
    "timeout": 3000
  },
  "pubcontext": {
    "enabled": true,
    "endpoint": "https://api.pubcontext.com/match"
  }
}

Test API Connection

POST /wp-json/pubcontext/v1/test-api

Payload:

{
  "api_key": "your-api-key",
  "endpoint": "https://api.pubcontext.com/match"
}

Hooks & Filters

Actions

// Fired before Prebid auction starts
do_action('pubcontext_before_auction', $placements);

// Fired after semantic matching completes
do_action('pubcontext_after_match', $match_result);

// Fired when a placement is rendered
do_action('pubcontext_render_placement', $placement_id);

Filters

// Modify context before API call
add_filter('pubcontext_context_data', function($context) {
    $context['custom_field'] = 'value';
    return $context;
});

// Modify floor price calculation
add_filter('pubcontext_floor_price', function($floor, $placement_id, $match_score) {
    return $floor * 1.1; // 10% increase
}, 10, 3);

// Add custom bidders
add_filter('pubcontext_bidder_config', function($bidders) {
    $bidders['custom_bidder'] = ['param1' => 'value'];
    return $bidders;
});

Troubleshooting

Common Issues

Issue	Solution
"API Connection Failed"	Check your API key and endpoint URL
"Prebid not loading"	Ensure no ad blockers are active, check console for errors
"Floors not bumping"	Verify semantic matching is enabled and API is responding
"Block not appearing"	Clear WordPress cache, check Gutenberg is active

Debug Mode

Enable debug logging in wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('PUBCONTEXT_DEBUG', true);

Logs are written to wp-content/debug.log

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

# Clone the repository
git clone https://github.com/pubcntext/WP-AdAgent.git

# Install dependencies
composer install
npm install

# Run tests
composer test
npm test

Support

Documentation: docs.pubcontext.com
Issues: GitHub Issues
Email: support@pubcontext.com

License

This plugin is licensed under the GPL v2 or later.

WP-AdAgent - Prebid.js Header Bidding for WordPress
Copyright (C) 2026 Pubcontext

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

Made with ❤️ by Pubcontext

Website • Twitter • LinkedIn

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
assets		assets
includes		includes
templates/admin		templates/admin
tests		tests
.editorconfig		.editorconfig
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
.stylelintrc.json		.stylelintrc.json
README.md		README.md
babel.config.js		babel.config.js
composer.json		composer.json
jest.config.js		jest.config.js
package.json		package.json
phpcs.xml.dist		phpcs.xml.dist
phpunit.xml.dist		phpunit.xml.dist
postcss.config.js		postcss.config.js
readme.txt		readme.txt
webpack.config.js		webpack.config.js
wp-adagent.php		wp-adagent.php

pubcntext/WP-AdAgent

Folders and files

Latest commit

History

Repository files navigation

WP-AdAgent (Pubcontext Semantic DSP)

Overview

How It Works

Admin UI Screenshots

Features

For Publishers

For Advertisers (via Pubcontext DSP)

Revenue Impact

Installation

From WordPress Admin

Manual Installation

Requirements

Quick Start

Step 1: Get Your API Key

Step 2: Configure the Plugin

Step 3: Configure Prebid Bidders

Step 4: Create Ad Placements

Step 5: Insert Placements in Content

Configuration

Plugin Settings

Prebid Settings

Placement Settings

Architecture

REST API

Get Configuration

Test API Connection

Hooks & Filters

Actions

Filters

Troubleshooting

Common Issues

Debug Mode

Contributing

Support

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages