You built something useful. An AI coding assistant, a travel planner, a health chatbot, an education tutor. Users are showing up, conversations are happening, and now you want to turn that engagement into revenue without putting up a paywall that kills growth.
This guide walks you through integrating PromptBid from scratch. By the end, your application will be running real-time ad auctions and earning CPM revenue on every qualifying interaction. The whole process takes about five minutes.
What You Need Before You Start
- An AI application that generates conversational responses (chatbot, assistant, agent, etc.)
- A backend you control (Node.js, Python, or any language that can make HTTP requests)
- A free PromptBid builder account (sign up here)
fetch, requests, curl, or any HTTP client. We also offer official SDKs for JavaScript and Python if you prefer.
Get Your API Key
After registering, you'll land on your builder dashboard. Your API key is displayed under the integration tab. It looks like this:
Copy it. You'll need it for every request. Keep it server-side only. Never expose it in client-side code or commit it to version control.
Install the SDK (Optional)
If you want type safety and convenience methods, install the official SDK:
Or skip this step entirely and use raw HTTP requests. The API is straightforward.
Request an Ad
When your application is about to generate a response, make a bid request to PromptBid. Pass context about the conversation so the auction engine can match relevant ads.
The auction runs in under 100ms. You get back an ad object with a headline, description, and optional image URL, plus a tracking pixel for impression counting.
Render the Ad
PromptBid supports two ad formats. Choose the one that fits your UI:
| Format | Best For | How It Looks |
|---|---|---|
| Native | Chat interfaces | Text blended into conversation flow |
| Sponsored | Action-oriented UIs | Button or chip with sponsor label |
Here's a minimal rendering example for the native format:
That's it. The ad appears naturally at the end of your AI's response, clearly labeled as sponsored content. Users see relevant information. You earn revenue.
Track Impressions and Get Paid
Every time an ad renders and you fire the impression pixel, it counts toward your earnings. You can monitor everything in real time from your builder dashboard:
- Total impressions served across all sessions
- Revenue earned at your current effective CPM
- Fill rate showing how often auctions return an ad
- Top-performing verticals so you can optimize context passing
Payouts happen weekly, with a $20 minimum threshold. You keep 60% of all ad revenue (75% if you're a launch partner).
Revenue Projections
What can you realistically expect to earn? Here are projections based on current platform CPMs and typical usage patterns:
| Monthly Active Users | Avg. Sessions/User | Impressions/Month | Est. Monthly Revenue |
|---|---|---|---|
| 1,000 | 8 | 8,000 | $48 |
| 10,000 | 8 | 80,000 | $480 |
| 50,000 | 10 | 500,000 | $3,000 |
| 100,000 | 12 | 1,200,000 | $7,200 |
These estimates assume a $10 CPM floor (the platform minimum) and your 60% revenue share. Actual CPMs will vary by vertical. Health, finance, and enterprise verticals typically command higher rates.
Tips for Maximizing Revenue
Pass rich context
The more context you send in your bid request, the better the auction engine can match relevant ads. Include categories, keywords, user intent signals, and the conversation vertical. Better matching means higher CPMs and better user experience.
Control ad frequency
Don't request an ad on every single interaction. A good starting point is one ad per conversation or one per five messages. Users accept occasional, relevant ads. They reject constant interruptions. Find the frequency that keeps engagement high.
Use native formatting
Ads that match your application's tone and visual style perform dramatically better. If your AI assistant uses casual language, the ad should too. If it's a professional tool, keep ads formal. The less an ad feels like an ad, the more effective it is for everyone.
Monitor your dashboard
Check which verticals and categories drive the highest CPMs for your application. Double down on passing those contexts when relevant. The builder dashboard shows you exactly where your revenue comes from.