Wrapper Documentation
A high-performance, modular header-bidding wrapper powered by Prebid.js. This guide covers capabilities, setup, refresh controls, and dynamic-content handling. Your Customer Success Manager provides the codes tailored to your site.
What the wrapper doesBuilt for billions of pageviews, thousands of domains.
Modular architecture
Each domain loads a custom-built, optimized payload, with versioned CI/CD builds on every change.
AI-fueled optimization
Dynamic price flooring, intelligent price adjustments, and ad-delivery tuning.
Prebid.js, client + server
Client-side and hybrid bidding. Works with rich media, identity modules (ID5, UID2), and consent frameworks.
Full GAM automation
No on-page GAM tags required. Handles key-value targeting, creative decisioning, and analytics.
Fast CDN delivery
Ad-tech-optimized CDN: fast loads, adjustable timeouts, smart caching, adjustable lazy-load windows.
Privacy by design
TCF v2.2 and CCPA support, integrates with leading CMPs. Transparent, no black-box reporting.
Also included: bot-traffic filtering for clean auction signals, granular refresh rules, fallback renderers for no-fill, and custom JS hooks for auctions, ad rendering, and bid events. Fully JSON-configurable, with dynamic configs via the Publisher API.
Getting startedYour CSM provides a unique set of codes for your site and layout.
Header
Insert the header code between the <head> and </head> tags. It performs best placed as close to the top as possible.
Example in context:
Body
Place the body tag in the body of the page, where the ad should display.
SMART RefreshServe additional impressions while holding viewability and user experience.
Refresh all
Refreshes every ad unit on the page simultaneously.
Parameters: None
Refresh specific ad units
Specify which ad units to refresh.
Parameters: An array of strings, each the full GAM path to the ad unit. Syntax: /DFP Account ID/Adunit Code.
Refresh by DIV ID
Refresh based on DIV ID.
Parameters: An array of strings (DIV IDs).
Refresh elements
Refresh ad units defined by their HTML elements.
Parameters: An array of HTML Object Elements.
Dynamic contentFor ad slots added after load: infinite scroll, AJAX content.
By default the wrapper processes all ad DIVs present at page load. If DIVs are added later, notify the wrapper once the new content is ready. New DIVs can be added by any method as long as they include the required datasets: data-aaad and data-aa-adunit.
Calling a function
Firing a document event
Codes are provided per site by your Customer Success Manager. Questions: [email protected]