New Adapter: Ezoic by austinbyron · Pull Request #4823 · prebid/prebid-server

austinbyron · 2026-06-11T16:20:24Z

Overview

This PR adds a new bid adapter for Ezoic (https://www.ezoic.com), an ad monetization platform.

Bidder code: ezoic
Maintainer: prebid@ezoic.com
GVL Vendor ID: 347
Endpoint: https://g.ezoic.net/ezoic/prebid/adapter/ortb (global, HTTPS, keep-alive)
OpenRTB: 2.6 declared in bidder-info
Capabilities: site + app, banner / video / native

Design notes

The adapter is a deliberately thin transport: it forwards the OpenRTB request unchanged to Ezoic's bidding endpoint and maps the OpenRTB response back, taking the media type from bid.mtype. Eligibility, demand selection, and creative construction all happen server-side at Ezoic. No required bidder params (placementId is optional); no bid mutation; no transaction ID creation/overwrites; all networking through the core framework.

Registration required: Ezoic returns bids only for publisher domains that have been registered and approved. Requests for unapproved inventory receive a no-bid (HTTP 204) response. This is stated in the bidder-info yaml and in the documentation PR's Registration section.

Testing

Exemplary tests for all three advertised media types (simple-banner, simple-video, simple-native) plus supplemental (204 / 400 / 500 / invalid body / unsupported mtype) JSON tests, and unit tests for the builder, no-content handling, media type mapping, and params schema.
./validate.sh passes (full suite, fmt, vet).

Manual end-to-end test (per the new-adapter checklist)

Built this branch and ran it locally against the live production endpoint:

The doc's banner request template with "ezoic": {} and site.page: prebid.org (not a registered domain): HTTP 200 auction response with no seatbid; ext.debug.httpcalls.ezoic shows the call to https://g.ezoic.net/ezoic/prebid/adapter/ortb returning a clean 204 in ~150ms — the registration gate behaving as documented.
The same request shape for a registered test domain: valid banner bid (price 20.0, mtype: 1, 300x250, ~11.5KB markup), responsetimemillis.ezoic 45–56ms across warm repeats, a bid returned on every attempt.

Documentation

Docs PR to prebid.github.io: prebid/prebid.github.io#6614

austinbyron · 2026-06-11T16:20:47Z

Documentation PR: prebid/prebid.github.io#6614

github-actions · 2026-06-26T16:35:11Z

Code coverage summary

Note:

Prebid team doesn't anticipate tests covering code paths that might result in marshal and unmarshal errors
Coverage summary encompasses all commits leading up to the latest one, 5127e7f

ezoic

Refer here for heat map coverage report

github.com/prebid/prebid-server/v4/adapters/ezoic/ezoic.go:20:	Builder			100.0%
github.com/prebid/prebid-server/v4/adapters/ezoic/ezoic.go:27:	MakeRequests		85.7%
github.com/prebid/prebid-server/v4/adapters/ezoic/ezoic.go:47:	MakeBids		100.0%
github.com/prebid/prebid-server/v4/adapters/ezoic/ezoic.go:82:	getMediaTypeForBid	100.0%
total:								(statements)		96.9%

przemkaczmarek · 2026-06-30T11:11:29Z

+endpoint: "https://g.ezoic.net/ezoic/prebid/adapter/ortb"
+maintainer:
+  email: prebid@ezoic.com
+gvlVendorID: 347


przemkaczmarek · 2026-06-30T11:15:55Z

+# Ezoic requires publisher domains to be registered and approved before
+# bidding; unapproved inventory receives no-bid responses. Contact
+# prebid@ezoic.com to get set up.
+endpoint: "https://g.ezoic.net/ezoic/prebid/adapter/ortb"


endpoint works:

przemkaczmarek · 2026-06-30T11:16:27Z

+# prebid@ezoic.com to get set up.
+endpoint: "https://g.ezoic.net/ezoic/prebid/adapter/ortb"
+maintainer:
+  email: prebid@ezoic.com


waiting for verification

verification email has been sent

przemkaczmarek · 2026-06-30T13:51:14Z

+func (a *adapter) MakeRequests(request *openrtb2.BidRequest, reqInfo *adapters.ExtraRequestInfo) ([]*adapters.RequestData, []error) {
+	body, err := jsonutil.Marshal(request)
+	if err != nil {
+		return nil, []error{fmt.Errorf("unable to marshal openrtb request: %v", err)}


Please use %w instead of %v here so the error is properly wrapped and can be inspected via errors.Is() / errors.As(). Other adapters in PBS consistently use %w for this pattern.

Done in 477ec0a — switched to %w so the marshal error wraps properly for errors.Is()/errors.As().

przemkaczmarek · 2026-06-30T13:52:15Z

+	if buildErr != nil {
+		t.Fatalf("Builder returned unexpected error %v", buildErr)
+	}


The server config fields ExternalUrl, GvlID, and DataCenter can be removed — the Builder function does not use the server parameter at all, so these values have no effect on the test.

Done in 477ec0a — the Builder ignores the server arg, so I replaced it with config.Server{}.

przemkaczmarek · 2026-06-30T13:53:28Z

@@ -0,0 +1,124 @@
+{


The adapter declares banner, video, and native support in the YAML, but the exemplary test directory only contains simple-banner.json. Please add simple-video.json and simple-native.json to ezoictest/exemplary/ to exercise the full mtype mapping end-to-end, not just in the unit test.

Done in 477ec0a — added simple-video.json (mtype 2 → video) and simple-native.json (mtype 4 → native) to ezoictest/exemplary/ so all three advertised media types now have end-to-end round-trip coverage.

- Wrap marshal error with %w instead of %v so it can be inspected via errors.Is()/errors.As() - Drop unused config.Server fields (ExternalUrl, GvlID, DataCenter) from the JSON-samples test; Builder does not read the server parameter - Add simple-video.json and simple-native.json exemplary tests to exercise the video and native mtype mapping end-to-end, matching the advertised capabilities

austinbyron · 2026-06-30T15:43:15Z

Thanks for the thorough review, @przemkaczmarek! Pushed 477ec0a addressing all three points:

Wrapped the marshal error with %w instead of %v so it's inspectable via errors.Is()/errors.As().
Removed the unused config.Server fields (ExternalUrl, GvlID, DataCenter) from the JSON-samples test — Builder doesn't read the server arg.
Added simple-video.json (mtype 2 → video) and simple-native.json (mtype 4 → native) to ezoictest/exemplary/, so all three advertised media types now have end-to-end round-trip coverage.

The maintainer-email verification has also been sent (replied on that thread). Re-requested review — thanks again!

austinbyron added 2 commits June 10, 2026 14:51

New Adapter: Ezoic

b1bf698

Advertise banner/video/native for app+site; note approval requirement

5127e7f

austinbyron mentioned this pull request Jun 11, 2026

New Bidder: Ezoic prebid/prebid.github.io#6614

Open

2 tasks

ChrisHuie requested a review from przemkaczmarek June 26, 2026 16:34

przemkaczmarek reviewed Jun 30, 2026

View reviewed changes

austinbyron requested a review from przemkaczmarek June 30, 2026 15:44

Uh oh!

Conversation

austinbyron commented Jun 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Overview

Design notes

Testing

Manual end-to-end test (per the new-adapter checklist)

Documentation

Uh oh!

austinbyron commented Jun 11, 2026

Uh oh!

github-actions Bot commented Jun 26, 2026

Code coverage summary

ezoic

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!

przemkaczmarek Jun 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

austinbyron commented Jun 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

austinbyron commented Jun 11, 2026 •

edited

Loading

przemkaczmarek Jun 30, 2026 •

edited

Loading