openrtb26

Rust types for the OpenRTB 2.6 specification with full serde JSON support.

Features

• Complete coverage of the OpenRTB 2.6 bid request and response objects
• Serialize / deserialize with serde_json out of the box
• Spec-correct default values (e.g. at = 2, cur = "USD", cattax = 1)
• Optional fields are skipped when serializing to keep payloads lean
• Unknown fields are silently ignored during deserialization for forward-compatibility
• All types derive Debug, Clone, and PartialEq

Quick start

Add to your Cargo.toml:

[dependencies]
openrtb26 = "0.1"
serde_json = "1"

Build a bid request

use openrtb26::{BidRequest, Imp, Banner, Site};

let request = BidRequest {
    id: "auction-1234".to_string(),
    imp: vec![Imp {
        id: "1".to_string(),
        banner: Some(Banner {
            w: Some(300),
            h: Some(250),
            ..Default::default()
        }),
        ..Default::default()
    }],
    site: Some(Site {
        domain: Some("example.com".to_string()),
        page: Some("https://example.com/article".to_string()),
        ..Default::default()
    }),
    ..Default::default()
};

let json = serde_json::to_string(&request).unwrap();

Parse a bid response

use openrtb26::BidResponse;

let raw = r#"{
    "id": "auction-1234",
    "seatbid": [{
        "bid": [{
            "id": "1",
            "impid": "1",
            "price": 4.50,
            "adm": "<div>ad markup</div>",
            "adomain": ["advertiser.com"]
        }]
    }]
}"#;

let response: BidResponse = serde_json::from_str(raw).unwrap();
assert_eq!(response.seatbid.unwrap()[0].bid[0].price, 4.50);

Type mapping

All types are re-exported from the crate root for ergonomic imports (use openrtb26::Bid).

License

MIT