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?

Notes

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?

Notes

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": {

"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"

}

}

],

"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

}