Integration Specifications

1. Integration Mode

Bitadx integrates as a Publisher (Supply Side) using the OpenRTB 2.5 protocol via Server-to-Server (S2S) connection.

2. Traffic Details

Traffic Type: Banner traffic from verified publishers.
Geo: Global (All Geos).
User Agent & IP: Passed directly from the end-user (Client) in the bid request.

3. Request Specifications (Bid Request)

We send a POST request with header Content-Type: application/json and x-openrtb-version: 2.5.

Sample Payload

{
  "id": "e4d909c290d0fb1ca068ffaddf22cbd0",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 728,
        "h": 90
      },
      "bidfloor": 0.0001
    }
  ],
  "site": {
    "id": "YOUR_PROVIDED_SITE_ID",
    "publisher": {
      "id": "YOUR_PROVIDED_PUB_ID"
    },
    "page": "https://publisher-website.com/article-page",
    "domain": "publisher-website.com"
  },
  "device": {
    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36...",
    "ip": "203.0.113.195",
    "js": 1,
    "dnt": 0
  },
  "user": {
    "id": "5d41402abc4b2a76b9719d911017c592"
  },
  "at": 1,
  "tmax": 1000
}

Parameters Description

Parameter	Description
`imp.banner.w` / `h`	Dimensions of the ad unit requested (e.g., 728x90, 300x250).
`site.id`	The Zone/Site ID provided by Cointraffic.
`site.publisher.id`	The Publisher ID provided by Cointraffic.
`site.page`	The actual URL where the ad will be displayed.
`device.ip`	The real IP address of the user.
`device.ua`	The real User-Agent of the user.

4. Response Specifications (Bid Response)

We expect a standard OpenRTB bid response.

Success (200 OK): JSON containing seatbid -> bid -> adm (Ad Markup).
No Bid (204 No Content): If no ad is available, please return HTTP 204 or an empty JSON response.

Sample Expected Response

{
  "id": "e4d909c290d0fb1ca068ffaddf22cbd0",
  "seatbid": [
    {
      "bid": [
        {
          "id": "bid_123",
          "impid": "1",
          "price": 0.50,
          "adm": "<iframe src='...'></iframe>",
          "crid": "creative_001"
        }
      ]
    }
  ]
}