How to Integrate TargetVideo Instream with Prebid.js: A Practical Guide for Publishers

Instream video is a key revenue stream for publishers, but seamless integration with header bidding platforms like Prebid.js remains a common challenge. Many teams struggle to plug in specific video partners, leading to lost opportunities and cumbersome ad ops processes.

One such partner, TargetVideo, requires a precise setup in Prebid to enable streamlined bidding and maximize yield. This guide walks publishers through adding and configuring the TargetVideo module in Prebid.js, so your team can unlock new demand without the usual headaches.

Understanding the Role of TargetVideo in Prebid Instream

TargetVideo is a video ad server and demand partner that supports instream placements. In a header bidding setup, integrating TargetVideo helps publishers access additional video demand, often increasing competition and overall CPMs. However, unlike display modules, video requires careful integration to match the needs of both the player and the demand source.

Why Video Header Bidding Differs

Unlike display, video demand partners expect different ad requests, usually tied to the video player’s state and ad slot. This means the integration needs to work closely with your video player to fire bid requests at the right time and format.

Step-By-Step: Adding the TargetVideo Module to Prebid.js

Successfully bidding video inventory with TargetVideo means adding the right module during your Prebid.js build. Here’s how to get it done efficiently.

Preparing Your Custom Prebid.js Build

Start with your standard Prebid.js setup. You can either clone the repo and build locally (ideal for custom workflows) or download a pre-built package directly from the Prebid website. Always ensure you select the TargetVideo module as part of your custom build; forgetting this step is a common cause of failed bid requests.

Configuring the Video URL

After incorporating the module, your Prebid.js configuration will expose a method called pbjs.adServers.targetVideo.buildVideoUrl. This method generates the correct video ad request URL, which the video player uses to fetch and play demand-driven ads. Connect this method to your player’s ad call logic, making sure it triggers at appropriate ad breaks or cue points.

Integrating with Your Video Player and Ad Server

For a fully working solution, Prebid’s output needs to drive your video ad server or player (e.g., Video.js, JW Player, or a custom solution).

Real-World Example

Suppose your site uses JW Player. After the prebid auction, you take the video URL from pbjs.adServers.targetVideo.buildVideoUrl and provide it as the player’s ad tag. The player then requests the ad, filling the slot with the winning demand.

Common Publisher Mistakes

– Failing to trigger player ad calls at the right time (e.g., before the video plays vs. mid-roll)
– Serving cached or outdated ad URLs
– Forgetting to synchronize auction timing with the video player’s logic

Troubleshooting and Optimization Tips

Issues with video header bidding integrations often surface in revenue discrepancies or empty ad slots. Addressing these quickly ensures you maximize yield and user experience.

Key Areas to Monitor

– Are all relevant modules included in your Prebid.js build?
– Are video requests being triggered in sync with the player?
– Is the winning ad correctly passed to the video player and server?

Optimization Opportunities

– Use Prebid analytics modules to monitor fill rates and timeouts
– Periodically test across devices and browsers
– Adjust auction timeout settings based on player load times

What this means for publishers

Understanding and correctly implementing the TargetVideo module streamlines access to high-value video demand. Operationally, this reduces friction between development and revenue teams, cutting down on troubleshooting time while empowering ad ops to confidently roll out video header bidding at scale. Proper integration means less time spent firefighting broken integrations and more time optimizing yield.

Practical takeaway

Adding TargetVideo support to your Prebid.js stack is straightforward but requires attention to details: integrate the module during build, wire up the ‘buildVideoUrl’ to your video player, and keep auction logic tightly synchronized with ad slot timings. Always double-check your configuration after deployment—missed steps here can quietly drain revenue or disrupt the user experience.

For teams new to video header bidding, start with a controlled test on a subset of inventory. Monitor ad calls and yield, look for discrepancies between expected and actual fill, and use Prebid’s built-in analytics to spot issues early. With the right setup, you’ll unlock competitive video demand and give your ad ops team the transparency and control modern monetization demands.