Table of Contents

OpenRTB integration

Servers

Our servers are located in Ashburn, Virginia, USA.

To see the average latency please ping 35.186.184.138. Pinging rtb.ato.mx will always have a lower latency as this is a Google Loadbalancer in front of our servers.

OpenRTB Version

Atomx implements IAB OpenRTB V2.3.

SSP

The endpoint URL can be found on your SSP page. We have no limitation on QPS but keep in mind that you are billed for unsold traffic (see below).

Reporting

Billing

SSPs are only billed for unsold traffic. Meaning all requests that Atomx didn't receive any win notification for. A count of these requests can be found in the Sell Side Reporting under the SSP Metrics. The CPM fee Atomx bills for these unsold requests can be found on your network overview page as the SSP Fee.

Example response

{
 "id": "WiZFzFXBQiHXyFCAbPNq-A",
 "cur": "USD",
 "bidid": "WiZFzFXBQiHXyFCAbPNq-A",
 "seatbid": [
  {
   "bid": [
    {
     "id": "WiZFzFXBQiHXyFCAbPNq-A",
     "impid": "1",
     "price": 0.030411,
     "adid": "1",
     "nurl": "http://example.com",
     "adm": "<h1>example</h1>",
     "w": 300,
     "h": 250,
     "adomain": [
      "example.com"
     ],
     "cid": "atomx-123",
     "crid": "atomx-456"
    }
   ],
   "seat": "atomx-789"
  }
 ]
}

DSP

Example Request

{
  "id": "WiZOtSwBm7jsEAX8Vv-MPA",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "id": "1"
      },
      "tagid": "123123",
      "bidfloor": 0.016666666666666666,
      "bidfloorcur": "USD"
    }
  ],
  "site": {
    "id": "atomx-234234",
    "name": "Example site",
    "domain": "example.com",
    "cat": [
      "IAB19-18"
    ],
    "page": "http://example.com/path/foo?bar=zzz",
    "publisher": {
      "id": "atomx-345345",
      "name": "Example publisher"
    }
  },
  "device": {
    "ua": "Mozilla/5.0  (Windows  NT  10.0;  Win64;  x64)  AppleWebKit/537.36  (KHTML,  like  Gecko)  Chrome/62.0.3202.94  Safari/537.36",
    "geo": {
      "type": 2,
      "country": "KEN",
      "zip": "Unknown"
    },
    "ip": "41.215.77.6",
    "devicetype": 2,
    "os": "Windows",
    "js": 1,
    "flashver": "11",
    "carrier": "Unknown",
    "connectiontype": 1
  },
  "user": {
    "id": "WisOtdwB5Xc8fTpxXCrl8Q"
  },
  "at": 2,
  "tmax": 190,
  "cur": [
    "USD"
  ]
}

Extensions

We might send extra information in the request.ext.ra object. This is an array consisting of detected request attribute IDs. The full and up-to-date list of available request attributes can be found at http://api.atomx.com/v3/request-attributes.

Reporting

Billing

DSPs are only billed for unsold traffic. Meaning all requests that the DSP didn't win. A count of these requests can be found in the DSP Reporting. The CPM fee Atomx bills for these unsold requests can be found on your network overview page as the DSP Fee.