Dashboard

Track your earnings and ad performance

No API Key
This Month
$0.00
Your earnings this month
Last 30 Days Earnings
$0.00
Total Earnings
$0.00
$250 Activation Bonus
Earn $250 after 25,000 filled impressions
In Progress
0 / 25,000 impressions 0%
Total Earnings
Pending Payout
Available for withdrawal
Fill Rate
Percentage of requests filled
Total Impressions
All time
Contextual Aware No Ads
Sessions intentionally suppressed
Daily Revenue Trend
Today's Hourly Earnings

Recent Impressions

Time Creative Type Position Bid Amount Status
Loading data...
Peak Hour Earnings
Avg Hourly Earnings
Best Day
Hourly Earnings
Daily Earnings
Impressions vs Clicks

All Impressions

Time Creative Type Position Bid Amount Your Earnings (60%) Status
Loading impressions...

Step 1: Install the SDK

Choose your package manager and install the PromptBid SDK.

Python Installation
Terminal
Copy
pip install promptbid
JavaScript Installation
Terminal
Copy
npm install @promptbid/sdk

Step 2: Initialize with API Key

Initialize the SDK with your API key. Keep it private and never commit it to version control.

Your API Key
Configuration
Copy
pb_live_••••••••••••••••

Step 3: Request Ads with Context

Call the bid endpoint to fetch relevant ads within your conversation flow.

Making a Bid Request
JavaScript
Copy
const response = await fetch('/api/v1/bid/simple', {
  method: 'POST',
  headers: {
    'X-API-Key': 'pb_live_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    context: {
      session_id: 'sess_unique_id',
      categories: ['technology', 'productivity'],
      keywords: ['cloud', 'database', 'api']
    }
  })
});

const result = await response.json();

Step 4: Render by Creative Type

PromptBid supports flexible conversational ad formats. These example renderers prioritize inline text placements that stay native to your UI.

Native
Text-based ads that blend naturally into conversation. Best for chat interfaces and AI responses.
Rendering Code
inject_into_response(ad.headline + ': ' + ad.description)
Inline
Disclosed inline text placement with headline, copy, and CTA. Renders directly in the response thread.
Rendering Code
append_inline_text(ad.headline, ad.description, ad.cta_text)
Sponsored
Inline call-to-action sentence that appears as a disclosed follow-up line in your UI.
Rendering Code
append_inline_cta(ad.cta_text, ad.cta_url)
Complete Integration Example
JavaScript
Copy
const ads = result.ads;

ads.forEach(ad => {
  if (ad.creative_type === 'native') {
    inject_into_response(ad.headline + ': ' + ad.description);
  } else if (ad.creative_type === 'inline') {
    append_inline_text(ad.headline, ad.description, ad.cta_text);
  } else if (ad.creative_type === 'sponsored') {
    append_inline_cta(ad.cta_text, ad.cta_url);
  }
});

Test Configuration

Unique identifier for this conversation session
Comma-separated content categories
Comma-separated keywords for targeting

Response

Application Profile

The name of your application
Contact email for your account

Add AI App / Website

Add publisher inventory and its monetization controls. This creates the publisher app record, stores IAB categories for advertiser matching, and issues a publisher API key for integration.

AI Tool
Public AI tool or website name advertisers will see when evaluating inventory.
Public website, app, or tool URL associated with this publisher inventory.
Select IAB tier 1 categories
Required. Select one or more IAB Tech Lab Content Taxonomy 3.1 tier-1 categories so advertisers understand this publisher inventory.
Maximum ads shown per user session. Lower caps improve user experience.
Controls how many ad placements are available per session.
Press Enter to add categories you never want shown. DnD example: exclude IAB1-8: Gambling/Casino and contextual aware no Ads to suppress unsafe or immersion-breaking placements.

API Key

pb_live_••••••••••••••••
Keep this key private. Never commit it to version control.

Revenue Information

You earn 60% of every impression served through PromptBid. Revenue is calculated daily and available for withdrawal once it reaches $25. Payouts are processed monthly via Stripe Connect.