Skip to main content

Banner oRTB

BANNER oRTB Integration

Our banner integration is based on the standard OpenRTB 2.5 protocol.

BANNER oRTB endpoint

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

Parameters
pid         Required Your feed ID
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": "4956896",
      "bidfloor": 0.002,
      "secure": 0
    }
  ],
 "site": {
  "id": "78506",
  "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 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
    "ip": "102.91.98.56",
    "devicetype": 1,
    "os": "Android",
    "osv": "13.0",
    "js": 1,
    "language": "EN",
    "carrier": "MTN"
  },
  "user": {
    "id": "e611ac60-5cd2-5985-92ec-5a77f62fdc1e",
    "geo": {
      "type": 2,
      "country": "NGA",
      "city": "Lagos"
    }
  }
}
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/63ebhcxmh3etfoyyy?token=hrebcz43m7nw1inumtcigzejbynrrukuer&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": "rj2b3ru6196biiavq908re0qd6",
          "crid": "rj2b3ru6196biiavq908re0qd6"
        }
      ]
    }
  ]
}

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/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