Verve Brand+ CTV integration guide

OpenRTB integration for Verve’s Brand+ (B+) marketplace, for CTV supply and demand partners.

[!NOTE]
Draft v0.1 for review. Supports OpenRTB 2.5 and 2.6, VAST InLine and Wrapper, and first-price auctions only (at = 1).

Start here

I am…	Read in this order
📺 A publisher or SSP sending CTV inventory	Setup → Ad request → Ad response → Ad pods
💰 A DSP buying CTV	Setup → Bid request → Bid response → Ad pods
🔎 Looking something up	2.5 vs 2.6 · Macros · Enums · Troubleshooting · Glossary

Legend used in every field table: 🔴 Required · 🔵 Recommended · ⚪ Optional. Click any ▶ row to expand it.

How a CTV ad moves through Brand+
Supply partners: Setup, Ad request, Ad response
Demand partners: Setup, Bid request, Bid response
Ad pods
Where fields go in 2.5 vs 2.6
Macros and tracking
Enum reference
Troubleshooting
Glossary

1. How a CTV ad moves through Brand+

sequenceDiagram
    participant P as Publisher / SSP
    participant B as Brand+
    participant D as DSP
    P->>B: 1. Ad request (OpenRTB 2.5 or 2.6)
    B->>D: 2. Bid request (one per DSP, one per pod slot)
    D-->>B: 3. Bid response (VAST in adm)
    B-->>P: 4. Ad response (winning VAST + Brand+ tracking)

Step	Message	Direction	Details
1	Ad request	Publisher to Brand+	2.2
2	Bid request	Brand+ to DSP	3.2
3	Bid response	DSP to Brand+	3.3
4	Ad response	Brand+ to publisher	2.3

_{Back to top}

2. Supply partners

2.1 Setup

Checklist

Send requests to the regional endpoint closest to your traffic (below).
Send the header x-openrtb-version with 2.5 or 2.6.
Put your Verve (Brand+) publisher ID in app.publisher.id.
Put the AdBreak ID in imp.tagid.
Set at to 1.

[!WARNING]
Without the x-openrtb-version header, requests are processed as OpenRTB 2.3, so 2.5 and 2.6 fields may be ignored.

Endpoints

Region	Endpoint
US East	`https://ortb26-us-east-1.ad.smaato.net/oapi/exchange/ortb26`
EU West	`https://ortb26-eu-west-1.ad.smaato.net/oapi/exchange/ortb26`
APAC	`https://ortb26-ap-southeast-1.ad.smaato.net/oapi/exchange/ortb26`

Some partners get a dedicated endpoint instead; your Verve account manager will share it. No token goes in the URL: requests are identified by app.publisher.id and imp.tagid.

Connection requirements

Connection	Requirement
Protocol	HTTPS. All published endpoints use HTTPS.
Compression	gzip-encoded requests are accepted (`Content-Encoding: gzip`).
QPS	Agreed individually with each partner.
Timeout	Set `tmax` to the time you allow Verve to respond, in milliseconds.

[!CAUTION]
Requests are rejected with HTTP 422 when regs.coppa = 1; when no usable public IP is available (device.ip, device.ipv6 and the connection’s IP are all missing, private or reserved); or when the user is under 14.

2.2 Ad request

Your player or SSP asks Brand+ for an ad: one HTTPS POST containing an OpenRTB bid request. Send a whole ad pod as one request (see Ad pods).

Sample: standard ad request

{
  "id": "a1b2c3d4-0000-4000-8000-000000000001",
  "imp": [
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000002",
      "video": {
        "mimes": ["video/mp4"],
        "linearity": 1,
        "minduration": 1,
        "maxduration": 120,
        "protocols": [2, 3, 5, 6],
        "startdelay": -1,
        "pos": 7,
        "battr": [3, 8, 9, 10, 12, 14, 17],
        "minbitrate": 1,
        "maxbitrate": 100000,
        "playbackmethod": [1],
        "boxingallowed": 1,
        "placement": 1,
        "skip": 0,
        "plcmt": 1,
        "w": 1920,
        "h": 1080,
        "sequence": 1,
        "ext": {
          "context": "adpod"
        }
      },
      "tagid": "<BRAND_PLUS_ADBREAK_ID>",
      "bidfloor": 9.0,
      "bidfloorcur": "USD",
      "instl": 0,
      "secure": 1,
      "metric": [
        {
          "type": "video_completion_rate",
          "value": 0.95,
          "vendor": "EXCHANGE"
        }
      ],
      "ssai": 3,
      "ext": {},
      "exp": 3600
    }
  ],
  "app": {
    "id": "<APP_ID>",
    "name": "Example CTV App",
    "bundle": "<STORE_APP_ID>",
    "storeurl": "https://channelstore.example.com/apps/example-ctv-app",
    "cat": [],
    "pagecat": [],
    "domain": "example-ctv-app.com",
    "publisher": {
      "id": "<BRAND_PLUS_PUBLISHER_ID>",
      "name": "Example Publisher"
    },
    "content": {
      "id": "",
      "title": "",
      "season": "0",
      "genre": "news",
      "producer": {
        "id": "",
        "name": "",
        "cattax": 1
      },
      "cat": [],
      "contentrating": "",
      "keywords": "",
      "language": "",
      "livestream": 1,
      "ext": {
        "network": "Example Network",
        "channel": ""
      },
      "cattax": 1
    },
    "ext": {
      "inventorypartnerdomain": "example-publisher.com"
    },
    "cattax": 1
  },
  "device": {
    "dnt": 0,
    "ua": "Roku/DVP-16.0 (16.0.4.842-51)",
    "ip": "192.0.2.1",
    "geo": {
      "country": "USA",
      "region": "CA",
      "city": "<CITY>",
      "zip": "<ZIP>",
      "type": 2,
      "lat": 0.0,
      "lon": 0.0,
      "ipservice": 3,
      "accuracy": 10000,
      "metro": "<DMA>"
    },
    "dpidsha1": "<SHA1_OF_DEVICE_ID>",
    "dpidmd5": "<MD5_OF_DEVICE_ID>",
    "make": "Roku",
    "model": "Digital Video player",
    "os": "Roku OS",
    "osv": "16.0",
    "devicetype": 7,
    "language": "",
    "ifa": "00000000-0000-0000-0000-000000000000",
    "lmt": 0,
    "ext": {
      "is_app": 1,
      "ifa_type": "rida"
    }
  },
  "user": {
    "id": "<USER_ID>",
    "ext": {
      "eids": [
        {
          "source": "example-id.com",
          "uids": [
            {
              "id": "<EID_UID>",
              "atype": 3,
              "ext": {
                "rtiPartner": "idl"
              }
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 250,
  "cur": ["USD"],
  "bcat": ["IAB23-1", "IAB25-1", "IAB25-2", "IAB25-3", "IAB25-4", "IAB25-5", "IAB25-6", "IAB25-7", "IAB26", "IAB26-1", "IAB26-2", "IAB26-3", "IAB26-4"],
  "badv": ["blocked-advertiser.example"],
  "source": {
    "fd": 0,
    "tid": "c1b2c3d4-0000-4000-8000-000000000003",
    "ext": {
      "schain": {
        "ver": "1.0",
        "complete": 1,
        "nodes": [
          {
            "asi": "example-ssp.com",
            "sid": "<SELLER_ID>",
            "hp": 1
          }
        ]
      }
    }
  },
  "regs": {
    "coppa": 0,
    "gdpr": 0,
    "ext": {
      "gdpr": 0,
      "us_privacy": "1YNN"
    }
  },
  "cattax": 1
}

Sample: dynamic ad pod (OpenRTB 2.6), up to 4 ads filling 120 seconds

{
  "id": "ckvvbteojs4lovcb9rfg",
  "imp": [
    {
      "id": "1",
      "video": {
        "mimes": ["video/mp4"],
        "minduration": 5,
        "maxduration": 30,
        "protocols": [2, 3, 5, 6, 7, 8],
        "w": 1920,
        "h": 1080,
        "startdelay": 0,
        "plcmt": 1,
        "linearity": 1,
        "skip": 0,
        "playbackmethod": [1],
        "delivery": [1, 2],
        "podid": "pod-1",
        "podseq": 1,
        "poddur": 120,
        "maxseq": 4,
        "poddedupe": [1, 2]
      },
      "tagid": "<BRAND_PLUS_ADBREAK_ID>",
      "bidfloor": 10.0,
      "bidfloorcur": "USD",
      "secure": 1,
      "exp": 3600,
      "ssai": 3,
      "rwdd": 0
    }
  ],
  "app": {
    "id": "123456",
    "name": "Example CTV App",
    "bundle": "com.example.ctvapp",
    "storeurl": "https://www.example.com/apps/ctvapp",
    "cat": ["IAB1"],
    "publisher": {
      "id": "<BRAND_PLUS_PUBLISHER_ID>",
      "name": "Example Publisher"
    },
    "content": {
      "id": "ep-0001",
      "title": "Example Episode",
      "series": "Example Series",
      "genre": "Comedy",
      "cat": ["IAB1"],
      "contentrating": "TV-PG",
      "livestream": 0,
      "len": 1800,
      "language": "en",
      "prodq": 1,
      "context": 1,
      "cattax": 1,
      "network": {
        "id": "net-1",
        "name": "Example Network",
        "domain": "examplenetwork.com"
      },
      "channel": {
        "id": "chan-1",
        "name": "Example Channel",
        "domain": "examplechannel.com"
      }
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (SMART-TV; Linux; Tizen 6.0) AppleWebKit/537.36 (KHTML, like Gecko) Version/6.0 TV Safari/537.36",
    "ip": "192.0.2.1",
    "geo": {
      "country": "USA",
      "region": "CA",
      "metro": "803",
      "type": 2
    },
    "devicetype": 3,
    "make": "Samsung",
    "model": "Tizen TV",
    "os": "Tizen",
    "osv": "6.0",
    "ifa": "00000000-0000-0000-0000-000000000000",
    "lmt": 0,
    "dnt": 0,
    "language": "en",
    "connectiontype": 2,
    "ext": {
      "ifa_type": "tifa"
    },
    "sua": {
      "source": 2,
      "platform": {
        "brand": "Tizen",
        "version": ["6", "0"]
      },
      "mobile": 0,
      "model": "Example TV Model"
    }
  },
  "user": {
    "id": "user-0001",
    "eids": [
      {
        "source": "example-id.com",
        "uids": [
          {
            "id": "EXAMPLE_UID",
            "atype": 3
          }
        ]
      }
    ]
  },
  "at": 1,
  "tmax": 500,
  "cur": ["USD"],
  "bcat": ["IAB25", "IAB26"],
  "source": {
    "fd": 1,
    "tid": "ckvvbteojs4lovcb9rg0",
    "schain": {
      "ver": "1.0",
      "complete": 1,
      "nodes": [
        {
          "asi": "example-ssp.com",
          "sid": "1234",
          "rid": "ckvvbteojs4lovcb9rfg",
          "hp": 1
        }
      ]
    }
  },
  "regs": {
    "coppa": 0,
    "gdpr": 0,
    "us_privacy": "1YNN",
    "gpp": "DBABTA~1YNN",
    "gpp_sid": [6]
  }
}

Field reference

Expand an object to see its fields.

Required at a glance: BidRequest.id, BidRequest.imp, BidRequest.app, BidRequest.device, BidRequest.at, Imp.id, Imp.video, Imp.tagid, Video.mimes, Video.minduration, Video.maxduration, Publisher.id

BidRequest (10 fields, 5 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	ID of the bid request, assigned by the exchange, and unique for the exchange’s subsequent tracking of the responses.
`imp`	object array	🔴 Required	Array of Imp objects representing the impressions offered.
`app`	object	🔴 Required	Details via an App object about the publisher’s app.	Rejected if neither app nor site is sent. CTV uses app.
`device`	object	🔴 Required	Details via a Device object about the user’s device to which the impression will be delivered.
`user`	object	🔵 Recommended	Details via a User object about the human user of the device; the advertising audience.
`at`	integer	🔴 Required	Auction type, where 1 = First Price, 2 = Second Price Plus.	Brand+ runs first-price auctions only: send 1.
`tmax`	integer	🔵 Recommended	Maximum time in milliseconds the exchange allows for bids to be received, including Internet latency.
`cur`	string array	⚪ Optional	Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes.	If sent, must include USD, otherwise the request is rejected.
`bcat`	string array	⚪ Optional	Blocked advertiser categories using the specified category taxonomy.
`badv`	string array	⚪ Optional	Block list of advertisers by their domains.

Source (4 fields)

Field	Type	Requirement	What it is	Brand+ rule
`fd`	integer	🔵 Recommended	Entity responsible for the final impression sale decision, where 0 = exchange, 1 = upstream source.
`tid`	string	🔵 Recommended	Transaction ID that must be common across all participants in this bid request.
`pchain`	string	🔵 Recommended	Payment ID chain string containing embedded syntax described in the TAG payment ID Protocol v1.0.
`schain`	object	⚪ Optional	The links in the supply chain, and an indicator of whether the supply chain is complete.	Required if you are not direct to Brand+. On 2.5, send as source.ext.schain.

Imp (11 fields, 3 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	A unique identifier for this impression within the context of the bid request.
`video`	object	🔴 Required	A Video object; required if this impression is offered as a video ad opportunity.
`tagid`	string	🔴 Required	Identifier for specific ad placement or ad tag that was used to initiate the auction.	Your Brand+ (SPX) AdBreakId. Prebid Server integrations use imp.ext.bidder.adSpace.
`bidfloor`	float	🔵 Recommended	Minimum bid for this impression expressed in CPM.
`bidfloorcur`	string	🔵 Recommended	Currency specified using ISO-4217 alpha codes.	Use USD.
`secure`	integer	🔵 Recommended	Flag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure.
`displaymanager`	string	🔵 Recommended	Name of ad mediation partner, SDK technology, or player responsible for rendering ad. Recommended for video and/or apps.
`displaymanagerver`	string	🔵 Recommended	Version of ad mediation partner, SDK technology, or player responsible for rendering ad. Recommended for video and/or apps.
`exp`	integer	⚪ Optional	Advisory as to the number of seconds that may elapse between the auction and the actual impression.
`pmp`	object	⚪ Optional	A Pmp object containing any private marketplace deals in effect for this impression.	Deal IDs are returned in the ad response only when enabled for your account.
`ssai`	integer	🔵 Recommended	Indicates if server-side ad insertion is in use: 0 = unknown, 1 = all client-side, 2 = assets stitched server-side but tracking fired client-side, 3 = all server-side.	OpenRTB 2.6.

Video (25 fields, 3 required)

Field	Type	Requirement	What it is	Brand+ rule
`mimes`	string array	🔴 Required	Content MIME types supported.
`minduration`	integer	🔴 Required in 2.5, optional in 2.6	Minimum video ad duration in seconds. Mutually exclusive with rqddurs.	In 2.6, send either min/maxduration or rqddurs.
`maxduration`	integer	🔴 Required in 2.5, optional in 2.6	Maximum video ad duration in seconds. Mutually exclusive with rqddurs.	In 2.6, send either min/maxduration or rqddurs.
`rqddurs`	integer array	⚪ Optional	Precise acceptable durations for video creatives in seconds. Targets the Live TV use case.	OpenRTB 2.6. Use instead of min/maxduration.
`protocols`	integer array	🔵 Recommended	Array of supported video protocols. Refer to List: Creative Subtypes - Audio/Video in AdCOM 1.0.
`w`	integer	🔵 Recommended	Width of the video player in device-independent pixels (DIPS).
`h`	integer	🔵 Recommended	Height of the video player in device-independent pixels (DIPS).
`startdelay`	integer	🔵 Recommended	Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.
`plcmt`	integer	🔵 Recommended	Video placement type for the impression. Refer to List: Plcmt Subtypes - Video in AdCOM 1.0.	Use 1 (instream) for CTV.
`placement`	integer	⚪ Optional	Deprecated as of OpenRTB 2.6-202303. Use plcmt instead.	Send plcmt instead; keep placement only for older integrations.
`linearity`	integer	🔵 Recommended	Indicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed.
`skip`	integer	🔵 Recommended	Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes.
`playbackmethod`	integer array	⚪ Optional	Playback methods that may be in use. If none are specified, any method may be used.
`delivery`	integer array	⚪ Optional	Supported delivery methods. If none specified, assume all are supported.
`minbitrate`	integer	⚪ Optional	Minimum bit rate in Kbps.
`maxbitrate`	integer	⚪ Optional	Maximum bit rate in Kbps.
`battr`	integer array	⚪ Optional	Blocked creative attributes. Refer to List: Creative Attributes in AdCOM 1.0.
`sequence`	integer	⚪ Optional	Deprecated as of OpenRTB 2.6. Use slotinpod.	Not used to identify ad pods. To send a pod, use imp.video.podid (2.6) or imp.video.ext.podid (2.5).
`podid`	string	⚪ Optional	Unique identifier indicating that an impression opportunity belongs to a video ad pod.	OpenRTB 2.6. Required for ad pods.
`podseq`	integer	🔵 Recommended for pods	The sequence (position) of the video ad pod within a content stream.	OpenRTB 2.6.
`poddur`	integer	⚪ Optional	Total amount of time in seconds that advertisers may fill for a dynamic video ad pod, or the dynamic portion of a hybrid pod.	OpenRTB 2.6. Required for dynamic or hybrid pods.
`maxseq`	integer	🔵 Recommended for pods	Maximum number of ads that may be served into a dynamic video ad pod.	OpenRTB 2.6.
`poddedupe`	enum array	⚪ Optional	Indicates pod deduplication settings that will be applied to bid responses.	OpenRTB 2.6.
`slotinpod`	integer	⚪ Optional	For video ad pods, indicates that the seller can guarantee delivery against the indicated slot position in the pod.	OpenRTB 2.6.
`mincpmpersec`	float	⚪ Optional	Minimum CPM per second. A price floor for the dynamic portion of a video ad pod, relative to bid duration.	OpenRTB 2.6.

App (7 fields)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔵 Recommended	Exchange-specific app ID.
`name`	string	🔵 Recommended	App name (may be aliased at the publisher’s request).
`bundle`	string	🔵 Recommended	The store ID of the app in an app store. See the OTT/CTV Store Assigned App Identification Guidelines.
`storeurl`	string	🔵 Recommended	App store URL for an installed app; for IQG 2.1 compliance.
`cat`	string array	⚪ Optional	Array of IAB Tech Lab content categories of the app. The taxonomy is defined by the cattax field.
`domain`	string	⚪ Optional	Domain of the app.
`ext.inventorypartnerdomain` (Verve ext)	—	🔵 Recommended	Domain of the partner whose app-ads.txt authorises the sale.	Forwarded to DSPs.

Publisher (1 field, 1 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	Exchange-specific seller ID. Corresponds to a seller_id in the exchange’s sellers.json file.	Your Brand+ (SPX) publisher ID. Prebid Server integrations use imp.ext.bidder.publisherId.

Content (17 fields)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔵 Recommended	Publisher-provided ID uniquely identifying the content.
`title`	string	🔵 Recommended	Content title.
`series`	string	⚪ Optional	Content series.
`season`	string	⚪ Optional	Content season.
`episode`	integer	⚪ Optional	Episode number.
`genre`	string	🔵 Recommended	Genre that best describes the content.
`cat`	string array	🔵 Recommended	Array of IAB Tech Lab content categories that describe the content.
`cattax`	integer	🔵 Recommended	The taxonomy in use. Refer to List: Category Taxonomies in AdCOM 1.0.
`contentrating`	string	🔵 Recommended	Content rating.
`livestream`	integer	🔵 Recommended	Method of broadcast of the content: 0 = not scheduled (e.g. VOD or user-initiated), 1 = scheduled (linear viewing).
`language`	string	🔵 Recommended	Content language using ISO-639-1-alpha-2. Only one of language or langb should be present.
`len`	integer	🔵 Recommended	Length of content in seconds; appropriate for video or audio.
`prodq`	integer	⚪ Optional	Production quality. Refer to List: Production Qualities in AdCOM 1.0.
`context`	integer	⚪ Optional	Type of content (game, video, text, etc.). Refer to List: Content Contexts in AdCOM 1.0.
`producer`	object	⚪ Optional	Details about the content Producer.
`ext.network` (Verve ext)	—	🔵 Recommended	Verve extension.	OpenRTB 2.5: network name.
`ext.channel` (Verve ext)	—	🔵 Recommended	Verve extension.	OpenRTB 2.5: channel name.

Network (1 field)

Field	Type	Requirement	What it is	Brand+ rule
`name`	string	🔵 Recommended	Network the content is on.	OpenRTB 2.6, as content.network.name.

Channel (1 field)

Field	Type	Requirement	What it is	Brand+ rule
`name`	string	🔵 Recommended	Channel the content is on.	OpenRTB 2.6, as content.channel.name.

Device (16 fields)

Field	Type	Requirement	What it is	Brand+ rule
`ua`	string	🔵 Recommended	Browser user agent string. This field represents a raw user agent string from the browser.
`sua`	object	🔵 Recommended	Structured user agent information defined by a UserAgent object.	OpenRTB 2.6.
`ip`	string	🔵 Recommended	IPv4 address closest to device.
`ipv6`	string	⚪ Optional	IP address closest to device as IPv6.
`geo`	object	🔵 Recommended	Location of the device assumed to be the user’s current location, defined by a Geo object.
`devicetype`	integer	🔵 Recommended	The general type of device. Refer to List: Device Types in AdCOM 1.0.	3 = connected TV, 7 = set-top box.
`make`	string	🔵 Recommended	Device make.
`model`	string	🔵 Recommended	Device model.
`os`	string	🔵 Recommended	Device operating system.
`osv`	string	🔵 Recommended	Device operating system version.
`ifa`	string	🔵 Recommended	ID sanctioned for advertiser use in the clear (not hashed).
`ext.ifa_type` (Verve ext)	—	🔵 Recommended	Verve extension.	IFA type, for example tifa or rida.
`lmt`	integer	🔵 Recommended	“Limit Ad Tracking” signal commercially endorsed, where 0 = tracking is unrestricted, 1 = tracking must be limited.
`dnt`	integer	🔵 Recommended	Standard “Do Not Track” flag, where 0 = tracking is unrestricted, 1 = do not track.
`language`	string	⚪ Optional	Browser language using ISO-639-1-alpha-2.
`connectiontype`	integer	⚪ Optional	Network connection type. Refer to List: Connection Types in AdCOM 1.0.

User (4 fields)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔵 Recommended	Exchange-specific ID for the user.	Send id or buyeruid.
`buyeruid`	string	🔵 Recommended	Buyer-specific ID for the user as mapped by the exchange for the buyer.	Send id or buyeruid.
`eids`	object array	🔵 Recommended	Details for support of a standard protocol for multiple third party identity providers.	On 2.5, send as user.ext.eids.
`consent`	string	⚪ Optional	When GDPR regulations are in effect, contains the Transparency and Consent Framework’s Consent String.	Required where GDPR applies. On 2.5, send as user.ext.consent.

Regs (5 fields)

Field	Type	Requirement	What it is	Brand+ rule
`coppa`	integer	⚪ Optional	Flag indicating if this request is subject to the COPPA regulations established by the USA FTC, where 0 = no, 1 = yes.	Brand+ does not accept child-directed traffic: requests with coppa = 1 are rejected.
`gdpr`	integer	⚪ Optional	Whether the request is subject to GDPR regulations: 0 = No, 1 = Yes, omission indicates unknown.	Required where GDPR applies. On 2.5, send as regs.ext.gdpr.
`us_privacy`	string	⚪ Optional	Communicates signals regarding consumer privacy under US privacy regulation.	Required where US privacy laws apply. On 2.5, send as regs.ext.us_privacy.
`gpp`	string	⚪ Optional	Contains the Global Privacy Platform’s consent string.	Required where GPP applies.
`gpp_sid`	integer array	⚪ Optional	Array of the section(s) of the GPP string which should be applied for this transaction.	Required where GPP applies.

_{Back to top}

2.3 Ad response

Verve returns the winning ad using your request and impression IDs. The ad is a VAST file containing the advertiser’s video, plus Verve’s tracking URLs for impressions, errors, video progress and clicks.

Sample: ad response

{
  "id": "a1b2c3d4-0000-4000-8000-000000000001",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d1b2c3d4-0000-0000-0000-000000000004",
          "impid": "a1b2c3d4-0000-4000-8000-000000000002",
          "price": 11.0,
          "adid": "<CREATIVE_ID>",
          "nurl": "https://tracking.brandplus.example/winnotice?ap=${AUCTION_PRICE}",
          "lurl": "https://tracking.brandplus.example/lossnotice?ap=${AUCTION_PRICE}&al=${AUCTION_LOSS}",
          "adm": "<VAST version=\"3.0\"><Ad id=\"dsp-bid-0001\"><InLine><AdTitle>Example Ad</AdTitle><Error><![CDATA[https://tracking.brandplus.example/error?code=[ERRORCODE]]]></Error><AdSystem version=\"1.0\">Verve</AdSystem><Impression><![CDATA[https://tracking.brandplus.example/impression]]></Impression><Impression><![CDATA[https://dsp.example/imp]]></Impression><Creatives><Creative><Linear><Duration>00:00:30.000</Duration><TrackingEvents><Tracking event=\"start\"><![CDATA[https://tracking.brandplus.example/start]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[https://tracking.brandplus.example/q1]]></Tracking><Tracking event=\"midpoint\"><![CDATA[https://tracking.brandplus.example/mid]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[https://tracking.brandplus.example/q3]]></Tracking><Tracking event=\"complete\"><![CDATA[https://tracking.brandplus.example/complete]]></Tracking></TrackingEvents><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" bitrate=\"3500\" width=\"1920\" height=\"1080\"><![CDATA[https://cdn.dsp.example/ad_1920x1080.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>",
          "adomain": ["advertiser.example"],
          "bundle": "<ADVERTISER_APP_BUNDLE>",
          "iurl": "https://cdn.dsp.example/companion_1280x720.jpeg",
          "cid": "<CAMPAIGN_ID>",
          "burl": "https://tracking.brandplus.example/impression?ap=${AUCTION_PRICE}",
          "crid": "<CREATIVE_ID>",
          "cat": ["IAB9-30"],
          "w": 1280,
          "h": 720,
          "dur": 30,
          "ext": {
            "duration": 30
          }
        }
      ]
    }
  ],
  "bidid": "e1b2c3d4-0000-4000-8000-000000000005",
  "cur": "USD"
}

Field reference

Expand an object to see its fields.

Required at a glance: BidResponse.id, BidResponse.bidid, BidResponse.cur, Bid.id, Bid.impid, Bid.price, Bid.adm, Bid.nurl, Bid.adid, Bid.crid

BidResponse (3 fields, 3 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	ID of the bid request to which this is a response.	Echoes your request ID.
`bidid`	string	🔴 Required	Bidder generated response ID to assist with logging/tracking.
`cur`	string	🔴 Required	Bid currency using ISO-4217 alpha codes.	USD.

Bid (22 fields, 7 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	Bidder generated bid ID to assist with logging/tracking.	Unique per winning ad, including each ad in a pod.
`impid`	string	🔴 Required	ID of the Imp object in the related bid request.
`price`	float	🔴 Required	Bid price expressed as CPM although the actual transaction is for a unit impression only.	USD CPM.
`adm`	string	🔴 Required	Optional means of conveying ad markup in case the bid wins; supersedes the win notice if markup is included in both.	VAST. Brand+ returns the winning DSP’s VAST with its own impression, error and tracking events added.
`nurl`	string	🔴 Required	Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad).
`burl`	string	⚪ Optional	Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy.	When configured for your account.
`lurl`	string	⚪ Optional	Loss notice URL called by the exchange when a bid is known to have been lost.	When configured for your account.
`adid`	string	🔴 Required	ID of a preloaded ad to be served if the bid wins.	Falls back to crid.
`crid`	string	🔴 Required	Creative ID to assist with ad quality checking.
`cid`	string	⚪ Optional	Campaign ID to assist with ad quality checking.	From the winning DSP bid.
`adomain`	string array	⚪ Optional	Advertiser domain for block list checking.	From the winning DSP bid.
`cat`	string array	⚪ Optional	IAB Tech Lab content categories of the creative. The taxonomy is defined by the cattax field.	From the winning DSP bid.
`iurl`	string	⚪ Optional	URL without cache-busting to an image that is representative of the content of the campaign, for ad quality/safety checking.
`bundle`	string	⚪ Optional	The store ID of the app in an app store.
`attr`	integer array	⚪ Optional	Set of attributes describing the creative. Refer to List: Creative Attributes in AdCOM 1.0.
`w` / `h`	integer	⚪ Optional	Width and height of the creative in device-independent pixels (DIPS).
`dur`	integer	⚪ Optional	Duration of the video or audio creative in seconds.	Also sent as ext.duration. Left out when neither the bid nor its VAST gives a duration.
`ext.duration` (Verve ext)	—	⚪ Optional	Verve extension.	Creative duration, mirroring dur.
`podid` (Verve ext)	—	⚪ Optional	The IAB defines podid on the Video object of the request, not on the Bid.	Pod the ad fills; sent for pod requests. 2.6 publishers get podid and ext.podid; 2.5 publishers get ext.podid only.
`dealid`	string	⚪ Optional	Reference to the deal.id from the bid request if this bid pertains to a private marketplace direct deal.	Only when deal ID pass-back is enabled for your account.
`apis`	integer array	⚪ Optional	List of supported APIs for the markup. If an API is not explicitly listed, it is assumed to be unsupported.	Also sent as ext.apis.
`ext.imptrackers` (Verve ext)	—	⚪ Optional	Verve extension.	When configured.

_{Back to top}

3. Demand partners

3.1 Setup

Checklist. Send these to your Verve account manager; Verve configures the integration on its side.

Your CTV endpoint URLs (test and production) for each region you want traffic from.
Your requested QPS.
Whether your endpoints use HTTPS or HTTP.
Whether you want gzip-compressed bid requests.

[!IMPORTANT]
Verve sends traffic from the US, EU and APAC, and each region sends only to its own registered endpoint. If no endpoint is registered for a region, that region sends you no traffic.

Connection	Details
Protocol	HTTPS is recommended. HTTP endpoints can also be configured.
Compression	gzip compression of bid requests is available on request.
QPS	Configured individually for each DSP and agreed with Verve.
Timeout	Respond within the `tmax` value in each bid request.

3.2 Bid request

Brand+ turns the publisher’s ad request into a bid request for each DSP. On the way it:

appends its own node to the supply chain, sent as a JSON-encoded string in source.ext.schain and top-level ext.schain;
adds imp.ext.gpid, taken from imp.tagid when the ad request has none;
splits a pod into one OpenRTB 2.5 request per slot, with pod details in imp.video.ext;
standardises device and content values.

Sample: bid request

{
  "app": {
    "bundle": "<STORE_APP_ID>",
    "cat": ["IAB24"],
    "content": {
      "cattax": 1,
      "id": "<CONTENT_ID>",
      "contentrating": "TV-PG",
      "language": "en",
      "channel": {
        "name": "Example Channel"
      },
      "ext": {
        "channel": "Example Channel",
        "network": "Example Network"
      },
      "genre": "News",
      "network": {
        "name": "Example Network"
      },
      "producer": {},
      "season": "0",
      "livestream": 1
    },
    "domain": "example-ctv-app.com",
    "ext": {
      "inventorypartnerdomain": "example-publisher.com"
    },
    "id": "<APP_ID>",
    "keywords": "App",
    "name": "Example CTV App",
    "publisher": {
      "id": "<BRAND_PLUS_PUBLISHER_ID>",
      "name": "Example Publisher"
    },
    "storeurl": "https://channelstore.example.com/apps/example-ctv-app"
  },
  "at": 1,
  "bcat": ["IAB23-1", "IAB25-1", "IAB25-2", "IAB25-3", "IAB25-4", "IAB25-5", "IAB25-6", "IAB25-7", "IAB26", "IAB26-1", "IAB26-2", "IAB26-3", "IAB26-4"],
  "cur": ["USD"],
  "device": {
    "carrier": "<ISP>",
    "connectiontype": 2,
    "devicetype": 3,
    "dnt": 0,
    "dpidmd5": "<MD5_OF_DEVICE_ID>",
    "dpidsha1": "<SHA1_OF_DEVICE_ID>",
    "ext": {
      "ifa_type": "rida"
    },
    "geo": {
      "accuracy": 10000,
      "city": "<CITY>",
      "country": "USA",
      "ext": {
        "isp": "<ISP>",
        "org": "<ISP>"
      },
      "lat": 0.0,
      "lon": 0.0,
      "region": "CA",
      "type": 2,
      "zip": "<ZIP>",
      "metro": "<DMA>",
      "ipservice": 3
    },
    "h": 720,
    "ifa": "00000000-0000-0000-0000-000000000000",
    "ip": "192.0.2.1",
    "js": 1,
    "language": "en",
    "lmt": 0,
    "make": "Roku",
    "model": "DVP",
    "os": "Roku OS",
    "osv": "16.0",
    "pxratio": 0,
    "ua": "Roku/DVP-16.0 (16.0.4.842-51)",
    "w": 1280
  },
  "ext": {
    "pchain": "<PAYMENT_ID_CHAIN>",
    "schain": "{\n \"ver\": \"1.0\",\n \"complete\": 1,\n \"nodes\": [\n  {\n   \"asi\": \"example-ssp.com\",\n   \"sid\": \"<SELLER_ID>\",\n   \"hp\": 1\n  },\n  {\n   \"asi\": \"lkqd.net\",\n   \"sid\": \"<BRAND_PLUS_PUBLISHER_ID>\",\n   \"rid\": \"b1b2c3d4000000000000000000000001\",\n   \"hp\": 1\n  }\n ]\n}"
  },
  "id": "b1b2c3d4000000000000000000000001",
  "imp": [
    {
      "bidfloor": "9.0",
      "bidfloorcur": "USD",
      "exp": 6300,
      "ext": {
        "gpid": "<BRAND_PLUS_ADBREAK_ID>",
        "hb": 1,
        "is_rewarded_inventory": false,
        "metric": [
          {
            "type": "click_through_rate",
            "value": 0.01687,
            "vendor": "EXCHANGE"
          }
        ]
      },
      "id": "b1b2c3d4-0000-0000-0000-000000000002",
      "instl": 0,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.01687,
          "vendor": "EXCHANGE"
        }
      ],
      "rwdd": 0,
      "secure": 1,
      "ssai": 3,
      "tagid": "<BRAND_PLUS_ADBREAK_ID>",
      "video": {
        "battr": [3, 8, 9, 10, 12, 14, 17],
        "boxingallowed": 1,
        "ext": {
          "orientation": "0"
        },
        "linearity": 1,
        "maxbitrate": 100000,
        "maxduration": 120,
        "mimes": ["video/mp4", "video/3gpp", "video/H264"],
        "minbitrate": 1,
        "minduration": 1,
        "placement": 1,
        "playbackend": 1,
        "playbackmethod": [1],
        "plcmt": 1,
        "pos": 7,
        "protocols": [2, 3, 5, 6],
        "skip": 0,
        "startdelay": -1,
        "w": 1920,
        "h": 1080,
        "sequence": 1
      },
      "pmp": {
        "deals": [
          {
            "id": "<DEAL_ID>",
            "bidfloor": "9.0",
            "at": 1
          }
        ]
      }
    }
  ],
  "regs": {
    "coppa": 0,
    "ext": {
      "agerange": "0",
      "consent": "",
      "gdpr": "0",
      "us_privacy": "1YNN"
    }
  },
  "source": {
    "ext": {
      "schain": "{\n \"ver\": \"1.0\",\n \"complete\": 1,\n \"nodes\": [\n  {\n   \"asi\": \"example-ssp.com\",\n   \"sid\": \"<SELLER_ID>\",\n   \"hp\": 1\n  },\n  {\n   \"asi\": \"lkqd.net\",\n   \"sid\": \"<BRAND_PLUS_PUBLISHER_ID>\",\n   \"rid\": \"b1b2c3d4000000000000000000000001\",\n   \"hp\": 1\n  }\n ]\n}"
    },
    "fd": 1,
    "pchain": "<PAYMENT_ID_CHAIN>",
    "tid": "c1b2c3d4-0000-4000-8000-000000000003"
  },
  "test": 0,
  "tmax": 235,
  "user": {
    "ext": {
      "eids": [
        {
          "source": "example-id.com",
          "uids": [
            {
              "id": "<EID_UID>",
              "atype": 3
            }
          ]
        }
      ]
    },
    "id": "<USER_ID>",
    "eids": [
      {
        "source": "example-id.com",
        "uids": [
          {
            "id": "<EID_UID>",
            "atype": 3
          }
        ]
      }
    ]
  }
}

Field reference

Expand an object to see its fields.

Required at a glance: BidRequest.id, BidRequest.at, BidRequest.tmax, BidRequest.cur, BidRequest.test, Imp.id, Imp.tagid, Imp.bidfloor, Imp.bidfloorcur, Imp.secure, Imp.exp, Imp.instl, Imp.rwdd, Imp.metric, Imp.ext.gpid, Video.mimes, Video.minduration, Video.maxduration, Video.protocols, Video.startdelay, Video.linearity, Video.skip, Video.plcmt, Video.pos, Video.playbackend, App.id, App.name, App.bundle, App.storeurl, App.cat, App.ext.inventorypartnerdomain, Publisher.id, Publisher.name, Device.ua, Device.ifa, Device.devicetype, Device.make / model / os / osv, Device.lmt, Device.dnt, Device.language, Device.geo, User.id, Source.fd, Source.tid, Source.pchain, Source.ext.schain, Regs.coppa, Regs.ext.gdpr / ext.consent / ext.us_privacy

BidRequest (8 fields, 5 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	ID of the bid request, assigned by the exchange, and unique for the exchange’s subsequent tracking of the responses.
`at`	integer	🔴 Required	Auction type, where 1 = First Price, 2 = Second Price Plus.	Auction type configured for the DSP (1 = first price).
`tmax`	integer	🔴 Required	Maximum time in milliseconds the exchange allows for bids to be received, including Internet latency.
`cur`	string array	🔴 Required	Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes.	Required USD.
`test`	integer	🔴 Required	Indicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test mode.
`bcat`	string array	⚪ Optional	Blocked advertiser categories using the specified category taxonomy.	Publisher and Brand+ blocks.
`badv`	string array	⚪ Optional	Block list of advertisers by their domains.
`wseat`	string array	⚪ Optional	Allowed list of buyer seats allowed to bid on this impression.

Imp (12 fields, 10 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	A unique identifier for this impression within the context of the bid request.
`tagid`	string	🔴 Required	Identifier for specific ad placement or ad tag that was used to initiate the auction.
`bidfloor`	float	🔴 Required	Minimum bid for this impression expressed in CPM.	USD CPM.
`bidfloorcur`	string	🔴 Required	Currency specified using ISO-4217 alpha codes.
`secure`	integer	🔴 Required	Flag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure.
`exp`	integer	🔴 Required	Advisory as to the number of seconds that may elapse between the auction and the actual impression.
`instl`	integer	🔴 Required	1 = the ad is interstitial or full screen, 0 = not interstitial.
`rwdd`	integer	🔴 Required	Indicates whether the user receives a reward for viewing the ad, where 0 = no, 1 = yes.
`metric`	object array	🔴 Required	An array of Metric objects.	Exchange-provided metrics, for example estimated CTR.
`pmp`	object	⚪ Optional	A Pmp object containing any private marketplace deals in effect for this impression.	Deals the DSP is eligible for.
`ext.gpid` (Verve ext)	—	🔴 Required	Verve extension.	Global placement ID. Sent by default; taken from imp.tagid when the ad request has none.
`ext.tid` / `ext.tidt` (Verve ext)	—	⚪ Optional	Verve extension.	Impression-level transaction ID and its type. Sent to DSPs set up for transaction ID enrichment, on long-form video traffic.

Deal (4 fields)

Field	Type	Requirement	What it is
`id`	string	⚪ Optional	A unique identifier for the direct deal.
`bidfloor`	float	⚪ Optional	Minimum bid for this impression expressed in CPM.
`at`	integer	⚪ Optional	Optional override of the overall auction type of the bid request, where 1 = First Price, 2 = Second Price Plus.
`wseat`	string array	⚪ Optional	Allowed list of buyer seats allowed to bid on this deal.

Video (25 fields, 10 required)

Field	Type	Requirement	What it is	Brand+ rule
`mimes`	string array	🔴 Required	Content MIME types supported.
`minduration`	integer	🔴 Required	Minimum video ad duration in seconds. Mutually exclusive with rqddurs.
`maxduration`	integer	🔴 Required	Maximum video ad duration in seconds. Mutually exclusive with rqddurs.
`protocols`	integer array	🔴 Required	Array of supported video protocols. Refer to List: Creative Subtypes - Audio/Video in AdCOM 1.0.
`startdelay`	integer	🔴 Required	Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.
`linearity`	integer	🔴 Required	Indicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed.
`skip`	integer	🔴 Required	Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes.
`plcmt`	integer	🔴 Required	Video placement type for the impression. Refer to List: Plcmt Subtypes - Video in AdCOM 1.0.
`pos`	integer	🔴 Required	Ad position on screen. Refer to List: Placement Positions in AdCOM 1.0.	7 (full screen) for CTV.
`playbackend`	integer	🔴 Required	The event that causes playback to end. Refer to List: Playback Cessation Modes in AdCOM 1.0.
`w`	integer	⚪ Optional	Width of the video player in device-independent pixels (DIPS).
`h`	integer	⚪ Optional	Height of the video player in device-independent pixels (DIPS).
`placement`	integer	⚪ Optional	Deprecated as of OpenRTB 2.6-202303. Use plcmt instead.
`playbackmethod`	integer array	⚪ Optional	Playback methods that may be in use. If none are specified, any method may be used.
`delivery`	integer array	⚪ Optional	Supported delivery methods. If none is specified, assume all are supported.
`minbitrate`	integer	⚪ Optional	Minimum bit rate in Kbps.
`maxbitrate`	integer	⚪ Optional	Maximum bit rate in Kbps.
`battr`	integer array	⚪ Optional	Blocked creative attributes. Refer to List: Creative Attributes in AdCOM 1.0.
`boxingallowed`	integer	⚪ Optional	Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0 = no, 1 = yes.
`sequence`	integer	⚪ Optional	Deprecated as of OpenRTB 2.6. Use slotinpod.	Sent for ad pods.
`ext.podid` / `ext.podseq` / `ext.sequence` (Verve ext)	—	⚪ Optional	Verve extension.	podid and sequence are sent on every pod slot; podseq only when the publisher sends it.
`ext.slotinpod` (Verve ext)	—	⚪ Optional	The position in the pod that this slot’s bid is eligible for, from the publisher’s imp.video.slotinpod.	Sent only when the publisher’s ad request states a slot.
`ext.rqddurs` (Verve ext)	—	⚪ Optional	The exact creative durations the publisher accepts, from the publisher’s imp.video.rqddurs.	Sent only when the publisher sends rqddurs. minduration and maxduration are then narrowed to its lowest and highest values.
`ext.mincpmpersec` (Verve ext)	—	⚪ Optional	Minimum CPM per second of ad duration, from the publisher’s imp.video.mincpmpersec.	Sent only when the publisher sends it. Adjusted by Brand+ in the same way as imp.bidfloor.
`ext.durfloors` (Verve ext)	—	⚪ Optional	Floors by creative duration, from the publisher’s imp.video.durfloors: a list of duration bands, each with its own floor.	Sent only when the publisher sends them. Adjusted by Brand+ in the same way as imp.bidfloor.

App (7 fields, 6 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	Exchange-specific app ID.
`name`	string	🔴 Required	App name (may be aliased at the publisher’s request).
`bundle`	string	🔴 Required	The store ID of the app in an app store. See the OTT/CTV Store Assigned App Identification Guidelines.
`storeurl`	string	🔴 Required	App store URL for an installed app; for IQG 2.1 compliance.
`cat`	string array	🔴 Required	Array of IAB Tech Lab content categories of the app. The taxonomy is defined by the cattax field.
`domain`	string	⚪ Optional	Domain of the app.
`ext.inventorypartnerdomain` (Verve ext)	—	🔴 Required	Verve extension.	Sent by default.

Publisher (3 fields, 2 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	Exchange-specific seller ID. Corresponds to a seller_id in the exchange’s sellers.json file.	Brand+ publisher ID.
`name`	string	🔴 Required	Seller name (may be aliased at the seller’s request).
`domain`	string	⚪ Optional	Highest level domain of the seller.

Content (9 fields)

Field	Type	Requirement	What it is	Brand+ rule
`id` / `title` / `series` / `season`	string	⚪ Optional	Content ID, title, series and season.	Passed through from the publisher.
`genre`	string	⚪ Optional	Genre that best describes the content.
`cat` / `cattax`	string array / integer	⚪ Optional	Array of IAB Tech Lab content categories that describe the content, and the taxonomy in use.
`contentrating`	string	⚪ Optional	Content rating.
`language`	string	⚪ Optional	Content language using ISO-639-1-alpha-2.
`len`	integer	⚪ Optional	Length of content in seconds; appropriate for video or audio.
`livestream`	integer	⚪ Optional	Method of broadcast of the content: 0 = not scheduled (e.g. VOD or user-initiated), 1 = scheduled (linear viewing).
`prodq` / `context` / `producer`	integer / object	⚪ Optional	Production quality, type of content, and content producer.
`ext.network` / `ext.channel` (Verve ext)	—	⚪ Optional	Verve extension.	Kept for DSPs that read the 2.5 extensions.

Network (1 field)

Field	Type	Requirement	What it is	Brand+ rule
`name`	string	⚪ Optional	Network the content is on.	Filled from the publisher’s 2.5 ext.network when needed.

Channel (1 field)

Field	Type	Requirement	What it is	Brand+ rule
`name`	string	⚪ Optional	Channel the content is on.	Filled from the publisher’s 2.5 ext.channel when needed.

Device (14 fields, 8 required)

Field	Type	Requirement	What it is	Brand+ rule
`ua`	string	🔴 Required	Browser user agent string. This field represents a raw user agent string from the browser.	Privacy signals may remove or truncate device data.
`ifa`	string	🔴 Required	ID sanctioned for advertiser use in the clear (not hashed).
`ext.ifa_type` (Verve ext)	—	⚪ Optional	Verve extension.	Passed through when the publisher sends it.
`devicetype`	integer	🔴 Required	The general type of device. Refer to List: Device Types in AdCOM 1.0.
`make` / `model` / `os` / `osv`	string	🔴 Required	Device make, model, operating system and operating system version.
`lmt`	integer	🔴 Required	“Limit Ad Tracking” signal commercially endorsed, where 0 = tracking is unrestricted, 1 = tracking must be limited.
`dnt`	integer	🔴 Required	Standard “Do Not Track” flag, where 0 = tracking is unrestricted, 1 = do not track.
`language`	string	🔴 Required	Browser language using ISO-639-1-alpha-2.
`connectiontype`	integer	⚪ Optional	Network connection type. Refer to List: Connection Types in AdCOM 1.0.	Sent when present in the ad request or available from an IP lookup.
`ip`	string	⚪ Optional	IPv4 address closest to device.
`ipv6`	string	⚪ Optional	IP address closest to device as IPv6.
`dpidmd5` / `dpidsha1`	string	⚪ Optional	Deprecated as of OpenRTB 2.6.	Sent when present in the ad request. Kept for DSPs that still read them.
`didmd5` / `didsha1`	string	⚪ Optional	Deprecated as of OpenRTB 2.6.
`geo`	object	🔴 Required	Location of the device assumed to be the user’s current location, defined by a Geo object.	country, region, city, zip, lat, lon, type always; metro, accuracy, ipservice, utcoffset when available.

User (2 fields, 1 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	Exchange-specific ID for the user.	Brand+ user ID.
`eids`	object array	⚪ Optional	Details for support of a standard protocol for multiple third party identity providers.	Sent only to DSPs set up to receive extended IDs. Also sent as user.ext.eids.

Source (4 fields, 4 required)

Field	Type	Requirement	What it is	Brand+ rule
`fd`	integer	🔴 Required	Entity responsible for the final impression sale decision, where 0 = exchange, 1 = upstream source.
`tid`	string	🔴 Required	Transaction ID that must be common across all participants in this bid request.
`pchain`	string	🔴 Required	Payment ID chain string containing embedded syntax described in the TAG payment ID Protocol v1.0.
`ext.schain`	—	🔴 Required	2.5 location of the IAB SupplyChain object (2.6: source.schain).	Supply chain with the Brand+ node appended, sent as a JSON-encoded string. Also sent as ext.schain at the top level.

Regs (3 fields, 2 required)

Field	Type	Requirement	What it is	Brand+ rule
`coppa`	integer	🔴 Required	Flag indicating if this request is subject to the COPPA regulations established by the USA FTC, where 0 = no, 1 = yes.
`gpp` / `gpp_sid`	string / integer array	⚪ Optional	The Global Privacy Platform’s consent string, and the section(s) that apply.
`ext.gdpr` / `ext.consent` / `ext.us_privacy`	—	🔴 Required	2.5 locations of the IAB regs.gdpr, user.consent and regs.us_privacy fields.	gdpr and consent always; us_privacy when available.

_{Back to top}

3.3 Bid response

To pass on a request, omit seatbid or return HTTP 204. Brand+ requires VAST in adm; markup on the win notice is not used.

Sample: bid response

{
  "id": "b1b2c3d4000000000000000000000001",
  "bidid": "dsp-response-0001",
  "seatbid": [
    {
      "seat": "<DSP_SEAT_ID>",
      "bid": [
        {
          "id": "dsp-bid-0001",
          "impid": "b1b2c3d4-0000-0000-0000-000000000002",
          "price": 12.5,
          "adid": "<CREATIVE_ID>",
          "nurl": "https://dsp.example/win?price=${AUCTION_PRICE}",
          "burl": "https://dsp.example/bill?price=${AUCTION_PRICE}",
          "adm": "<VAST version=\"3.0\"><Ad id=\"dsp-bid-0001\"><InLine><AdSystem>Example DSP</AdSystem><AdTitle><![CDATA[Example Ad]]></AdTitle><Impression><![CDATA[https://dsp.example/imp]]></Impression><Creatives><Creative><Linear><Duration>00:00:30.000</Duration><MediaFiles><MediaFile delivery=\"progressive\" width=\"1920\" height=\"1080\" type=\"video/mp4\" bitrate=\"3500\"><![CDATA[https://cdn.dsp.example/ad_1920x1080.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>",
          "adomain": ["advertiser.example"],
          "bundle": "<ADVERTISER_APP_BUNDLE>",
          "iurl": "https://cdn.dsp.example/companion_1280x720.jpeg",
          "cid": "<CAMPAIGN_ID>",
          "crid": "<CREATIVE_ID>",
          "cat": ["IAB9-30"],
          "w": 1280,
          "h": 720,
          "mtype": 2,
          "ext": {}
        }
      ]
    }
  ],
  "cur": "USD"
}

Field reference

Expand an object to see its fields.

Required at a glance: BidResponse.id, BidResponse.seatbid, SeatBid.bid, Bid.id, Bid.impid, Bid.price, Bid.adm

BidResponse (5 fields, 2 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	ID of the bid request to which this is a response.	Echo the bid request id.
`seatbid`	object array	🔴 Required to bid	Array of seatbid objects; 1+ required if a bid is to be made.	For no bid, omit or return HTTP 204.
`bidid`	string	🔵 Recommended	Bidder generated response ID to assist with logging/tracking.
`cur`	string	⚪ Optional	Bid currency using ISO-4217 alpha codes.	Use USD.
`nbr`	integer	⚪ Optional	Reason for not bidding. Refer to List: No-Bid Reason Codes in OpenRTB 3.0.

SeatBid (3 fields, 1 required)

Field	Type	Requirement	What it is	Brand+ rule
`bid`	object array	🔴 Required	Array of 1+ Bid objects, each related to an impression.
`seat`	string	⚪ Optional	ID of the buyer seat on whose behalf this bid is made.	Required when the deal restricts seats (wseat).
`group`	integer	⚪ Optional	0 = impressions can be won individually; 1 = impressions must be won or lost as a group.

Bid (24 fields, 4 required)

Field	Type	Requirement	What it is	Brand+ rule
`id`	string	🔴 Required	Bidder generated bid ID to assist with logging/tracking.
`impid`	string	🔴 Required	ID of the Imp object in the related bid request.
`price`	float	🔴 Required	Bid price expressed as CPM although the actual transaction is for a unit impression only.	USD CPM, at or above the floor.
`adm`	string	🔴 Required	Optional means of conveying ad markup in case the bid wins; supersedes the win notice if markup is included in both.	Brand+ requires VAST in adm; markup on the win notice is not used. Brand+ reads VAST version, companions and duration from it.
`dealid`	string	⚪ Optional	Reference to the deal.id from the bid request if this bid pertains to a private marketplace direct deal.	Required when bidding on a deal.
`adomain`	string array	🔵 Recommended	Advertiser domain for block list checking.	Used for advertiser blocking.
`crid`	string	🔵 Recommended	Creative ID to assist with ad quality checking.
`cid`	string	🔵 Recommended	Campaign ID to assist with ad quality checking.
`cat`	string array	🔵 Recommended	IAB Tech Lab content categories of the creative. The taxonomy is defined by the cattax field.
`cattax`	integer	🔵 Recommended	The taxonomy in use. Refer to List: Category Taxonomies.
`nurl`	string	🔵 Recommended	Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad).
`burl`	string	🔵 Recommended	Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy.
`lurl`	string	⚪ Optional	Loss notice URL called by the exchange when a bid is known to have been lost.
`dur`	integer	🔵 Recommended	Duration of the video or audio creative in seconds.	Used when the VAST has no duration, and for pods.
`mtype`	integer	🔵 Recommended	Type of the creative markup: 1 = Banner, 2 = Video, 3 = Audio, 4 = Native.	Use 2 for video.
`slotinpod`	integer	⚪ Optional	Indicates that the bid response is only eligible for a specific position within a video or audio ad pod.
`adid`	string	⚪ Optional	ID of a preloaded ad to be served if the bid wins.
`iurl`	string	⚪ Optional	URL without cache-busting to an image that is representative of the content of the campaign, for ad quality/safety checking.
`bundle`	string	⚪ Optional	The store ID of the app in an app store.
`attr`	integer array	⚪ Optional	Set of attributes describing the creative. Refer to List: Creative Attributes in AdCOM 1.0.
`apis`	integer array	⚪ Optional	List of supported APIs for the markup. If an API is not explicitly listed, it is assumed to be unsupported.
`w` / `h`	integer	⚪ Optional	Width and height of the creative in device-independent pixels (DIPS).
`exp`	integer	⚪ Optional	Advisory as to the number of seconds the bidder is willing to wait between the auction and the actual impression.
`ext.imptrackers` (Verve ext)	—	⚪ Optional	Verve extension.	Brand+ fires these on impression.

_{Back to top}

4. Ad pods

A pod is one ad break filled with several ads. Publishers describe the whole break in one ad request; Brand+ auctions each slot separately and returns the winning ads together.

flowchart LR
    R["Ad request<br/>one impression<br/>podid, poddur, maxseq"] --> B["Brand+<br/>splits into slots"]
    B --> S1["Slot 1<br/>2.5 bid request"]
    B --> S2["Slot 2<br/>2.5 bid request"]
    B --> S3["Slot 3<br/>2.5 bid request"]
    S1 --> D["DSPs"]
    S2 --> D
    S3 --> D
    D -.-> A["Ad response<br/>one Bid per winning ad<br/>with podid and dur"]

How Brand+ reads your pod

You send	Brand+ creates
`maxseq`	That many slots, up to 20. Larger pods are cut to 20, not rejected.
`poddur` without `maxseq`	5 slots
Neither	1 slot

Missing value	Brand+ assumes
Pod duration (`poddur`)	120 seconds
A slot’s maximum ad duration (`maxduration`)	31 seconds

Slot floor: Brand+ uses the first of these that you send:

imp.bidfloor
the lowest durfloors band that overlaps the slot’s durations
mincpmpersec × the slot’s shortest ad duration

Where both are sent, native 2.6 pod fields take precedence over their ext equivalents.

Pod fields by version

Pod detail	OpenRTB 2.6	OpenRTB 2.5
Identify the pod	`imp.video.podid` on every impression in the break	`imp.video.ext.podid` on every impression in the break
Dynamic pod length and ad count	`maxseq` and `poddur`	`imp.video.ext.maxseq` and `imp.video.ext.poddur`
Ad durations	`minduration` and `maxduration`, or `rqddurs` for exact durations	`minduration` and `maxduration`
Pod position in the content	`podseq`	`imp.video.ext.podseq`
Optional	`slotinpod`, `mincpmpersec`, `durfloors`	`imp.video.ext.slotinpod`, `ext.mincpmpersec`, `ext.durfloors`. Use 2.6 for these.

What DSPs receive

One OpenRTB 2.5 bid request per slot, with the slot’s duration limits and floor. Pod fields are in imp.video.ext: podid and sequence on every slot (sequence also as imp.video.sequence), and slotinpod, podseq, rqddurs, mincpmpersec and durfloors only when the publisher sent them. poddur and maxseq are never sent to DSPs. When the request has rqddurs, the outgoing minduration and maxduration narrow to its lowest and highest values.

What publishers get back

Each winning ad is a separate Bid on the impression it fills, carrying podid and dur. In a dynamic pod, all winning ads share that impression’s impid. 2.6 publishers get bid.podid and bid.ext.podid; 2.5 publishers get bid.ext.podid only. dur is also sent as bid.ext.duration; both are left out when neither the bid nor its VAST gives a duration. slotinpod comes back only where the request stated a slot.

[!WARNING]
Check dur before placing an ad. Brand+ ranks bids in a slot by price per second rather than total price, and can move a runner-up into a slot that received no bids. It doesn’t reject a bid whose duration is outside the slot’s limits, doesn’t order the ads, and doesn’t keep same-advertiser ads out of adjacent slots. Your ad server places the winning ads in the break.

_{Back to top}

5. Where fields go in 2.5 vs 2.6

Signal	OpenRTB 2.5	OpenRTB 2.6

_{Back to top}

6. Macros and tracking

Macro	Replaced with
`${AUCTION_PRICE}`	Clearing price, in the response currency
`${AUCTION_MIN_TO_WIN}`	Minimum bid that would have won
`${AUCTION_LOSS}`	OpenRTB loss reason code
`[ERRORCODE]`	VAST error code, in VAST Error URLs

URL	When to fire
`nurl`	When the bid wins the auction
`burl`	When the impression is billable
`lurl`	When the bid loses
VAST Impression, Error and tracking URLs	As the video plays, per the VAST standard

_{Back to top}

7. Enum reference

device.devicetype

Value	Meaning
`1`	Mobile/Tablet
`2`	PC
`3`	Connected TV
`4`	Phone
`5`	Tablet
`6`	Connected device
`7`	Set-top box
`8`	Out-of-home

imp.video.plcmt

Value	Meaning
`1`	In-stream
`2`	Accompanying content
`3`	Interstitial
`4`	No content / standalone

imp.video.protocols

Value	Meaning
`1`	VAST 1.0
`2`	VAST 2.0
`3`	VAST 3.0
`4`	VAST 1.0 Wrapper
`5`	VAST 2.0 Wrapper
`6`	VAST 3.0 Wrapper
`7`	VAST 4.0
`8`	VAST 4.0 Wrapper

imp.video.startdelay

Value	Meaning
`> 0`	Mid-roll at that many seconds
`0`	Pre-roll
`-1`	Generic mid-roll
`-2`	Generic post-roll

imp.ssai

Value	Meaning
`0`	Unknown
`1`	All client-side
`2`	Assets stitched server-side, tracking client-side
`3`	All server-side

device.connectiontype

Value	Meaning
`0`	Unknown
`1`	Ethernet
`2`	Wi-Fi
`3`	Cellular (unknown generation)
`4`	2G
`5`	3G
`6`	4G
`7`	5G

bid.mtype

Value	Meaning
`1`	Banner
`2`	Video
`3`	Audio
`4`	Native

_{Back to top}

8. Troubleshooting

Publishers and SSPs

My ad request gets HTTP 422

Brand+ rejects the request when regs.coppa is 1, when there’s no usable public IP (device.ip, device.ipv6 and the connection’s IP are all missing, private or reserved), or when the user is under 14.

My request is rejected and I send cur

If you send cur, it must include USD. Add USD or leave cur out.

My 2.5 or 2.6 fields seem to be ignored

Check the x-openrtb-version header. Without it, the request is processed as OpenRTB 2.3. Also check fields are where your version expects them; see 2.5 vs 2.6.

I sent a pod but get only one ad back

Identify the pod with imp.video.podid (2.6) or imp.video.ext.podid (2.5); sequence doesn’t identify a pod. Send maxseq, poddur or both: with neither, the pod has one slot.

An ad is longer than my slot allows

Brand+ doesn’t reject bids for duration. Check bid.dur (or bid.ext.duration) before placing each ad.

Deal IDs are missing from the ad response

Deal ID pass-back is enabled per account. Ask your Verve account manager.

DSPs

We get no traffic from a region

Each region sends only to its own registered endpoint. Register one for every region you want to buy in.

Our bid won but the ad didn’t render

Brand+ requires VAST in bid.adm. Markup returned on the win notice isn’t used.

We don’t see extended IDs (eids)

user.eids is sent only to DSPs set up to receive extended IDs. Ask your account manager.

Our deal bids are rejected

Include dealid when bidding on a deal, include seat when the deal restricts seats with wseat, and bid at or above the floor in USD CPM.

_{Back to top}

9. Glossary

Term	Meaning

| Ad pod | One ad break filled with several ads in a row, described in a single ad request. A dynamic pod lets the auction decide how many ads fill the break, up to a total duration (poddur) and ad count (maxseq). |
| AdBreak ID | Your Brand+ (SPX) identifier for an ad placement. Sent in imp.tagid. |
| Brand+ (B+) | Verve’s marketplace for brand and CTV advertising. |
| CPM | Cost per mille: the price for 1,000 impressions. Brand+ prices and floors are USD CPM. |
| CTV | Connected TV: video watched on a TV through an internet-connected device, such as a smart TV, Roku or other streaming player. |
| DSP | Demand-side platform: the system advertisers use to bid on impressions. |
| First-price auction | The highest bidder wins and pays its own bid. Brand+ runs first-price auctions only (at = 1). |
| Floor | The minimum price a bid must meet, set in imp.bidfloor or, for pods, durfloors and mincpmpersec. |
| IFA | Identifier for advertising: the device’s resettable advertising ID, such as Roku’s RIDA or Samsung’s TIFA. Its type goes in device.ext.ifa_type. |
| Inventory partner domain | The domain of the partner whose app-ads.txt authorises selling the app’s inventory. |
| OpenRTB | The IAB Tech Lab protocol for real-time bidding. Brand+ supports versions 2.5 and 2.6. |
| SSAI | Server-side ad insertion: ads are stitched into the video stream on a server rather than played by the device. imp.ssai says where ad events fire. |
| SSP | Supply-side platform: the system publishers use to sell their inventory. |
| Supply chain (schain) | A list of every company that handled the request on its way to the buyer. Brand+ appends its own node before sending to DSPs. |
| tmax | The time, in milliseconds, allowed for a response to a request. |
| VAST | Video Ad Serving Template: the XML format that carries a video ad’s media files and tracking URLs. |
| VAST InLine and Wrapper | An InLine VAST contains the ad itself. A Wrapper VAST points to another VAST elsewhere, adding its own tracking along the way. |

_{Back to top}

_{Based on the IAB OpenRTB 2.6 specification. Questions: contact your Verve account manager.}

Connect CTV supply and demand to Brand+

Verve Brand+ CTV integration guide

Start here

Contents

1. How a CTV ad moves through Brand+

2. Supply partners

2.1 Setup

2.2 Ad request

Field reference

2.3 Ad response

Field reference

3. Demand partners

3.1 Setup

3.2 Bid request

Field reference

3.3 Bid response

Field reference

4. Ad pods

How Brand+ reads your pod

Pod fields by version

What DSPs receive

What publishers get back

5. Where fields go in 2.5 vs 2.6

6. Macros and tracking

7. Enum reference

8. Troubleshooting

9. Glossary