▶
Bidding Player
AD OPS · v2.5.0
Onboarding Prerequisites
What we need from the demand partner, the publisher, and the GAM tag before a placement can serve.
1 · Demand partner (SSP)
- Prebid bidder code + required params (e.g.
placementId).
- Placement ID for the right video format — instream ID for instream, outstream ID for outstream. critical
- Publisher domain allowlisted at the SSP. critical
2 · Publisher
- HTTPS site + the domain(s) for allowlisting.
- Where the player goes (default auto-creates a mount; or an existing
div id).
- Consent/CMP if EU (GDPR) or US-state privacy applies.
- Content video URL (.mp4/.m3u8) — instream only.
3 · GAM tag
- Master video tag ending in
correlator=, with output=vast and video sz= (e.g. 640x480).
- Key-values:
hb_pb, hb_bidder, hb_uuid, hb_size, hb_format, hb_adid.
- VAST creative using
%%PATTERN:hb_uuid%% + price-bucket line items ($0.10 steps) + a house fallback (hb_pb=0.00).
Instream vs outstream
| | Instream | Outstream |
| Content video | Required | None |
| SSP placement ID | instream | outstream |
| Starts | on load (muted) | on scroll into view (muted) |
| When no fill | shows content | collapses (nothing shown) |
~90% of "no ads" cases: domain not allowlisted, or the SSP placement ID is the wrong format (instream vs outstream). Check both first.
No ads showing? Check in order
- Domain allowlisted at the SSP?
- Placement ID matches the format (instream/outstream)?
- GAM has line items/creatives that fill (+ house fallback)?
- Load with
?debug=true: reaching STEP 7 = player works, it's a fill issue; stopping before = chase demand/GAM.