# Signal ( oRTB/Native )
## Google Tag Manager (Recommended)
{% hint style="success" %}
**Recommended Integration Method**\
GTM integration requires no code changes to your website and allows easy enable/disable without deployments.
{% endhint %}
### Setup Steps
{% stepper %}
{% step %}
### Get Your Script from Dashboard
* Log into your Panxo dashboard at `app.panxo.ai`
* Navigate to **Settings → Integration**
* Copy your integration script (format: ``)
{% hint style="info" %}
**Your Script:**\
Each property receives a unique hash-based script URL. This hash is automatically generated and displayed in your dashboard. Simply copy the complete script tag.
{% endhint %}
{% endstep %}
{% step %}
### Create GTM Tag
In Google Tag Manager, create a new **Custom HTML** tag and paste your script:
{% code title="Custom HTML (example)" %}
```html
```
{% endcode %}
Example Script Format:
| Component | Description | Example |
| --------- | ----------------------------------- | ----------------------------------------- |
| **URL** | Hash-based script URL | `https://cdn.panxo.ai/o/6c6cfb20039e1773` |
| **Hash** | Unique identifier for your property | `6c6cfb20039e1773` |
{% hint style="warning" %}
**Important:** Use the exact script provided in your dashboard. Each property has a unique hash that cannot be shared or reused.
{% endhint %}
{% endstep %}
{% step %}
### Configure Trigger
* Set trigger to fire on **"All Pages"** or specific pages
* Use **"Page View"** trigger type
{% endstep %}
{% step %}
### Test & Publish
* Use GTM Preview mode to verify script loads
* Publish container when ready
{% endstep %}
{% endstepper %}
### Verification
{% hint style="info" %}
**Verification Checklist:**
* Script appears in Network tab as `/o/{hash}` (e.g., `/o/6c6cfb20039e1773`)
* Dashboard shows "Script Verified" status in real-time (verification happens immediately after script integration)
{% endhint %}
***
## Direct Script Integration
**When to Use:**
* If you don't use GTM
* Need more control over script placement
* WordPress sites (consider plugin instead)
### Setup
Add to your `` section using the script from your dashboard:
{% code title="Example (head)" %}
```html
```
{% endcode %}
{% hint style="warning" %}
**Important Notes:**
* Use the exact script provided in your dashboard (Settings → Integration)
* Each property has a unique hash-based URL
* Place in `` for early detection
* `async` attribute ensures non-blocking load
* Script auto-initializes when DOM is ready
{% endhint %}
***
## WordPress Plugin
**When to Use:**
* WordPress-powered sites
* Want automatic `ads.txt` management
* Prefer plugin-based integration
* Zero-configuration setup
### Installation
{% stepper %}
{% step %}
Go to **WordPress admin → Plugins → Add New**
{% endstep %}
{% step %}
Search for **"Panxo AI Monetization"**
{% endstep %}
{% step %}
Click **"Install Now"** and **"Activate"**
{% endstep %}
{% endstepper %}
**Plugin URL:** [WordPress.org Plugin Directory](https://wordpress.org/plugins/panxo-ai-monetization/)
### Automatic Configuration
{% hint style="success" %}
**Zero-Configuration Setup**\
The plugin handles everything automatically. Setup completes in less than 1 minute.
{% endhint %}
**What the Plugin Does Automatically:**
* Registers your WordPress site with Panxo
* Creates your property
* Integrates the Panxo script into ``
* Updates your `ads.txt` file with required entries
* Begins the learning process
### Verification
* Dashboard shows **"Script Verified"** and **"Ads.txt Verified"** when complete
* Monitor learning phase progress from WordPress dashboard
***
## Prebid.js / OpenRTB Integration
**When to Use:**
* Already using Prebid.js for header bidding
* Want Panxo to compete in your existing auction
* Running a multi-SSP setup
* Direct OpenRTB integration
{% hint style="info" %}
**Best For:** Publishers with existing Prebid infrastructure who want to add AI traffic monetization to their demand stack.
{% endhint %}
### Prerequisites
From your Panxo Dashboard (Settings > OpenRTB/Prebid):
1. **Endpoint Key** - A unique hash for your property (e.g., `06dc70992da98be6`)
2. **Signal Script URL** - `https://cdn.panxo-sys.com/o/{ENDPOINT_KEY}`
{% hint style="warning" %}
**Important Domain:** For Prebid/OpenRTB, use `cdn.panxo-sys.com` (NOT cdn.panxo.ai). This is required for proper cookie syncing.
{% endhint %}
### Steps
{% stepper %}
{% step %}
### Install Signal Script
The Signal script **must load before** Prebid.js:
{% code title="head (signal + prebid)" %}
```html
```
{% endcode %}
The Signal script:
* Creates user identity (`panxo_uid`) in localStorage
* Detects AI-referred traffic
* Enables Panxo to bid on your inventory
{% endstep %}
{% step %}
### Configure Prebid Ad Unit
{% code title="adUnits example" %}
```javascript
var adUnits = [{
code: 'ad-slot-1',
mediaTypes: {
banner: {
sizes: [[300, 250], [728, 90], [320, 50]]
}
},
bids: [{
bidder: 'panxo',
params: {
propertyKey: '06dc70992da98be6' // Your endpoint key (same hash as Signal script)
}
}]
}];
```
{% endcode %}
{% endstep %}
{% step %}
### Initialize Prebid
{% code title="Prebid initialization" %}
```javascript
var pbjs = pbjs || {};
pbjs.que = pbjs.que || [];
pbjs.que.push(function() {
pbjs.addAdUnits(adUnits);
pbjs.requestBids({
timeout: 2000,
bidsBackHandler: function() {
var winner = pbjs.getHighestCpmBids('ad-slot-1')[0];
if (winner) {
renderAd(winner);
}
}
});
});
function renderAd(bid) {
var container = document.getElementById('ad-slot-1');
var iframe = document.createElement('iframe');
iframe.width = bid.width;
iframe.height = bid.height;
iframe.frameBorder = '0';
container.appendChild(iframe);
iframe.contentWindow.document.open();
iframe.contentWindow.document.write(bid.ad);
iframe.contentWindow.document.close();
}
```
{% endcode %}
{% endstep %}
{% endstepper %}
### Bid Parameters
| Parameter | Required | Description |
| ------------- | -------- | ------------------------------------------------- |
| `propertyKey` | Yes | Your endpoint key hash (e.g., `06dc70992da98be6`) |
| `floor` | No | Minimum CPM in USD |
### How Bidding Works
{% hint style="info" %}
**AI-Only Bidding**\
Panxo only bids when AI traffic is detected. You'll only receive bids for users coming from ChatGPT, Perplexity, Claude, etc.
{% endhint %}
1. Signal script loads and creates `panxo_uid` in localStorage
2. Signal script detects if user came from AI and stores signal
3. Prebid requests bids from all configured bidders
4. Panxo adapter reads `panxo_uid` and sends OpenRTB request
5. Panxo server checks if user has AI signal and returns bid
6. If Panxo wins auction, ad is displayed
### Expected Performance
| Metric | Typical Value |
| --------- | ---------------------- |
| CPM | $5 - $15 |
| Fill Rate | 5-15% of total traffic |
{% hint style="success" %}
**Why Low Fill Rate is Normal**\
Panxo targets only AI traffic (typically 5-15% of visits). This focused approach delivers premium CPMs without affecting your other demand sources.
{% endhint %}
### Full Example
{% code title="Full example (HTML)" %}
```html
```
{% endcode %}
### Testing
Enable Prebid debug mode:
{% code title="Enable debug" %}
```javascript
pbjs.setConfig({ debug: true });
```
{% endcode %}
Check browser console for:
* `Panxo: Sending bid request` - Request sent
* `Panxo: Bid received` - Bid returned
* `Panxo: User ID not found` - Signal script not loaded
Verify Signal script:
{% code title="Check panxo\_uid" %}
```javascript
console.log(localStorage.getItem('panxo_uid'));
// Should show: "d9433353-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
```
{% endcode %}
### Troubleshooting
No bids received?
1. Verify Signal script URL uses `cdn.panxo-sys.com` (NOT cdn.panxo.ai)
2. Check localStorage for `panxo_uid` (DevTools > Application > Local Storage)
3. Verify endpoint key matches between Signal script and Prebid params
4. Panxo only bids if user has AI signal (came from AI recently)
Low fill rate?
* This is expected - Panxo only bids on AI-referred traffic
* Check AI traffic percentage in your Panxo dashboard
Need help?
* Email:
* Dashboard: app.panxo.ai
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developers.panxo.ai/integrations/signal-ortb-native.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.