OpenRTB 2.6 for AI

Overview

OpenRTB (Real-Time Bidding) is the industry standard protocol for programmatic advertising auctions. PromptBid implements OpenRTB 2.6 with additive extensions — standard fields work as expected, and our ext.promptbid namespace carries AI-specific signals.

Bid Request Object

The bid request follows the standard OpenRTB 2.6 BidRequest schema. Required fields are the request ID, at least one impression object, and the app object identifying the builder's application.

Impression Object

Each impression represents a single ad placement opportunity within a conversation turn.

AI Extensions — ext.promptbid

These fields live in the ext.promptbid namespace on the bid request and carry the signals that make PromptBid auctions context-aware. All fields are optional — the more context you provide, the better the ad relevance and CPM.

Bid Response Object

Winning bids are returned in a standard OpenRTB 2.6 BidResponse. The creative payload is included inline in the adm field — no additional creative fetch is needed.

Ad Formats

PromptBid supports two ad formats designed for conversational AI interfaces. Specify your preferred format in imp.ext.promptbid.format or omit it to let the exchange choose based on the winning bid.

Code Examples

Full bid request and response cycle in JavaScript and cURL.

Bid Request

const response = await fetch(
  "https://api.promptbid.ai/api/v1/bid/openrtb",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer pk_live_...",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      id: "req-abc123",
      imp: [{
        id: "imp-1",
        bidfloor: 10.0,
        ext: {
          promptbid: {
            format: "sponsored-reply",
            placement: "after-response"
          }
        }
      }],
      app: {
        bundle: "com.example.assistant",
        name: "TravelBot",
        cat: ["IAB20"]
      },
      ext: {
        promptbid: {
          context: "user planning a week-long trip to Tokyo",
          intent: "purchase",
          keywords: ["travel", "tokyo", "hotels"],
          turn_count: 4,
          sentiment: "positive"
        }
      }
    })
  }
);

const bid = await response.json();
// bid.seatbid[0].bid[0].adm contains the creative

curl -X POST https://api.promptbid.ai/api/v1/bid/openrtb \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "id": "req-abc123",
    "imp": [{
      "id": "imp-1",
      "bidfloor": 10.0,
      "ext": {
        "promptbid": {
          "format": "sponsored-reply",
          "placement": "after-response"
        }
      }
    }],
    "app": {
      "bundle": "com.example.assistant",
      "name": "TravelBot",
      "cat": ["IAB20"]
    },
    "ext": {
      "promptbid": {
        "context": "user planning a week-long trip to Tokyo",
        "intent": "purchase",
        "keywords": ["travel", "tokyo", "hotels"],
        "turn_count": 4,
        "sentiment": "positive"
      }
    }
  }'

Example Response

{
  "id": "req-abc123",
  "seatbid": [{
    "bid": [{
      "id": "bid-xyz789",
      "impid": "imp-1",
      "price": 18.50,
      "adomain": ["booking.com"],
      "cat": ["IAB20-3"],
      "adm": "{\"headline\":\"Park Hyatt Tokyo — 20% off this week\",\"body\":\"Shinjuku location, Michelin dining, panoramic city views.\",\"cta\":\"View Rates\",\"url\":\"https://...\",\"tracking\":{\"imp\":\"https://t.promptbid.ai/...\",\"click\":\"https://t.promptbid.ai/...\"}}",
      "ext": {
        "promptbid": {
          "format": "sponsored-reply",
          "ttl": 300
        }
      }
    }]
  }],
  "cur": "USD"
}

Privacy Model

PromptBid's auction model is built on contextual targeting — no user profiles, no cross-app tracking, no PII in bid streams.

• No user IDs, device IDs, or IP addresses in bid requests
• Conversation context is processed through differential privacy before reaching demand partners
• Builders control context granularity: high (topic-level only), medium (topic + keywords), low (topic + keywords + intent)
• Advertisers target by context category and intent — never by user identity
• All tracking is first-party and aggregate — impression and click counts, no individual-level data
• GDPR, CCPA, and SOC 2 Type II compliant

Compliance & Versioning

PromptBid maintains strict compatibility with the OpenRTB 2.6 specification published by the IAB Tech Lab. All AI-specific extensions are additive and never break standard implementations.