Configure Timeouts

The Wrapper includes a timeout value, which tells the Wrapper how long to wait for all Bidding Adapters to respond before either (for the Auto Wrapper) setting the key-value targeting and making the ad call to Google Ad Manager (GAM) or (for the Universal Library) passing the bid responses to the callback function provided by the Publisher. To be eligible to bid on an impression, bidders must conduct their exchange side auctions and produce a winning bid within this window.

Publishers have two options for configuring the timeout:

  • A fixed timeout, where the same timeout value is used across all page types, geographical locations, device types, and user network conditions; and
  • Adaptive timeout, where an adaptive machine-learning algorithm adjusts the timeout value in real time using factors such as the device type, the user’s geographical location, and network conditions

Configure a Fixed Timeout

When you configure a fixed timeout, this same timeout value is used across all pages. If you need different timeouts for different page and network conditions, you either need to configure adaptive timeout (described below) or create separate Wrapper configurations.

To configure your Wrapper to use a fixed timeout, complete the following steps:

  1. Log in to the IX app.
  2. Click Controls > Inventory > Header Tag Wrapper.
  3. In the Global Timeout field, enter the timeout (in ms) you want to use.
  4. Switch the Adaptive Timeout toggle to OFF.

Configure Adaptive Timeout

Unlike a fixed timeout, adaptive timeout does not require separate Wrapper configurations. Instead, the algorithm automatically calculates the appropriate timeout for each call.

To determine the timeout for the current call, the machine-learning algorithm that powers adaptive timeout first collects network latency data from past sessions. It then calculates the average timeout for these sessions, as well as their variance and standard deviation. Using this information, the algorithm calculates the timeout by plotting it against a normal distribution curve to identify a timeout that allows all bidders to successfully submit their bids 97% of the time. In the event that data from past sessions is not available, the Wrapper uses the fixed timeout set in the IX app.

To configure your Wrapper to use adaptive timeout, complete the following steps:

  1. Log in to the IX app.
  2. Click Controls > Inventory > Header Tag Wrapper.
  3. Switch the Adaptive Timeout toggle to ON.
  4. In the Global Timeout field, enter the timeout (in ms) you want to use in cases where data from past sessions is not available.