OpenRTB Parameter Disclosure

Ezoic sends OpenRTB parameters in display and video bid requests. Use this reference to search parameters, understand what each value means, and compare display/video examples.

Complete Example Request 🔗

This representative OpenRTB request shows how common display and video signals can appear together. Example identifiers, geography, and user values are placeholders or redacted.

{
  "id": "ez-example-request-1",
  "at": 1,
  "tmax": 1000,
  "cur": ["USD"],
  "site": {
    "id": "example-site",
    "name": "Example Publisher",
    "domain": "example.com",
    "page": "https://example.com/article/example",
    "cat": ["IAB1-6"],
    "publisher": {
      "id": "12345",
      "name": "Example Publisher"
    },
    "content": {
      "id": "article-123",
      "title": "Example Article",
      "cat": ["IAB1-6"],
      "language": "en"
    },
    "ext": {
      "data": {
        "ez_pageview_id": "example-pageview-id",
        "ez_domain_id": "12345",
        "ez_device": "desktop",
        "ez_ad_position": "sidebar"
      }
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (example user agent)",
    "ip": "203.0.113.10",
    "devicetype": 2,
    "os": "Windows",
    "js": 1,
    "language": "en",
    "geo": {
      "country": "USA",
      "region": "CA",
      "city": "San Diego",
      "zip": "<redacted>",
      "lat": "<redacted>",
      "lon": "<redacted>"
    }
  },
  "user": {
    "id": "example-user-id",
    "buyeruid": "example-buyer-id",
    "eids": [
      {
        "source": "sharedid.org",
        "uids": [
          {
            "id": "example-shared-id",
            "atype": 1
          }
        ]
      }
    ],
    "ext": {
      "consent": "example-consent-string",
      "data": {
        "topics": [
          {
            "taxonomy": 1,
            "id": 123
          }
        ]
      }
    }
  },
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 0,
      "us_privacy": "1---",
      "gpp": "example-gpp-string",
      "gpp_sid": [7]
    }
  },
  "source": {
    "fd": 1,
    "tid": "example-transaction-id",
    "ext": {
      "schain": {
        "ver": "1.0",
        "complete": 1,
        "nodes": [
          {
            "asi": "ezoic.com",
            "sid": "12345",
            "hp": 1
          }
        ]
      }
    }
  },
  "imp": [
    {
      "id": "display-1",
      "banner": {
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ],
        "w": 300,
        "h": 250
      },
      "bidfloor": 0.35,
      "bidfloorcur": "USD",
      "secure": 1,
      "ext": {
        "data": {
          "ez_slot_id": "div-gpt-ad-1",
          "ez_position": "above_the_fold",
          "ez_viewability": "0.72"
        }
      }
    },
    {
      "id": "video-1",
      "video": {
        "mimes": ["video/mp4"],
        "minduration": 5,
        "maxduration": 30,
        "protocols": [2, 3, 5, 6],
        "w": 640,
        "h": 360,
        "startdelay": 0,
        "placement": 1,
        "linearity": 1
      },
      "bidfloor": 1.25,
      "bidfloorcur": "USD",
      "secure": 1,
      "ext": {
        "data": {
          "ez_video": "true",
          "ez_player_id": "example-player"
        }
      }
    }
  ],
  "ext": {
    "prebid": {
      "auctiontimestamp": 1700000000000,
      "channel": {
        "name": "pbjs",
        "version": "9.x"
      },
      "floors": {
        "floorMin": 0.01,
        "floorProvider": "ezoic",
        "data": {
          "currency": "USD",
          "schema": {
            "fields": ["mediaType", "size"]
          },
          "values": {
            "banner|300x250": 0.35,
            "video|640x360": 1.25
          },
          "default": 0.10
        }
      }
    }
  }
}