Skip to content

Timeout reporting disclosures for popular bidders - #6862

Open
patmmccann wants to merge 2 commits into
prebid:masterfrom
patmmccann:agent-timeout-disclosures
Open

patmmccann wants to merge 2 commits into
prebid:masterfrom
patmmccann:agent-timeout-disclosures

Conversation

@patmmccann

@patmmccann patmmccann commented Oct 24, 2026 •

Copy link
Copy Markdown
Collaborator

Closes #3029.

Module rules list "this bidder reports timeout events" as a required disclosure, but almost no bidder page carried one. This adds a reusable disclosure and applies it to the most popular bidders (top 30 by sites on the Prebid insights dashboard) whose adapters report timeouts. It's meant as an example for other adapters, not an exhaustive pass.

  • New include _includes/dev-docs/reports-timeout-events.md: a warning alert like loads-external-javascript.md, with endpoint and data parameters: "Disclosure: This bidder reports timeout events. When it times out in an auction, the adapter sends {data} to https://{endpoint}."

  • Bidder pages: added at the top of the seven whose onTimeout sends a request (checked against Prebid.js master):

    Bidder Endpoint Sends
    seedtag s.seedtag.com/se/hb/timeout (pixel) publisher ID, ad unit ID, timeout
    amx 1x1.a-mo.net/e (POST, with credentials) page domain/URL/referrer, a user ID, Prebid version, per-request tag/ad unit/bid and transaction IDs, size, timeout
    onetag onetag-sys.com/ptimeout (POST) Prebid's timeout data for its bid requests
    kargo krk2.kargo.com/api/v1/event/timeout auction ID and timeout, per timed-out request
    medianet navvy.media.net/log customer ID, count of timed-out requests, timeout, request details
    trustedstack (Media.net alias) navvy.media.net/log same as medianet
    richaudience s.richaudience.com/err/ (pixel) timeout, placement ID, domain
    ogury ms-ads-monitoring-events.presage.io/bid_timeout (POST) first timed-out request's data and the page URL
  • Checked, no disclosure needed: rubicon, pubmatic, appnexus, ix, triplelift, openx, criteo, teads, gumgum, ttd, adagio, sovrn, smilewanted, smartadserver, rtbhouse, unruly, ozone, 33across, kueez_rtb, adf and undertone have no onTimeout. sharethrough's is an empty stub. prebid_server isn't a bidder adapter.

  • module-rules.md: the Disclosure section now says when the timeout disclosure applies (an onTimeout that sends a network request, not an empty one) and how to add it.

  • Lint: CI's markdownlint checks whole files, so the existing tables in the touched files were rewritten to the compact table style (MD060), and the headings on amx, kargo, medianet and onetag were promoted one level so the first is h2 (MD001). No content changes.

  • bidder-adaptor.md: "Registering on Timeout" now says adapters that report timeouts must disclose it, linking to the module rules.

Other event hooks (onBidWon, onSetTargeting, onBidderError) can phone home too; they're out of scope here but could follow the same pattern.

🤖 Generated with Claude Code

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

netlify Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for prebid-docs-preview ready!

Name Link
🔨 Latest commit 6d0ac4e
🔍 Latest deploy log https://app.netlify.com/projects/prebid-docs-preview/deploys/6add1aaadd0906e29819e9c0
😎 Deploy Preview https://deploy-preview-6862--prebid-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-24T20:45:08.550550Z f5c1c91 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f5c1c91b8d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread dev-docs/bidders/medianet.md
- Add the disclosure to trustedstack, which is a Media.net alias.
- Rewrite tables in the changed files to MD060 compact style.
- Promote headings on amx, kargo, medianet and onetag so the first is h2 (MD001).

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

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

prebid.js /pbjs Ontimeout disclosures

1 participant