Programmatic Testbed

Single Tag - Passback

A passback tag is a fallback mechanism to handle unfilled ad requests. If an ad server or SSP cannot fill an ad request, the passback tag allows the unsold inventory to be redirected to another ad source or ad server.

The tag supports configuration in two ways: either as a link to a JavaScript file hosted on the publisher's page, which is then loaded and executed, or as an inline function defined directly within the tag.

Integration One: Pass a reference to a hosted script which contains the logic to execute the passback routine


<div class="pagewrapper">
  <!-- START TAG -->
  <script>
    (function (cs) {
      /* Publisher options */
      var options = {
        test: 1,
        passback: '/passback.js',
        passbackTest: 1,
      };

      /* DO NOT TOUCH ANYTHING BELOW */
      cs.parentNode.insertBefore(
        Object.assign(document.createElement('script'), {
          type: 'application/javascript',
          async: 1,
          src:
            `https://adserver.dev.mobkoi.com/boot/MOBKOI_PUBLISHER_ID?po=` +
            encodeURIComponent(JSON.stringify(options)) +
            '&cb=' +
            Math.random() +
            '&st=' +
            Date.now(),
        }),
        cs,
      );
    })(document.currentScript);
  </script>
  <!-- END TAG -->
</div>

The passback script is called with a query parameter containing the ID of the element on the page where the ad should render.

The reference can be found in the following way

                
const script = document.currentScript;
const url = new URL(script.src);
const targetId = url.searchParams.get('targetId');

if (targetId) {
  const targetElement = document.getElementById(targetId);
  var banner = document.createElement('div');

  // Set the inline CSS for the banner
  banner.style.width = '100%';
  banner.style.height = '250px';
  banner.style.backgroundColor = '#f4f4f4';
  banner.style.border = '2px solid #ccc';
  banner.style.textAlign = 'center';
  banner.style.display = 'flex';
  banner.style.justifyContent = 'center';
  banner.style.alignItems = 'center';
  banner.style.fontFamily = 'Arial, sans-serif';
  banner.style.color = '#333';
  banner.style.fontSize = '18px';
  banner.style.fontWeight = 'bold';

  // Set the text content of the banner
  banner.innerText = 'Passback House Banner';
  targetElement.innerHTML = banner.outerHTML;
}

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec interdum ante ut felis hendrerit, nec consectetur augue fringilla. Mauris maximus, nisl quis aliquet porta, arcu tortor commodo mi, sit amet mollis libero justo ut metus. Interdum et malesuada fames ac ante ipsum primis in faucibus. Nam elit risus, aliquet eget sodales quis, commodo eu justo. Etiam vestibulum eu turpis iaculis vehicula. Maecenas bibendum, sem vel pretium molestie, ligula mauris interdum lacus, a varius nulla felis eu orci. Proin nec neque ipsum. Suspendisse eget velit in nulla laoreet malesuada. Phasellus sit amet euismod orci. Morbi egestas mauris ante, ac tristique metus pretium sit amet.

Fusce vel faucibus quam. Curabitur viverra quam vitae velit ornare sodales. Proin luctus sed dui at fermentum. Mauris sed diam ex. Donec finibus diam eu orci efficitur placerat. Vivamus vitae tortor auctor, tempor lacus vel, vulputate nibh. Nulla vulputate scelerisque auctor. Duis dapibus tellus lectus, eget hendrerit ante venenatis in. Nulla vehicula tellus ac porta sagittis. Nam condimentum orci et ipsum convallis volutpat. Morbi eu volutpat leo. Nam sit amet sapien tellus. Suspendisse egestas dolor vel risus posuere sollicitudin.

Fusce pharetra, neque vel placerat eleifend, ex justo condimentum turpis, id hendrerit magna mauris ullamcorper purus. Nullam vel nisi varius, auctor nunc in, dignissim lectus. Aliquam justo urna, porttitor non ipsum nec, mollis mattis lacus. Nunc facilisis lorem sed elit ornare tempus. Suspendisse tincidunt suscipit erat, eget malesuada risus pulvinar ut. Nunc ut quam sit amet lacus vulputate dapibus nec id ex. In hac habitasse platea dictumst. Sed cursus dui erat, id ultricies odio imperdiet quis. Nam rutrum quam id ultrices accumsan. Vivamus nunc metus, porta eu felis at, gravida facilisis sem. Duis sodales gravida blandit. Quisque lobortis turpis velit, quis sagittis sem interdum ac. Mauris lobortis, lacus nec malesuada mollis, lacus justo ullamcorper nisi, non fringilla quam neque in nisi.

You should be able to see this and similar paragraph before the advert