Skip to main content

BANNER oRTB

BANNER oRTB Integration

Our banner integration is using standard oRTB 2.6 protocol.

BANNER oRTB endpoint

http://feed.inhousead.net/ortb?pid=REPLACE

Parameters
pid         Required Your feed ID
Banner Web Request example 
{
  "id": "653e14cd-f2c0-4e5e-880b-ec8b7353e5de",
  "at": 1,
  "tmax": 250,
  "cur": ["USD"],
  "imp": [
    {
      "id": "68bc5bbc-c6c4-407d-aff2-81971d5dd577",
      "banner": {
        "w": 300,
        "h": 250
      },
      "tagid": "6956892",
      "bidfloor": 0.002,
      "secure": 0
    }
  ],
  "site": {
    "id": "68506",
    "domain": "examplemanga.com",
    "page": "https://examplemanga.com/read/stranger-in-my-book/chapter-260",
    "keywords": "Stranger in my Book, Chapter 260, manga, read online",
    "cat": ["IAB9-30", "IAB1"]
  },
  "device": {
    "geo": {
      "type": 2,
      "country": "NGA",
      "city": "Lagos"
    },
    "ua": "Mozilla/5.0 (Linux; Android 13; ExampleDevice) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
    "ip": "198.51.100.10",
    "devicetype": 1,
    "os": "Android",
    "osv": "13.0",
    "js": 1,
    "language": "EN",
    "carrier": "CarrierName"
  },
  "user": {
    "id": "6711ac60-5cd2-5985-92ec-5a77f62fdc1e",
    "geo": {
      "type": 2,
      "country": "NGA",
      "city": "Lagos"
    }
  },
  "source": {
    "schain": {
      "ver": "1.0",
      "complete": 1,
      "nodes": [
        {
          "asi": "exampleadseller.com",
          "sid": "1234",
          "hp": 1
        },
        {
          "asi": "intermediaryssp.com",
          "sid": "abcd",
          "hp": 1
        }
      ]
    }
  }
}
Banner Web Response example
{
  "id": "653e14cd-f2c0-4e5e-880b-ec8b7353e5de",
  "seatbid": [
    {
      "bid": [
        {
          "id": "rj6b3ru6196biiavq908re0qd8",
          "impid": "88bc6bbc-c6c4-407d-aff2-81971d5dd577",
          "price": 0.051,
          "burl": "https://click.inhousead.net/ortbburl/vidtoken123?token=securetoken123&id=${AUCTION_ID}&price=${AUCTION_PRICE}&bidId=${AUCTION_BID_ID}&impId=${AUCTION_IMP_ID}&currency=${AUCTION_CURRENCY}",
          "adm": "<iframe width=\"300\" height=\"250\" src=\"https://ib.eu.ggmnd.com/v2/1713/330eba7a-f5ef-11f0-8c44-ce3d2cd6f8de/1/ib\" style=\"width:300px;height:250px;padding:0;margin:0;border:0;\" hspace=\"0\" vspace=\"0\" allowtransparency=\"true\" frameborder=\"no\" scrolling=\"no\" marginheight=\"0\" marginwidth=\"0\" sandbox=\"allow-popups allow-scripts allow-forms allow-pointer-lock allow-same-origin allow-popups-to-escape-sandbox\"></iframe><img src=\"https://click.inhousead.net/ortbimp/63ebhcxmh3etfoyyy?token=hrebcz43m7nw1inumtcigzejbynrrukuer&type=1\" width=\"1\" height=\"1\"/>",
          "adid": "rj3k1mu3296xyiavr209gf8pt7",
          "crid": "rj9d7pv5596lbiavh708re5yb1"
        }
      ]
    }
  ]
}
Banner In-App Request example 
{
  "id": "bb3e5c47-b8e5-4e9f-9e9b-59c1d401b8df",
  "at": 1,
  "tmax": 250,
  "cur": ["USD"],
  "imp": [
    {
      "id": "imp-inapp-001",
      "banner": {
        "w": 320,
        "h": 50,
        "format": [
          { "w": 320, "h": 50 },
          { "w": 300, "h": 50 }
        ]
      },
      "tagid": "app-banner-slot-001",
      "bidfloor": 0.005,
      "bidfloorcur": "USD",
      "secure": 1
    }
  ],
  "app": {
    "id": "com.example.mangaapp",
    "name": "Example Manga App",
    "bundle": "com.example.mangaapp",
    "storeurl": "https://play.google.com/store/apps/details?id=com.example.mangaapp",
    "ver": "2.3.1",
    "cat": ["IAB9-30", "IAB1"],
    "keywords": "manga, manga reader, stranger in my book"
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 13; ExampleDevice) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
    "ip": "198.51.100.10",
    "geo": {
      "type": 2,
      "country": "NGA",
      "city": "Lagos"
    },
    "devicetype": 1,
    "make": "ExampleBrand",
    "model": "ExampleModel",
    "os": "Android",
    "osv": "13.0",
    "language": "EN",
    "carrier": "CarrierName",
    "connectiontype": 2,
    "ifa": "AEBE52E7-03EE-455A-B3C4-E57283966239",
    "lmt": 0
  },
  "user": {
    "id": "user-12938abc-456d-89f0-a1b2-c3d4e5f67890",
    "geo": {
      "type": 2,
      "country": "NGA",
      "city": "Lagos"
    }
  },
  "source": {
    "schain": {
      "ver": "1.0",
      "complete": 1,
      "nodes": [
        {
          "asi": "exampleadseller.com",
          "sid": "1234",
          "hp": 1
        },
        {
          "asi": "intermediaryssp.com",
          "sid": "abcd",
          "hp": 1
        }
      ]
    }
  }
}
Banner In-App Response example
{
  "id": "653e14cd-f2c0-4e5e-880b-ec8b7353e5de",
  "seatbid": [
    {
      "bid": [
        {
          "id": "rj2n6rw4396abiavq504rw3kd6",
          "impid": "88bc6bbc-c6c4-407d-aff2-81971d5dd577",
          "price": 0.051,
          "burl": "https://click.inhousead.net/ortbburl/vidtoken123?token=securetoken123&id=${AUCTION_ID}&price=${AUCTION_PRICE}&bidId=${AUCTION_BID_ID}&impId=${AUCTION_IMP_ID}&currency=${AUCTION_CURRENCY}",
          "adm": "<html><body style='margin:0;padding:0;'><a href='https://click.inhousead.net/redirect/63ebhcxmh3etfoyyy?token=hrebcz43m7nw1inumtcigzejbynrrukuer' target='_blank'><img src='https://ib.eu.ggmnd.com/v2/1713/330eba7a-f5ef-11f0-8c44-ce3d2cd6f8de/1/banner.jpg' width='300' height='250' style='border:0;'/></a><img src='https://click.inhousead.net/ortbimp/63ebhcxmh3etfoyyy?token=hrebcz43m7nw1inumtcigzejbynrrukuer&type=1' width='1' height='1' style='display:none;'/></body></html>",
          "adid": "rj7f3xy6196mjiavq908tx4qe9",
          "crid": "rj4c9kl8496xkiavp603qe1uz3"
        }
      ]
    }
  ]
}

BANNER oRTB Statistic API

You can retrieve statistics using two available methods:

Method 1: Using API Endpoint and API Token

You can access stats programmatically using a dedicated API URL and a personal API token.

Requirements:
API Link (provided by your account manager)
API Token (also issued by your manager)

Authentication:
You must include the API token in the Authorization header using the Bearer scheme.

Example Header:
Authorization: Bearer YOUR_API_TOKEN

pubfeed_id Required Your feed ID
API Link By Date

https://platform.inhousead.net/ortb/api/statistics/pubfeed/?pubfeed_id=REPLACE&start_date=2025.09.25&end_date=2025.09.25&groupby=date

Method 2: Using Swagger Interface

You can also access statistics via the Swagger UI, which provides an interactive interface to query stats.

Swagger URL:

https://platform.inhousead.net/ortb/api/statistics/schema/swagger-ui/

Steps to Use:

1. Authorise using your API token;
2. Specify the date;
3. Select your preferred grouping (by date, country, subid, hour or pubfeed_id);
4. Execute the query and review the results directly in the Swagger UI.

If you require any help, please contact your account manager.

Back to top