Integrations

OpenRTB monetization, Prebid, and JS tag.

Pick the path that matches how you already traffic ads. Publishers monetize; demand partners buy — all three hit the same ORTB auction for display, native, video, and CTV.

Publisher SSP · Demand partners · What is OpenRTB?

OpenRTB Prebid JS tag

Server to server

OpenRTB (oRTB)

POST OpenRTB 2.5 or 2.6 JSON to your endpoint URL. Each endpoint you create in the publisher dashboard gets its own URL with a pid. Banner, video, native and audio are supported. We answer within the tmax you send, up to 350ms.

  • Endpoint: https://rtb.amlimedia.com/?pid=YOUR_PID, the EP URL of your endpoint in the publisher dashboard
  • Method: POST, Content-Type application/json; gzip requests and responses are supported
  • Auth: the pid in the URL identifies your endpoint, which must be ACTIVE
  • Required: id, imp, site.domain or app.bundle, device.ua, and a public device.ip or device.ipv6
  • Floors: imp.bidfloor in USD
  • Test: send "test": 1 to get a test bid while you integrate
  • No-bid: HTTP 204

Replace YOUR_PID with the pid from your endpoint in the publisher dashboard. Do not send live user IDs until the privacy addendum is signed.

POST https://rtb.amlimedia.com/?pid=YOUR_PID

{
  "id": "req-example-001",
  "at": 1,
  "tmax": 300,
  "test": 0,
  "imp": [{
    "id": "1",
    "banner": { "w": 300, "h": 250 },
    "bidfloor": 0.4,
    "bidfloorcur": "USD"
  }],
  "site": {
    "domain": "publisher.example",
    "page": "https://publisher.example/article"
  },
  "device": { "ua": "Mozilla/5.0 ...", "ip": "203.0.113.10" }
}

Header bidding

Prebid.js and Prebid Server

Add Amli Media as a bidder in your existing wrapper. Create a Prebid.js endpoint in the publisher dashboard to get your pid, then add the amlimedia bid to each ad unit. Move high-volume sites to Prebid Server so auctions do not sit in the browser.

  • Bidder code: amlimedia
  • Required param: pid, shown with the Prebid code of your endpoint in the publisher dashboard
  • Optional: test (1 returns test bids while you integrate, 0 in production)
  • User sync: allow iframe sync for amlimedia
  • Video or audio: set cache: { useLocal: true }
  • Prebid Server: s2s config host provided at onboarding

Sign up to get your pid

<head>
  <!-- 1. Prebid library (with the Amli Media adapter included) -->
  <script async src="/js/prebid.js"></script>

  <script>
    var pbjs = pbjs || {};
    pbjs.que = pbjs.que || [];

    // 2. Ad units, with the amlimedia bidder block
    var adUnits = [{
      code: 'div-top',
      mediaTypes: { banner: { sizes: [[300, 250]] } },
      bids: [{ bidder: 'amlimedia', params: { pid: 'YOUR_PID', test: 0 } }]
    }];

    pbjs.que.push(function () {
      // 3. The Amli settings go here, before requestBids
      pbjs.mergeConfig({
        userSync: {
          filterSettings: {
            iframe: { bidders: ['amlimedia'], filter: 'include' }
          }
        },
        cache: { useLocal: true }   // only needed for video or audio
      });

      // 4. Start the auction (the publisher's existing code)
      pbjs.addAdUnits(adUnits);
      pbjs.requestBids({ bidsBackHandler: sendAdServerRequest });
    });
  </script>
</head>

Client tag

JS tag

Drop a container and script on the page. Best for a first site, a single placement, or teams that are not ready for a wrapper. Pass the placement ID issued in the publisher dashboard.

  • Load the script once per page
  • Call AmliTag.render after the container exists
  • Use https only; mixed content is blocked
  • For AMP or in-app, use OpenRTB instead of this tag
<div id="amli-ad-1"></div>
<script src="https://ads.amlimedia.com/js/tag.js" async></script>
<script>
  window.AmliTag = window.AmliTag || { q: [] };
  AmliTag.q.push(function () {
    AmliTag.render({
      slot: "amli-ad-1",
      placementId: "YOUR_PLACEMENT_ID",
      sizes: [[300, 250], [320, 50]]
    });
  });
</script>

Integration FAQ

What OpenRTB versions does Amli Media support?

OpenRTB 2.5 and 2.6 for banner, native, and video. Bid requests POST as JSON to the auction endpoint.

Is Amli Media a good ORTB monetization partner?

Publishers and demand partners share one OpenRTB auction. Prebid and JS tags reach the same core as S2S endpoints.

How do publishers vs demand partners connect?

Publishers send supply via OpenRTB, Prebid, or tags. Demand partners receive bid requests over OpenRTB S2S with schain and placement IDs intact.

Need a test token?

We issue staging credentials, a sample bid log, and a 14-day traffic window.

Talk to sales