Adverteks OpenRTB Integration Guide

const { randomUUID } = require('crypto');

async function sendBidRequest(zoneKey, geo = {}) {
  const bidRequest = {
    id: randomUUID(),
    at: 2,
    tmax: 150,
    imp: [{ id: '1', banner: { w: 300, h: 250 }, bidfloor: 0.50, secure: 1 }],
    site: { id: zoneKey, page: 'https://example.com/article' },
    device: {
      ip: geo.ip || '0.0.0.0',
      geo: geo.lat ? { lat: geo.lat, lon: geo.lon, country: 'USA' } : undefined
    }
  };

  const resp = await fetch('https://adverteks.com/api/rtb/bid', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(bidRequest),
    signal: AbortSignal.timeout(200)
  });

  if (resp.status === 204) { console.log('No fill'); return null; }

  const data = await resp.json();
  const bid = data.seatbid?.[0]?.bid?.[0];

  if (bid) {
    console.log(`Won at $${bid.price} CPM`);
    // Substitute macros and fire win notice
    const winUrl = bid.nurl
      .replace('${AUCTION_PRICE}', bid.price)
      .replace('${AUCTION_ID}', bidRequest.id)
      .replace('${AUCTION_BID_ID}', bid.id);
    await fetch(winUrl, { method: 'POST' });
  }

  return data;
}

sendBidRequest('zone_abc123', { ip: '203.0.113.42', lat: 40.7128, lon: -74.0060 });

import uuid
import httpx  # pip install httpx

BASE = "https://adverteks.com"

def send_bid_request(zone_key: str, geo: dict = None) -> dict | None:
    payload = {
        "id": str(uuid.uuid4()),
        "at": 2, "tmax": 150,
        "imp": [{"id": "1", "banner": {"w": 300, "h": 250}, "bidfloor": 0.50}],
        "site": {"id": zone_key, "page": "https://example.com"},
    }
    if geo:
        payload["device"] = {
            "ip": geo.get("ip", "0.0.0.0"),
            "geo": {"lat": geo["lat"], "lon": geo["lon"], "country": "USA"},
        }

    with httpx.Client(timeout=0.2) as c:
        r = c.post(f"{BASE}/api/rtb/bid", json=payload)

    if r.status_code == 204:
        print("No fill")
        return None

    r.raise_for_status()
    data = r.json()
    bid = data.get("seatbid", [{}])[0].get("bid", [None])[0]

    if bid:
        price = bid["price"]
        print(f"Won at ${price:.4f} CPM")
        win_url = (bid["nurl"]
            .replace("${AUCTION_PRICE}", str(price))
            .replace("${AUCTION_ID}", payload["id"])
            .replace("${AUCTION_BID_ID}", bid["id"]))
        httpx.post(win_url)

    return data

send_bid_request("zone_abc123", geo={"ip": "203.0.113.42", "lat": 40.7128, "lon": -74.0060})

async function fireWinNotice({ auctionId, price, bidId, seatId }) {
  const resp = await fetch('https://adverteks.com/api/rtb/win', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ auction_id: auctionId, price, bid_id: bidId, seat_id: seatId })
  });
  return resp.ok;
}

// Or substitute macros in the nURL from bid response:
async function fireNurl(nurlTemplate, { price, auctionId, bidId }) {
  const url = nurlTemplate
    .replace('${AUCTION_PRICE}', price)
    .replace('${AUCTION_ID}', auctionId)
    .replace('${AUCTION_BID_ID}', bidId);
  await fetch(url); // GET or POST both work
}

import httpx

def fire_win_notice(auction_id: str, price: float, bid_id: str):
    resp = httpx.post(
        "https://adverteks.com/api/rtb/win",
        json={"auction_id": auction_id, "price": price, "bid_id": bid_id},
    )
    if resp.status_code == 200:
        print(f"Win recorded — auction {auction_id} at ${price:.4f}")
    else:
        print(f"Win notice failed: {resp.status_code}")

async function loadAd(zoneKey, container, geo = {}) {
  const params = new URLSearchParams(
    Object.fromEntries(Object.entries(geo).filter(([,v]) => v != null))
  );
  const resp = await fetch(`https://adverteks.com/api/ad/serve/${zoneKey}?${params}`);

  if (resp.status === 204) {
    container.innerHTML = ''; // no fill — serve passback
    return;
  }

  const { ad } = await resp.json();
  container.innerHTML = ad.html;

  // Fire impression pixel
  new Image().src = ad.impression_url;

  // Wrap clicks through Adverteks tracker
  container.querySelectorAll('a').forEach(a => { a.href = ad.click_url; });
}

loadAd('zone_abc123', document.getElementById('ad-slot'), { lat: 40.7128, lon: -74.0060 });

import httpx

def fetch_ad(zone_key: str, lat: float = None, lon: float = None) -> dict | None:
    params = {}
    if lat is not None:
        params.update({"lat": lat, "lon": lon})

    r = httpx.get(f"https://adverteks.com/api/ad/serve/{zone_key}", params=params)

    if r.status_code == 204:
        print("No fill — serving passback")
        return None

    r.raise_for_status()
    ad = r.json()["ad"]
    print(f"Served {ad['width']}x{ad['height']} at ${ad['cpm']:.4f} CPM")
    return ad

ad = fetch_ad("zone_abc123", lat=40.7128, lon=-74.0060)