EXAMPLE - GAM Passback

Overview

This guide explains how to configure Mobkoi tags with a passback setup in Google Ad Manager (GAM). The passback mechanism ensures zero impression wastage by automatically calling your AdX demand when Mobkoi does not fill an impression.

1. Primary Creative (Mobkoi Tag)

• Create a Third-Party Custom Creative in GAM.

• Paste the provided Mobkoi tag code (which includes the passback logic).

• Traffic this creative through a line item targeting your desired inventory.

2. Passback Ad Unit

• Create a dedicated passback ad unit in GAM. Example:

  /[YourNetworkID]/[Publisher]/passback/mobkoi

• Target your AdX demand (or other fallback) to this ad unit.

• Provide the full ad unit path to Mobkoi so it can be included in the tag.

How It Works

1. Your GAM serves the Mobkoi tag.

2. If Mobkoi fills, the ad displays.

3. If Mobkoi doesn’t fill, the tag triggers the onNoAdCallback function.

4. The callback:

   • Dynamically injects a GPT container (div).

   • Calls your dedicated passback ad unit via GPT.

5. Your AdX demand fills through the passback ad unit.

Important Notes

• The passback configuration must be set up in GAM (not on Mobkoi’s side). The callback runs within your ad environment to call your AdX demand.

• No developer changes are required beyond the initial GAM setup.

• Ensure the passback ad unit is trafficked and active with AdX demand.

Example Mobkoi Passback Tag

<script>
(function (cs) {
  // Keep a global reference to the script so the callback can find it
  window.__mobkoiTestScript = cs;

  window.onNoAdCallback = function () {
    
    var csRef = window.__mobkoiTestScript;
    if (!csRef) {
      console.error("❌ Mobkoi test script reference not found");
      return;
    }

    var uniqueId = "gpt-passback-" + Math.random().toString(36).slice(2, 9);
    var adDiv = document.createElement("div");
    adDiv.id = uniqueId;

    csRef.parentNode.insertBefore(adDiv, csRef.nextSibling);
    console.log("✅ Inserted #" + uniqueId);

    if (!window.__gptLoaded) {
      var gptScript = document.createElement("script");
      gptScript.src = "https://securepubads.g.doubleclick.net/tag/js/gpt.js";
      gptScript.async = true;
      gptScript.onload = function () {
        window.__gptLoaded = true;
        console.log("✅ GPT loaded");
      };
      document.head.appendChild(gptScript);
    }

    window.googletag = window.googletag || { cmd: [] };
    googletag.cmd.push(function () {
      console.log("🎯 Defining GPT slot");
      var slot = googletag
        .defineSlot(
          "/[YourNetworkID]/[Publisher]/passback/mobkoi",
          [300, 250],
          uniqueId,
        )
        .addService(googletag.pubads());

      googletag.pubads().addEventListener("slotRenderEnded", function (event) {
        if (event.slot === slot) {
          console.log("📊 Passback rendered:", event);

          if (!event.isEmpty) {
            console.log("✅ Passback has ad, reporting size to parent");

            // Make our iframe visible
            if (window.frameElement) {
              window.frameElement.style.display = "block";
              console.log("✅ Made our iframe visible");
            }
          } else {
            console.warn("⚠️ Passback is empty, no ad to show");
          }
        }
      });

      googletag.enableServices();
      googletag.display(uniqueId);
      googletag.pubads().refresh([slot]);
    });
  };

  var options = { passbackFunc: "onNoAdCallback" };

  cs.parentNode.insertBefore(
    Object.assign(document.createElement("script"), {
      type: "application/javascript",
      async: 1,
      src:
        "https://tag.mobkoi.com/tag/boot/PLACEMENT_ID?po=" +
        encodeURIComponent(JSON.stringify(options)) +
        "&cb=" +
        Math.random() +
        "&st=" +
        Date.now(),
    }),
    cs,
  );
})(document.currentScript);
</script>

Example Flow Diagram

GAM (Mobkoi Creative)
   │
   ▼
Mobkoi Tag
   ├──> Mobkoi fills → Ad served ✅
   └──> Mobkoi no-fill → onNoAdCallback()
              │
              ▼
        GPT Passback Ad Unit
              │
              ▼
        AdX Demand fills ✅