Port Floxis: New Adapter by floxis-admin · Pull Request #4529 · prebid/prebid-server-java

floxis-admin · 2026-06-03T19:04:15Z

🔧 Type of changes

new bid adapter

✨ Whats the context?

This PR ports the Floxis bid adapter from PBS-Go to PBS-Java. Floxis is an ad exchange; the adapter sends standard OpenRTB 2.x server-to-server bid requests to the Floxis exchange so PBS publishers can access Floxis demand. It is the Java counterpart of the in-review Go adapter prebid/prebid-server#4811.

Scope:

Media types: banner, video, native, audio (declared for both app and site).
OpenRTB 2.6; GPP supported. The incoming bid request body is forwarded unchanged.
Cookie sync: redirect type.
modifying-vast-xml-allowed: false.

🧠 Rationale behind the change

Bidder params (imp[].ext.prebid.bidder.floxis):

seat (string, required, minLength 1) — the Floxis seat the publisher buys through; appended url-escaped to the endpoint as ?seat=.
region (string, optional, default us-e) — the regional RTB host, used as a subdomain label. Validated as a DNS label by the params JSON schema.
partner (string, optional, default floxis) — white-label partner, used as an additional subdomain label. Validated as a DNS label by the params JSON schema.

Endpoint routing: the fixed parent domain (.floxis.tech) is pinned in the adapter's endpoint config; only the {{Host}} subdomain is filled from the request. The subdomain is region (e.g. us-e.floxis.tech), or partner-region for a named white-label partner (e.g. acme-us-e.floxis.tech); the default floxis partner adds no prefix. region/partner are constrained to DNS labels by the params schema and url-encoded before interpolation, so the host can never be derived from a request-supplied hostname — satisfying the "no fully dynamic hostnames" requirement. seat/region/partner are read from the first imp; a multi-imp request that mixes seats/regions/partners is rejected as bad input (one request routes to one host). The request body is forwarded unchanged (no caller-owned object is mutated).

Bid type resolution treats bid.mtype (OpenRTB 2.6) as authoritative (1/2/3/4 → banner/video/audio/native). When mtype is absent, a single-format imp resolves to that media type; an imp without exactly one format cannot be disambiguated and surfaces a badServerResponse, while other bids in the response continue to be processed.

gvlVendorID is set to 1609 — Floxis (legal entity Ad Tech Company OÜ) is registered as an IAB TCF vendor with GVL ID 1609, so EU/TCF consent is enforced against that vendor ID.

🔎 New Bid Adapter Checklist

verify email contact works
NO fully dynamic hostnames
geographic host parameters are NOT required
direct use of HTTP is prohibited - implement an existing Bidder interface that will do all the job
if the ORTB is just forwarded to the endpoint, use the generic adapter - the adapter is not a plain forward: it performs region/partner-based host routing, url-escaped seat injection, and mtype/single-format bid-type resolution, so a dedicated adapter is warranted
cover an adapter configuration with an integration test

🧪 Test plan

FloxisBidderTest — unit tests covering region/partner host resolution (default, explicit region, partner-prefixed host), url-encoding of the seat and the host parts, request-forwarded-unchanged, the per-imp consistency check, and the full getMediaTypeForBid matrix (mtype-authoritative for all four types, unsupported mtype, single-format fallback for all four, the non-single-format error, imp-not-found), plus per-bid error accumulation. JaCoCo reports ~100% line coverage on FloxisBidder.
FloxisTest integration test — exercises the full auction path against WireMock and validates the adapter configuration is reachable.
mvn test (unit + IT) and mvn checkstyle:check pass locally.

🏎 Quality check

Are your changes following our code style guidelines?
Are there any breaking changes in your code? — No.
Does your test coverage exceed 90%? — Yes (~100% line on the bidder).
Are there any erroneous console logs, debuggers or leftover code in your changes? — No.

Companion Go adapter: prebid/prebid-server#4811. The corresponding prebid.github.io documentation PR is forthcoming.

Please add the do not port label per the porting guide (I do not have label permissions on this repo).

…ersion guard

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@JsonProperty

…sistency seat lacked the explicit @JsonProperty that region and partner carry; add it so all three params are annotated uniformly (no behavioural change — seat already maps to the 'seat' key).

…tner are subdomain labels) Per the dev-guide, a bidder endpoint domain must not be fully variable. Move the fixed .floxis.tech suffix into the bidder-config endpoint and have resolveBidHost return just the validated region/partner subdomain label. Resolved URLs are unchanged (e.g. https://us-e.floxis.tech/pbs); matches the fixed-suffix pattern of merged region-routed adapters (rubicon, clydo, mediago, algorix).

CTMBNara · 2026-06-17T18:02:55Z

+        if (CollectionUtils.isEmpty(request.getImp())) {
+            return Result.withError(BidderError.badInput("no impressions in the bid request"));
+        }


No need for this check

Good point — removed. The framework already guarantees at least one imp by the time this runs.

CTMBNara · 2026-06-17T18:03:44Z

+    // A single request routes to one Floxis host/seat (the seat is the URL query key, partner+region
+    // the host). All imps must therefore share the same seat, region and partner; a mismatch is a
+    // misconfigured request rather than something to silently route on imp[0]'s key.


Remove comment

CTMBNara · 2026-06-17T18:08:40Z

+            }
+        }
+        return first;
+    }


Let's replace this method with smth like this:

@Override public Result<List<HttpRequest<Void>>> makeHttpRequests(BidRequest bidRequest) { final List<Imp> imps = bidRequest.getImp(); final ExtImpFlipp firstImpExt; try { firstImpExt = parseImpExt(imps.getFirst()); } catch (PreBidException e) { return Result.withError(BidderError.badInput(e.getMessage())); } try { for (int i = 1; i < imps.size(); i++) { final ExtImpFlipp impExt = parseImpExt(imps.get(i)); validateImpExt(impExt, firstImpExt); } } catch (PreBidException e) { return Result.withError(BidderError.badInput(e.getMessage())); } ... }

Done — reworked it into the parse-first-then-validate-the-rest shape you suggested.

CTMBNara · 2026-06-17T20:21:22Z

+@PropertySource(value = "classpath:/bidder-config/floxis.yaml",
+        factory = YamlPropertySourceFactory.class)


one-line it

CTMBNara · 2026-06-17T20:21:55Z

+    @JsonProperty("seat")
+    String seat;
+
+    @JsonProperty("region")
+    String region;
+
+    @JsonProperty("partner")
+    String partner;


No need for @JsonProperty here

Removed — the field names already match the JSON keys, so they weren't needed.

CTMBNara · 2026-06-17T20:26:17Z

+    // region/partner are interpolated into the request host, so each must be a valid DNS label —
+    // otherwise a value carrying URL delimiters could rewrite the request origin.


remove comment

CTMBNara · 2026-06-17T20:27:13Z

+                ? resolvedRegion
+                : resolvedPartner + "-" + resolvedRegion;


Encode dynamic parts

Done — the host parts go through HttpUtil.encodeUrl now as well.

CTMBNara · 2026-06-17T20:27:51Z

+        if (bidResponse == null || CollectionUtils.isEmpty(bidResponse.getSeatbid())) {
+            return Result.empty();
+        }
+
+        final List<BidderError> errors = new ArrayList<>();
+        final List<BidderBid> bids = new ArrayList<>();
+        for (SeatBid seatBid : bidResponse.getSeatbid()) {
+            if (seatBid == null || CollectionUtils.isEmpty(seatBid.getBid())) {
+                continue;
+            }
+            for (Bid bid : seatBid.getBid()) {
+                try {
+                    bids.add(BidderBid.of(bid, getMediaTypeForBid(bidRequest.getImp(), bid), bidResponse.getCur()));
+                } catch (PreBidException e) {
+                    errors.add(BidderError.badServerResponse(e.getMessage()));
+                }
+            }
+        }
+
+        return Result.of(bids, errors);


extract to separate method (see other bidders)

Extracted into a separate extractBids method, matching the other bidders.

CTMBNara · 2026-06-17T20:28:12Z

+    // Resolves the bid's media type. When bid.mtype (OpenRTB 2.6) is set it is treated as
+    // authoritative. When unset, a single-format imp's media type is used; multi-format imps
+    // without mtype cannot be disambiguated and surface an error.


remove comment

Dropped it.

CTMBNara · 2026-06-17T20:53:26Z

+            int formats = 0;
+            BidType resolved = null;
+            if (imp.getBanner() != null) {
+                formats++;
+                resolved = BidType.banner;
+            }
+            if (imp.getVideo() != null) {
+                formats++;
+                resolved = BidType.video;
+            }
+            if (imp.getAudio() != null) {
+                formats++;
+                resolved = BidType.audio;
+            }
+            if (imp.getXNative() != null) {
+                formats++;
+                resolved = BidType.xNative;
+            }
+            if (formats == 1) {
+                return resolved;
+            } else if (formats > 1) {
+                throw new PreBidException(
+                        "bid for multi-format imp %s requires bid.mtype to disambiguate".formatted(bid.getImpid()));
+            } else {
+                throw new PreBidException(
+                        "unable to resolve media type for impression %s".formatted(bid.getImpid()));
+            }


Add countFormats method.
if count != 1 -> exception
else determine format

Done — added a countFormats helper; it throws unless exactly one format is present, otherwise resolves that format.

@JsonProperty

Drop redundant in-adapter validation covered elsewhere: the empty-imp guard (framework guarantees at least one imp), the region/partner DNS-label regex (already enforced by floxis.json), and the custom isBlank helper (use StringUtils.isBlank). Restructure makeHttpRequests to parse the first imp ext then validate the rest in a loop; extract extractBids and countFormats helpers; URL-encode the dynamic host parts; drop redundant @JsonProperty on ExtImpFloxis and one-line @propertysource; remove explanatory comments. Tests updated to match.

floxis-admin · 2026-06-18T08:55:22Z

Thanks for the thorough review @CTMBNara — all of it is addressed in 21d1900: dropped the redundant empty-imp check, the in-code DNS regex (floxis.json already covers it) and the custom isBlank helper; reworked makeHttpRequests into the parse-first/validate-the-rest shape; extracted extractBids and countFormats; url-encoded the host parts; and cleared out the comments. Also synced the PR description with the final code. Ready for another look whenever you have a moment.

Port Floxis: New Adapter

07efcf6

floxis-admin mentioned this pull request Jun 3, 2026

Floxis Bid Adapter: add Prebid Server support (Go + Java) prebid/prebid.github.io#6596

Open

floxis-admin and others added 3 commits June 5, 2026 16:31

Floxis: set vendor-id to 1609 (IAB TCF registration approved)

f6797a3

Floxis: declare ortb-version 2.6 + multi-imp seat guard + IT downconv…

41c57c2

…ersion guard

Floxis: mirror Prebid.js seat/region/partner host logic

86a34b6

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

floxis-admin force-pushed the floxis-new-adapter branch from 8763dcd to 86a34b6 Compare June 12, 2026 09:00

floxis-admin added 2 commits June 15, 2026 21:15

Floxis adapter: annotate ExtImpFloxis.seat with @JsonProperty for con…

ee616ff

…sistency seat lacked the explicit @JsonProperty that region and partner carry; add it so all three params are annotated uniformly (no behavioural change — seat already maps to the 'seat' key).

CTMBNara requested changes Jun 17, 2026

View reviewed changes

		@PropertySource(value = "classpath:/bidder-config/floxis.yaml",
		factory = YamlPropertySourceFactory.class)

		// region/partner are interpolated into the request host, so each must be a valid DNS label —
		// otherwise a value carrying URL delimiters could rewrite the request origin.

Conversation

floxis-admin commented Jun 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔧 Type of changes

✨ Whats the context?

🧠 Rationale behind the change

🔎 New Bid Adapter Checklist

🧪 Test plan

🏎 Quality check

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

floxis-admin commented Jun 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

floxis-admin commented Jun 3, 2026 •

edited

Loading