Add device.ip regression test and clarify Prebid debug docs

Author: ChristianPavilonis

crates/common/src/integrations/prebid.rs

@@ -1550,6 +1550,38 @@ server_url = "https://prebid.example"
         );
     }
 
+    #[test]
+    fn to_openrtb_serializes_device_ip_when_present() {
+        let provider = PrebidAuctionProvider::new(base_config());
+        let mut auction_request = create_test_auction_request();
+        auction_request.device = Some(DeviceInfo {
+            user_agent: Some("test-agent".to_string()),
+            ip: Some("203.0.113.42".to_string()),
+            geo: None,
+        });
+        let settings = make_settings();
+        let request = Request::get("https://pub.example/auction");
+        let context = create_test_auction_context(&settings, &request);
+
+        let openrtb = provider.to_openrtb(&auction_request, &context, None);
+
+        assert_eq!(
+            openrtb
+                .device
+                .as_ref()
+                .and_then(|device| device.ip.as_deref()),
+            Some("203.0.113.42"),
+            "should propagate client IP into OpenRTB device.ip"
+        );
+
+        let serialized = serde_json::to_value(&openrtb).expect("should serialize OpenRTB request");
+        assert_eq!(
+            serialized["device"]["ip"],
+            json!("203.0.113.42"),
+            "should serialize device.ip when client IP is available"
+        );
+    }
+
     #[test]
     fn to_openrtb_omits_debug_flags_when_disabled() {
         let provider = PrebidAuctionProvider::new(base_config());

docs/guide/auction-orchestration.md

@@ -621,15 +621,15 @@ price_floor = 0.50
 
 #### `[integrations.prebid]`
 
-| Field            | Type     | Default           | Description                                                                 |
-| ---------------- | -------- | ----------------- | --------------------------------------------------------------------------- |
-| `enabled`        | bool     | `true`            | Enable Prebid provider                                                      |
-| `server_url`     | string   | —                 | Prebid Server URL (required)                                                |
-| `timeout_ms`     | u32      | `1000`            | Request timeout                                                             |
-| `bidders`        | string[] | `["mocktioneer"]` | Default bidders when not specified per-slot                                 |
-| `auto_configure` | bool     | `true`            | Auto-remove client-side prebid.js scripts                                   |
-| `debug`          | bool     | `false`           | Enable Prebid debug mode (sets `ext.prebid.debug` and `returnallbidstatus`) |
-| `test_mode`      | bool     | `false`           | Set OpenRTB `test: 1` for non-billable test traffic                         |
+| Field            | Type     | Default           | Description                                                                            |
+| ---------------- | -------- | ----------------- | -------------------------------------------------------------------------------------- |
+| `enabled`        | bool     | `true`            | Enable Prebid provider                                                                 |
+| `server_url`     | string   | —                 | Prebid Server URL (required)                                                           |
+| `timeout_ms`     | u32      | `1000`            | Request timeout                                                                        |
+| `bidders`        | string[] | `["mocktioneer"]` | Default bidders when not specified per-slot                                            |
+| `auto_configure` | bool     | `true`            | Auto-remove client-side prebid.js scripts                                              |
+| `debug`          | bool     | `false`           | Enable Prebid debug mode (sets `ext.prebid.debug` and `ext.prebid.returnallbidstatus`) |
+| `test_mode`      | bool     | `false`           | Set OpenRTB `test: 1` for non-billable test traffic                                    |
 
 #### `[integrations.aps]`