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.
Some entries are partner-visible OpenRTB fields. Others are Prebid.js configuration, bidder-specific parameters, or Ezoic/Prebid Server metadata used for routing, floors, experimentation, or analytics. Each catalog entry calls out when the field is present and whether it is expected to be partner-visible or internal to the Ezoic/PBS path.
Download the PDF reference for a partner-ready snapshot of the full catalog.
Complete Example Request 🔗
This representative OpenRTB request shows how common display, video, S2S, identity, floor, privacy, and Ezoic extension signals can appear together. Example identifiers, geography, identity, 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",
"ref": "https://www.search.example/",
"cat": [
"IAB1-6"
],
"sectioncat": [
"IAB1-6"
],
"pagecat": [
"IAB1-6",
"IAB12"
],
"cattax": 6,
"keywords": "travel,road trips,national parks",
"bcat": [
"IAB7"
],
"mobile": 1,
"privacypolicy": 1,
"publisher": {
"id": "12345",
"name": "Example Publisher"
},
"content": {
"id": "article-123",
"title": "Example Article",
"cat": [
"IAB1-6"
],
"keywords": "road trips,packing list",
"language": "en",
"len": 124
},
"ext": {
"data": {
"verticals": [
"Travel"
],
"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",
"ipv6": "2001:db8::1",
"dnt": 0,
"devicetype": 2,
"os": "Windows",
"osv": "11.0.0",
"make": "ExampleMake",
"model": "ExampleModel",
"js": 1,
"language": "en",
"geo": {
"country": "USA",
"region": "CA",
"city": "San Diego",
"zip": "<redacted>",
"lat": "<redacted>",
"lon": "<redacted>",
"type": 2,
"ipservice": 3,
"lastfix": 1
}
},
"user": {
"id": "example-user-id",
"buyeruid": "example-buyer-id",
"geo": {
"country": "USA",
"region": "CA"
},
"eids": [
{
"source": "uidapi.com",
"inserter": "ezoic.com",
"matcher": "ezoic.com",
"mm": 3,
"uids": [
{
"id": "example-uid2-token",
"atype": 3,
"ext": {
"stype": "ppuid"
}
}
]
}
],
"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
],
"dsa": {
"dsarequired": 1,
"pubrender": 0,
"datatopub": 1,
"transparency": []
}
}
},
"source": {
"fd": 1,
"tid": "example-transaction-id",
"ext": {
"schain": {
"ver": "1.0",
"complete": 1,
"nodes": [
{
"asi": "ezoic.ai",
"sid": "12345",
"hp": 1
}
]
}
}
},
"imp": [
{
"id": "display-1",
"banner": {
"format": [
{
"w": 300,
"h": 250
}
],
"w": 300,
"h": 250,
"pos": 1
},
"bidfloor": 0.35,
"bidfloorcur": "USD",
"secure": 1,
"ext": {
"gpid": "div-gpt-ad-1",
"data": {
"pbadslot": "div-gpt-ad-1",
"ez_slot_id": "div-gpt-ad-1",
"ez_position": "above_the_fold",
"ez_viewability": 0.72,
"ez_ctr": 0.0012,
"ez_sov": 0.1687,
"ez_viewport_density": 8,
"ez_render_seq": 3,
"ez_attention": 6.4,
"ez_time_on_page": 42,
"ez_refresh": 0,
"ez_avg_refresh": 1,
"ezId": [
"v3",
"c2",
"a4"
]
},
"prebid": {
"floors": {
"floormin": 0.35,
"floormincur": "USD",
"tfl": [
0.1,
0.25,
0.5
]
}
}
}
},
{
"id": "video-1",
"video": {
"mimes": [
"video/mp4",
"video/webm",
"application/javascript"
],
"minduration": 5,
"maxduration": 30,
"protocols": [
2,
3,
7,
8,
11,
12
],
"w": 640,
"h": 360,
"startdelay": 0,
"placement": 1,
"plcmt": 4,
"linearity": 1,
"api": [
2,
7,
8
],
"playbackmethod": [
2
],
"pos": 2,
"skip": 1,
"skipafter": 5,
"skipmin": 16,
"minbitrate": 300,
"maxbitrate": 9600,
"playbackend": 3
},
"bidfloor": 1.25,
"bidfloorcur": "USD",
"secure": 1,
"rwdd": 0,
"ext": {
"gpid": "video-gpid-1",
"ezoic": {
"impression_id": 123456789,
"position_type": 15,
"refresh_count": 0
},
"data": {
"ez_video": "true",
"ez_player_id": "example-player"
},
"prebid": {
"is_rewarded_inventory": 0,
"floors": {
"floormin": 1.25,
"floormincur": "USD"
}
}
}
}
],
"ext": {
"prebid": {
"auctiontimestamp": 1700000000000,
"channel": {
"name": "pbjs",
"version": "9.x"
},
"targeting": {
"pricegranularity": {
"ranges": [
{
"max": 300,
"increment": 0.01
}
]
},
"includewinners": true,
"includebidderkeys": true
},
"aliases": {
"rubicon_s2s": "rubicon"
},
"cache": {
"vastxml": {
"returnCreative": false
}
},
"ezoic": {
"domain_id": 12345,
"page_view_id": "example-pageview-id",
"ab_test_id": "mod-example",
"form_factor_id": 1,
"t_pageview_epoch": 1700000000,
"country": "US",
"tf": {
"example_feature": "true"
}
},
"floors": {
"enabled": true,
"enforcement": {
"enforcepbs": false
},
"data": {
"currency": "USD",
"floorsschemaversion": 2,
"modelgroups": [
{
"modelversion": "1.0",
"currency": "USD",
"default": 0.1,
"schema": {
"delimiter": "|",
"fields": [
"mediaType",
"size"
]
},
"values": {
"banner|300x250": 0.35,
"video|640x360": 1.25,
"*|*": 0.01
}
}
]
}
}
}
}
}