Verizon Media SSP Native Ads OpenRTB Integration Specs

The Verizon Media SSP combines the best in monetization for Publishers and Advertisers, and Native is now available! Our strong supply-side offering coupled with the configuration of the Gemini demand makes it easy to programmatically buy and sell Native inventory.

Integration Protocol and Specs

Verizon Media SSP bases its Native OpenRTB specifications on the specs published by the IAB. The SSP supports OpenRTB Native 1.0, 1.1 or 1.2 Protocol definitions. We recommend new bidders integrate with the OpenRTB Native 1.1 Protocol definition or higher.

General Settings

The following section provides guidance to both Publishers and Advertisers on the general settings available for Native integrations to the SSP.

Supported Creative Formats & Asset Groups

Native Card - Title, Image, Advertiser Name and CTA Text
Native App Install - Title, Image, Advertiser Name, CTA Text and App Icon
Native Video - Title, Image, Advertiser Name, CTA Text and Video

Integration Specifications for Advertisers and Bidders

The section provides insight into the required and optional fields for SSP Native advertising.

Native Ad Request Markup Details

Native Markup Request Object

Attribute	Usage	Required?	Notes
ver	Supported (VMX/1M)	Required	Version of the Native Markup currently in use
context	Supported (VMX/1M)	Required	The context in which the ad appears, 1=Content, 2=Social, 3=Product
contextsubtype	Supported (VMX/1M)	Required	A more detailed context in which the ad appears. Typically General or Mixed (10).
plcmttype	Supported (VMX/1M)	Required	The format of the inventory being offered 1=In Feed, 2= In Content, 3=Outside Content, 4=Recommendation
plcmtcnt	Supported (VMX/1M)	Optional	The number of identical placements in a layout (typically 1)
assets	Supported (VMX/1M)	Required	Any bid response must comply with the array of elements expressed in the bid request
eventtrackers	Supported (VMX/1M)	Required
aurlsupport	Supported (VMX/1M)	Optional
durlsupport	Supported (VMX/1M)	Optional
privacy	Supported (VMX/1M)	Optional
seq	Supported (VMX/1M)	Optional

Asset Request Object

Attribute	Usage	Required?	Notes
id	Supported (VMX/1M)	Required
required	Supported (VMX/1M)	Optional	Set to 1 if an asset is required
title	Supported (VMX/1M)	Optional
img	Supported (VMX/1M)	Optional
video	Supported (VMX/1M)	Optional
data	Supported (VMX/1M)	Optional	9=Price, 8=Phone, 3=Rating, 2 or 10=Description

Title Request Object

Attribute	Usage	Required?	Notes
len	Supported (VMX/1M)	Required	Maximum character length of text in the title element; recommended 140, 90 or 25

Image Request Object

Attribute	Usage	Required?	Notes
type	Supported (VMX/1M)	Optional
wmin	Supported (VMX/1M)	Required	Minimum width, usually 1200
hmin	Supported (VMX/1M)	Required	Minimum height, usually 627

Video Request Object

Attribute	Usage	Required?	Notes
mimes	Supported (VMX/1M)	Required
minduration	Supported (VMX/1M)	Required	Minimum duration of a video ad in seconds; typically 5
maxduration	Supported (VMX/1M)	Required	Maximum duration of a video ad in seconds; typically 30
protocols	Supported (VMX/1M)	Required

Data Request Object

Attribute	Usage	Required?	Notes
type	Supported (VMX/1M)	Required
len	Supported (VMX/1M)	Optional

Event Tracker Request Object

Attribute	Usage	Required?	Notes
event	Supported (VMX/1M)	Required
methods	Supported (VMX/1M)	Required

Native Ad Response Markup Details

Native Markup Response Object

Attribute	Usage	Required?	Notes
ver	Supported (VMX/1M)	Required	Version of the Native Markup in use, example 1.0, 1.1 or 1.2
assets	Supported (VMX/1M)	Required
link	Supported (VMX/1M)	Required
imptrackers	Supported (VMX/1M)	Optional
eventtrackers	Supported (VMX/1M)	Optional
privacy	Supported (VMX/1M)	Optional

Asset Response Object

Attribute	Usage	Required?	Notes
id	Supported (VMX/1M)	Optional	.
required	Supported (VMX/1M)	Optional
title	Supported (VMX/1M)	Optional
img	Supported (VMX/1M)	Optional
video	Supported (VMX/1M)	Optional
data	Supported (VMX/1M)	Optional
link	Supported (VMX/1M)	Required

Title Response Object

Attribute	Usage	Required?	Notes
text	Supported (VMX/1M)	Required

Image Response Object

Attribute	Usage	Required?
url	Supported (VMX/1M)	Required
w	Supported (VMX/1M)	Required
h	Supported (VMX/1M)	Required

Data Response Object

Attribute	Usage	Required?	Notes
type	Supported (VMX/1M)	Optional
value	Supported (VMX/1M)	Required

Video Response Object

Attribute	Usage	Required?	Notes
vasttag	Supported (VMX/1M)	Required

Link Response Object

Attribute	Usage	Required?	Notes
url	Supported (VMX/1M)	Required

Event Tracker Response Object

Attribute	Usage	Required?
event	Supported (VMX/1M)	Required
method	Supported (VMX/1M)	Required
url	Supported (VMX/1M)	Required

Sample Bid Requests

In-app

{

"id": "5825asdd51463854635",

"at": 2,

"imp": [

{

"id": "525155asdfasdf52445",

"instl": 0,

"displaymanager": "verizon",

"displaymanagerver": "1.3.3",

"bidfloor": 0.17,

"bidfloorcur": "USD",

"ext": {

"nex_screen": 0

"pmp": {

"deals": [

{

"id": "4556515655254"

}

]

"secure": 1,

"native": {

"request": "{\"native\":{\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":140}},{\"id\":2,\"required\":1,\"data\":{\"type\":1,\"len\":15}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":4,\"required\":1,\"img\":{\"type\":1,\"wmin\":50,\"hmin\":50}},{\"id\":5,\"required\":0,\"data\":{\"type\":12,\"len\":12}}],\"seq\":0,\"ver\":\"1\"}}",

"ver": "1"

}

"app": {

"id": "4155",

"name": "Pub",

"publisher": {

"id": "517556",

"name": "Pub",

"ext": {

"nex_else": 0

}

"cat": [

"IAB24"

"ext": {

"nex_sdkv": "1.3.3"

"storeurl": "http://itunes.apple.com/"

"device": {

"ifa": "42DSGSWEG-SEDGF-52SDFSD",

"dnt": 0,

"ip": "0.0.0.0",

"carrier": "vodafone germany",

"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",

"make": "Apple",

"model": "iPhone",

"osv": "13_3",

"js": 1,

"os": "iOS",

"language": "de",

"connectiontype": 3,

"devicetype": 4,

"hwv": "iPhone12,1",

"geo": {

"lat": 53.177124,

"lon": 8.002543,

"country": "DEU",

"city": "HAMBURG",

"zip": "20144",

"region": "Hamburg",

"type": 1

"lmt": 0

"user": {

"id": "asfghadfhaergawet",

"geo": {

"zip": "20144",

"type": 3

}

"ext": {

"omidpn": "Oath",

"omidpv": "1.2.5",

"schain": {

"complete": 1,

"ver": "1.0"

"screen_orientation": 1

"cur": [

"USD"

"regs": {

"coppa": 0,

"ext": {

"gdpr": 1

}

"tmax": 200

}

Desktop/Mobile Web

{

"id": "4456569846218748516588137",

"at": 2,

"imp": [

{

"id": "555451661asdf8413654adf",

"instl": 0,

"displaymanager": "verizon",

"displaymanagerver": "1.3.3",

"bidfloor": 0.17,

"bidfloorcur": "USD",

"ext": {

"nex_screen": 0

"pmp": {

"deals": [

{

"id": "47484548745578564874"

}

]

"secure": 1,

"native": {

"ver": "1"

}

"site": {

"page": "https://old.reddit.com",

"publisher": {

"id": "asd-5812484518",

"ext": {

"country": "US"

}

"content": {

"livestream": 0,

"language": "en"

"ext": {

"amp": 0

}

"device": {

"ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36",

"ip": "0.0.0.0",

"geo": {

"lat": 37.7749,

"lon": 122.4194,

"country": "USA",

"region": "CA",

"city": "San Francisco",

"zip": "94016"

"os": "Macintosh",

"devicetype": 2,

"pxratio": 1

"user": {

"id": "asweryaeirugaerighskdghnsithjistrhka",

"buyeruid": "kasrktrughakrfkbiaiertjawehjtbafdhsdtgjsrtyj",

"customdata": "kasrktrughakrfkbiaiertjawehjtbafdhsdtgjsrtyj"

"ext": {

"omidpn": "Oath",

"omidpv": "1.2.5",

"schain": {

"complete": 1,

"ver": "1.0"

"screen_orientation": 1

"cur": [

"USD"

"regs": {

"coppa": 0,

"ext": {

"gdpr": 1

}

"tmax": 200

}