# Integration Document RTB

## <mark style="color:blue;">Specification for Integration with SSP’s/DSP’s</mark> <a href="#title-text" id="title-text"></a>

**Overview**

DTXplatform  is a modern real-time bidding system that allows buyers to make purchases automatically when searching for advertising resources.

Its interface is implemented as per the IAB’s OpenRTB Specification Version 2.5 and uses JSON as its message format \[Content-Type: application/json; charset=UTF-8].

**Open RTB Version HTTP Header**

We support Open RTB 2.5 by default, but we can also support 2.4, 2.3, 2.0, and 1.0 versions for specific integrations.

Default header is \[x-openrtb-version: 2.5].

**Transport**

By default, all calls should return HTTP code 200 with body containing bid response in JSON format. For “no bid” response, the call should return HTTP code 204 with empty body.

We can also support other options for specific integrations, like HTTP code 200 with empty body, or with body containing “nobid” message.

**Data format**

By default, JSON (JavaScript Object Notation) supported for bid request and bid response data payloads. We can support other data format for specific integrations. Default header: Content-Type: application/JSON header.

**Accordance with IAB Specifications and Guidelines**

We work in accordance with IAB Specifications available here:

[https://www.iab.com/wp-content/uploads/2016/01/OpenRTB-API-Specification-Version-2-4-DRA](https://www.iab.com/wp-content/uploads/2016/01/OpenRTB-API-Specification-Version-2-4-DRAFT.pdf) [FT.pdf](https://www.iab.com/wp-content/uploads/2016/01/OpenRTB-API-Specification-Version-2-4-DRAFT.pdf)\
<https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf>

## **Bid Request** <a href="#bid-request" id="bid-request"></a>

DTXplatform sends a Bid Request when an image becomes visible within the browser. The following table describes the fields and objects in the BidRequest message.\ <br>

| **Attribute**                  | **Type**                                  | **Description**                                                                                                                                                                                                                                                                                                                |
| ------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id                             | string; required                          | Unique ID of the bid request, provided by the exchange.                                                                                                                                                                                                                                                                        |
| imp                            | <p>object array;</p><p>required</p>       | Array with 1 Imp object.                                                                                                                                                                                                                                                                                                       |
| <p><br><br></p><p>site</p>     | object; required                          | Details via a Site object about the publisher’s website. Only applicable and required for websites.                                                                                                                                                                                                                            |
| <p><br><br></p><p>app</p>      | <p><br><br></p><p>object; required</p>    | Details via an App object about the publisher’s app (i.e., non-browser applications). Only applicable and required for apps.                                                                                                                                                                                                   |
| <p><br><br></p><p>device</p>   | object; required                          | Details via a Device object about the user’s device to which the impression will be delivered.                                                                                                                                                                                                                                 |
| <p><br><br></p><p>user</p>     | object; recommended                       | Details via a User object about the human user of the device; the advertising audience.                                                                                                                                                                                                                                        |
| <p><br><br></p><p>test</p>     | integer; default 0                        | <p>Indicator of test mode in which auctions are not billable,</p><p>where 0 = live mode, 1 = test mode.</p>                                                                                                                                                                                                                    |
| <p><br><br></p><p>at</p>       | <p><br><br></p><p>integer; default 2</p>  | <p>Auction type, where 1 = First Price, 2 = Second Price Plus.</p><p>Exchange-specific auction types can be defined using values greater than 500.</p>                                                                                                                                                                         |
| <p><br><br></p><p>tmax</p>     | <p><br><br></p><p>integer</p>             | Maximum time in milliseconds to submit a bid to avoid timeout. This value is commonly communicated offline.                                                                                                                                                                                                                    |
| <p> </p><p> </p><p>wseat</p>   | <p> </p><p> </p><p>string array</p>       | <p>Whitelist of buyer seats (e.g., advertisers, agencies) allowed to bid on this impression. IDs of seats and knowledge of the buyer’s customers to which they refer must be coordinated between bidders and the exchange <em>a priori</em>.</p><p>Omission implies no seat restrictions.</p>                                  |
| <p> </p><p> </p><p>allimps</p> | <p> </p><p> </p><p>integer; default 0</p> | <p>Flag to indicate if Exchange can verify that the impressions offered represent all of the impressions available in context (e.g., all on the web page, all video spots such as pre/mid/post roll) to support road-blocking. 0 = no or unknown, 1 =</p><p>yes, the impressions offered represent all that are available.</p> |
| <p> </p><p>cur</p>             | <p> </p><p>string array</p>               | Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes. Recommended only if the exchange accepts multiple currencies.                                                                                                                                                                             |
| bcat                           | string array                              | Blocked advertiser categories using the IAB content categories.                                                                                                                                                                                                                                                                |
| badv                           | string array                              | Block list of advertisers by their domains (e.g., “[http://ford.com](http://ford.com/) ”).                                                                                                                                                                                                                                     |
| <p> </p><p>bapp</p>            | <p> </p><p>string array</p>               | Block list of applications by their platform-specific exchange independent application identifiers. On Android, these should be bundle or package names (e.g., com.foo.mygame). On iOS, these are numeric IDs.                                                                                                                 |
| <p> </p><p>regs</p>            | <p> </p><p>object</p>                     | A Regs object that specifies any industry, legal, or governmental regulations in force for this request.                                                                                                                                                                                                                       |
| ext                            | object                                    | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                                                                                                                                        |

&#x20;

**Impression**\ <br>

| **Attribute**                       | **Type**                                   | **Description**                                                                                                                                                                                                                                |
| ----------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><br><br></p><p>id</p>            | <p><br><br></p><p>string</p>               | A unique identifier for this impression within the context of the bid request (typically, starts with 1 and increments.                                                                                                                        |
| <p><br><br></p><p>banner</p>        | <p><br><br></p><p>object</p>               | A Banner object; required if this impression is offered as a banner ad opportunity.                                                                                                                                                            |
| video                               | object                                     | A Video object; required if this impression is offered as a video ad opportunity.                                                                                                                                                              |
| <p><br><br></p><p>native</p>        | <p><br><br></p><p>object</p>               | A Native object; required if this impression is offered as a native ad opportunity.                                                                                                                                                            |
| <p> </p><p>displaymanager</p>       | <p> </p><p>string</p>                      | <p>Name of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner.</p><p>Recommended for video and/or apps.</p>                     |
| <p> </p><p>displaymanagerver</p>    | <p> </p><p>string</p>                      | <p>Version of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner.</p><p>Recommended for video and/or apps.</p>                  |
| instl                               | integer; default 0                         | 1 = the ad is interstitial or full screen, 0 = not interstitial                                                                                                                                                                                |
| <p> </p><p>tagid</p>                | <p> </p><p>string</p>                      | Identifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer.                                                                        |
| bidfloor                            | float; default 0                           | Minimum bid for this impression expressed in CPM.                                                                                                                                                                                              |
| <p> </p><p>bidfloorcur</p>          | <p> </p><p>string;</p><p>default “USD”</p> | Currency specified using ISO-4217 alpha codes. This may be different from bid currency returned by bidder if this is allowed by the exchange.                                                                                                  |
| <p> </p><p> </p><p>clickbrowser</p> | <p> </p><p> </p><p>integer</p>             | <p>Indicates the type of browser opened upon clicking the creative in an app, where 0 = embedded, 1 = native.</p><p>Note that the Safari View Controller in iOS 9.x devices is considered a native browser for purposes of this attribute.</p> |
| <p> </p><p> </p><p>secure</p>       | <p> </p><p> </p><p>integer</p>             | <p>Flag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure.</p><p>If omitted, the secure state is unknown, but non-secure HTTP support can be assumed.</p>                   |
| iframebuster                        | string array                               | Array of exchange-specific names of supported iframe busters.                                                                                                                                                                                  |
| ext                                 | object                                     | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                                                        |

&#x20;

**Banner**\ <br>

| **Attribute**              | **Type**                                  | **Description**                                                                                                                                                                                                                                |
| -------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p> </p><p>w</p>           | <p><br><br></p><p>integer; required</p>   | <p>Width in device independent pixels (DIPS).</p><p>If no format objects are specified, this is an exact width requirement. Otherwise it is a preferred width.</p>                                                                             |
| <p> </p><p>h</p>           | <p> </p><p>integer; required</p>          | <p>Height in device independent pixels (DIPS).</p><p>If no format objects are specified, this is an exact height requirement. Otherwise it is a preferred height.</p>                                                                          |
| <p> </p><p>format</p>      | <p> </p><p>object array</p>               | Array of format objects representing the banner sizes permitted. If none are specified, then use of the h and w attributes is highly recommended.                                                                                              |
| <p><br><br></p><p>wmax</p> | <p><br><br></p><p>integer; DEPRECATED</p> | <p><em>NOTE: Deprecated in favor of the format array.</em></p><p>Maximum width in device independent pixels (DIPS).</p>                                                                                                                        |
| <p> </p><p>hmax</p>        | <p><br><br></p><p>integer; DEPRECATED</p> | <p><em>NOTE: Deprecated in favor of the format array.</em></p><p>Maximum height in device independent pixels (DIPS).</p>                                                                                                                       |
| <p><br><br></p><p>wmin</p> | <p><br><br></p><p>integer; DEPRECATED</p> | <p><em>NOTE: Deprecated in favor of the format array.</em></p><p>Minimum width in device independent pixels (DIPS).</p>                                                                                                                        |
| <p> </p><p>hmin</p>        | <p><br><br></p><p>integer; DEPRECATED</p> | <p><em>NOTE: Deprecated in favor of the format array.</em></p><p>Minimum height in device independent pixels (DIPS).</p>                                                                                                                       |
| <p> </p><p>id</p>          | <p> </p><p>string</p>                     | Unique identifier for this banner object. Recommended when Banner objects are used with a Video object to represent an array of companion ads. Values usually start at 1 and increase with each object; should be unique within an impression. |
| btype                      | integer array                             | Blocked banner ad types.                                                                                                                                                                                                                       |
| battr                      | integer array                             | Blocked creative attributes.                                                                                                                                                                                                                   |
| pos                        | integer                                   | Ad position on screen.                                                                                                                                                                                                                         |
| <p> </p><p>mimes</p>       | <p> </p><p>string array</p>               | <p>Content MIME types supported. Popular MIME types may include</p><p>“application/x-shockwave-flash”, “image/jpg”, and “image/gif”.</p>                                                                                                       |
| <p> </p><p>topframe</p>    | <p> </p><p>integer</p>                    | <p>Indicates if the banner is in the top frame as opposed to an iframe, where 0 = no, 1</p><p>= yes.</p>                                                                                                                                       |
| expdir                     | integer array                             | Directions in which the banner may expand.                                                                                                                                                                                                     |
| <p> </p><p>api</p>         | <p> </p><p>integer array</p>              | List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported.                                                                                                                   |
| ext                        | object                                    | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                                                        |

&#x20;

**Video**

| **Attribute**                              | **Type**                                         | **Description**                                                                                                                                                                                                                                                                             |
| ------------------------------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><br><br></p><p>mimes</p>                | <p><br><br></p><p>string array; required</p>     | <p>Content MIME types supported. Popular MIME types may include</p><p>“video/x-ms-wmv” for Windows Media and “video/x-flv” for Flash Video.</p>                                                                                                                                             |
| minduration                                | integer; recommended                             | Minimum video ad duration in seconds.                                                                                                                                                                                                                                                       |
| <p><br><br></p><p>maxduration</p>          | integer; recommended                             | Maximum video ad duration in seconds.                                                                                                                                                                                                                                                       |
| <p><br><br></p><p>protocols</p>            | <p><br><br></p><p>integer array; recommended</p> | Array of supported video protocols. At least one supported protocol must be specified in either the protocol or protocols attribute.                                                                                                                                                        |
| <p> </p><p>protocol</p>                    | <p><br><br></p><p>integer; DEPRECATED</p>        | *NOTE: Deprecated in favor of protocols.* Supported video protocol. At least one supported protocol must be specified in either the protocol or protocols attribute.                                                                                                                        |
| 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).                                                                                                                                                                                                                             |
| <p> </p><p>startdelay</p>                  | integer; recommended                             | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.                                                                                                                                                                                                    |
| <p> </p><p>linearity</p>                   | <p> </p><p>integer</p>                           | Indicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed.                                                                                                                                                                                      |
| <p> </p><p>skip</p>                        | <p> </p><p>integer</p>                           | <p>Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes.</p><p>If a bidder sends markup/creative that is itself skippable, the Bid object should include the attr array with an element of 16 indicating skippable video.</p>                                  |
| <p> </p><p>skipmin</p>                     | integer; default 0                               | Videos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable.                                                                                                                                                                      |
| <p> </p><p>skipafter</p>                   | integer; default 0                               | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable.                                                                                                                                                                                     |
| <p> </p><p>sequence</p>                    | <p> </p><p>integer</p>                           | If multiple ad impressions are offered in the same bid request the sequence number will allow for the coordinated delivery of multiple creatives.                                                                                                                                           |
| battr                                      | integer array                                    | Blocked creative attributes.                                                                                                                                                                                                                                                                |
| <p> </p><p> </p><p> </p><p>maxextended</p> | <p> </p><p> </p><p> </p><p>integer</p>           | Maximum extended ad duration if extension is allowed. If blank or 0, extension is not allowed. If -1, extension is allowed, and there is no time limit imposed. If greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value. |
| minbitrate                                 | integer                                          | Minimum bit rate in Kbps.                                                                                                                                                                                                                                                                   |
| maxbitrate                                 | integer                                          | Maximum bit rate in Kbps.                                                                                                                                                                                                                                                                   |
| <p> </p><p>boxingallowed</p>               | integer; default 1                               | Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0 = no, 1 = yes.                                                                                                                                                                                             |
| <p> </p><p> </p><p>playbackmethod</p>      | <p> </p><p> </p><p>integer array</p>             | Playback methods that may be in use. If none are specified, any method may be used. Only one method is typically used in practice. As a result, this array may be converted to an integer in a future version of the specification.                                                         |
| <p> </p><p>delivery</p>                    | <p> </p><p>integer array</p>                     | Supported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported.                                                                                                                                                                                     |
| pos                                        | integer                                          | Ad position on screen.                                                                                                                                                                                                                                                                      |
| companionad                                | object array                                     | Array of Banner objects if companion ads are availabl&#x65;**.**                                                                                                                                                                                                                            |
| <p> </p><p>api</p>                         | <p> </p><p>integer array</p>                     | List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported.                                                                                                                                                                |
| <p> </p><p>companiontype</p>               | <p> </p><p>integer array</p>                     | Supported VAST companion ad types. Recommended if companion Banner objects are included via the companionad array.                                                                                                                                                                          |
| ext                                        | object                                           | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                                                                                                     |

&#x20;

**Native**

| **Attribute**             | **Type**                                  | **Description**                                                                                                                                 |
| ------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| request                   | string; required                          | Request payload complying with the Native Ad Specification.                                                                                     |
| <p><br><br></p><p>ver</p> | <p><br><br></p><p>string; recommended</p> | Version of the Dynamic Native Ads API to which request complies; highly recommended for efficient parsing.                                      |
| <p><br><br></p><p>api</p> | <p><br><br></p><p>integer array</p>       | List of supported API frameworks for this impression. Refer to List 5.6. If an API is not explicitly listed, it is assumed not to be supported. |
| battr                     | integer array                             | Blocked creative attributes.                                                                                                                    |
| <p><br><br></p><p>ext</p> | <p><br><br></p><p>object</p>              | Placeholder for exchange-specific extensions to OpenRTB                                                                                         |

**Audio**

| **Attribute** | **Type**               | **Description**                                                                                                                                 |
| ------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| mimes         | string array; required | <p>Content MIME types supported. Popular MIME types may include</p><p>“video/x-ms-wmv” for Windows Media and “video/x-flv” for Flash Video.</p> |
| minduration   | integer; recommended   | Minimum audio ad duration in seconds.                                                                                                           |
| maxduration   | integer; recommended   | Maximum audio ad duration in seconds.                                                                                                           |
| protocols     | integer; DEPRECATED    | Array of supported video protocols. At least one supported protocol must be specified in either the protocol or protocols attribute.            |
| startdelay    | integer; recommended   | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements.                                                        |
| minbitrate    | integer                | Minimum bit rate in Kbps.                                                                                                                       |
| maxbitrate    | integer                | Maximum bit rate in Kbps.                                                                                                                       |
| api           | integer array          | List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported.                    |

**Site**

| **Attribute**                 | **Type**                               | **Description**                                                                                                    |
| ----------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| id                            | string; recommended                    | Exchange-specific site ID.                                                                                         |
| name                          | string                                 | Site name (may be aliased at the publisher’s request).                                                             |
| <p><br><br></p><p>domain</p>  | <p><br><br></p><p>string; required</p> | Domain of the site (e.g., “[http://mysite.foo.com](http://mysite.foo.com/) ”).                                     |
| cat                           | string array                           | Array of IAB content categories of the site.                                                                       |
| sectioncat                    | string array                           | Array of IAB content categories that describe the current section of the site.                                     |
| <p><br><br></p><p>pagecat</p> | <p><br><br></p><p>string array</p>     | Array of IAB content categories that describe the current page or view of the site.                                |
| <p><br><br></p><p>page</p>    | <p><br><br></p><p>string</p>           | URL of the page where the impression will be shown.                                                                |
| <p><br><br></p><p>ref</p>     | <p><br><br></p><p>string</p>           | Referrer URL that caused navigation to the current page.                                                           |
| search                        | string                                 | Search string that caused navigation to the current page.                                                          |
| <p> </p><p>mobile</p>         | <p> </p><p>integer</p>                 | Indicates if the site has been programmed to optimize layout when viewed on mobile devices, where 0 = no, 1 = yes. |
| privacypolicy                 | integer                                | Indicates if the site has a privacy policy, where 0 = no, 1 = yes.                                                 |
| publisher                     | object                                 | Details about the Publisher of the site.                                                                           |
| content                       | object                                 | Details about the Content within the site.                                                                         |
| keywords                      | string                                 | Comma separated list of keywords about the site.                                                                   |
| <p><br><br></p><p>ext</p>     | <p><br><br></p><p>object</p>           | Placeholder for exchange-specific extensions to OpenRTB                                                            |

&#x20;

**Device**

| **Attribute**                  | **Type**                                   | **Description**                                                                                                                                                    |
| ------------------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ua                             | string; required                           | Browser user agent string.                                                                                                                                         |
| <p><br><br></p><p>geo</p>      | object; recommended                        | Location of the device assumed to be the user’s current location defined by a Geo object.                                                                          |
| <p><br><br></p><p>dnt</p>      | integer; recommended                       | Standard “Do Not Track” flag as set in the header by the browser, where 0 = tracking is unrestricted, 1 = do not track.                                            |
| <p> </p><p>lmt</p>             | <p><br><br></p><p>integer; recommended</p> | “Limit Ad Tracking” signal commercially endorsed (e.g., iOS, Android), where 0 = tracking is unrestricted, 1 = tracking must be limited per commercial guidelines. |
| ip                             | string; required                           | IPv4 address closest to device.                                                                                                                                    |
| ipv6                           | string                                     | IP address closest to device as IPv6.                                                                                                                              |
| devicetype                     | integer                                    | The general type of device.                                                                                                                                        |
| make                           | string                                     | Device make (e.g., “Apple”).                                                                                                                                       |
| <p><br><br></p><p>model</p>    | string                                     | Device model (e.g., “iPhone”).                                                                                                                                     |
| os                             | string                                     | Device operating system (e.g., “iOS”).                                                                                                                             |
| osv                            | string                                     | Device operating system version (e.g., “3.1.2”).                                                                                                                   |
| hwv                            | string                                     | Hardware version of the device (e.g., “5S” for iPhone 5S).                                                                                                         |
| h                              | integer                                    | Physical height of the screen in pixels.                                                                                                                           |
| w                              | integer                                    | Physical width of the screen in pixels.                                                                                                                            |
| ppi                            | integer                                    | Screen size as pixels per linear inch.                                                                                                                             |
| pxratio                        | float                                      | The ratio of physical pixels to device independent pixels.                                                                                                         |
| js                             | integer                                    | Support for JavaScript, where 0 = no, 1 = yes.                                                                                                                     |
| <p><br><br></p><p>geofetch</p> | <p><br><br></p><p>integer</p>              | Indicates if the geolocation API will be available to JavaScript code running in the banner, where 0 = no, 1 = yes.                                                |
| <p><br><br></p><p>flashver</p> | <p><br><br></p><p>string</p>               | Version of Flash supported by the browser.                                                                                                                         |
| language                       | string                                     | Browser language using ISO-639-1-alpha-2.                                                                                                                          |
| <p> </p><p>carrier</p>         | <p> </p><p>string</p>                      | <p>Carrier or ISP (e.g., “VERIZON”). “WIFI”</p><p>is often used in mobile to indicate high bandwidth (e.g., video friendly vs. cellular).</p>                      |
| connectiontype                 | integer                                    | Network connection type.                                                                                                                                           |
| ifa                            | string; recommended                        | ID sanctioned for advertiser use in the clear (i.e., not hashed); required for apps.                                                                               |
| <p> </p><p>ext</p>             | <p> </p><p>object</p>                      | Placeholder for exchange-specific extensions to OpenRTB                                                                                                            |

**Geo**

&#x20;

| **Attribute**                   | **Type**                       | **Description**                                                                                                                                                                                                                                                                            |
| ------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| lat                             | float                          | Latitude from -90.0 to +90.0, where negative is south.                                                                                                                                                                                                                                     |
| lon                             | float                          | Longitude from -180.0 to +180.0, where negative is west.                                                                                                                                                                                                                                   |
| type                            | integer                        | Source of location data; recommended when passing lat/lon.                                                                                                                                                                                                                                 |
| <p> </p><p> </p><p>accuracy</p> | <p> </p><p> </p><p>integer</p> | Estimated location accuracy in meters; recommended when lat/lon are specified and derived from a device’s location services (i.e., type = 1). Note that this is the accuracy as reported from the device. Consult OS specific documentation (e.g., Android, iOS) for exact interpretation. |
| country                         | string                         | Country code using ISO-3166-1-alpha-3.                                                                                                                                                                                                                                                     |
| region                          | string                         | Region code using ISO-3166-2; 2-letter state code if USA.                                                                                                                                                                                                                                  |
| city                            | string                         | City using United Nations Code for Trade & Transport Locations.                                                                                                                                                                                                                            |
| zip                             | string                         | Zip or postal code.                                                                                                                                                                                                                                                                        |
| ext                             | object                         | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                                                                                                    |

&#x20;

**User**

| **Attribute**                  | **Type**                                  | **Description**                                                                                                                                                                                                               |
| ------------------------------ | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><br><br></p><p>id</p>       | string; recommended                       | <p>Exchange-specific ID for the user. At least one of id or buyeruid is</p><p>recommended.</p>                                                                                                                                |
| <p><br><br></p><p>buyeruid</p> | <p><br><br></p><p>string; recommended</p> | Buyer-specific ID for the user as mapped by the exchange for the buyer. At least one of buyeruid or id is recommended.                                                                                                        |
| yob                            | integer                                   | Year of birth as a 4-digit integer.                                                                                                                                                                                           |
| <p><br><br></p><p>gender</p>   | <p><br><br></p><p>string</p>              | Gender, where “M” = male, “F” = female, “O” = known to be other (i.e., omitted is unknown).                                                                                                                                   |
| <p><br><br></p><p>keywords</p> | <p><br><br></p><p>string</p>              | Comma separated list of keywords, interests, or intent.                                                                                                                                                                       |
| <p> </p><p>customdata</p>      | <p> </p><p>string</p>                     | Optional feature to pass bidder data that was set in the exchange’s cookie. The string must be in base85 cookie safe characters and be in any format. Proper JSON encoding must be used to include “escaped” quotation marks. |
| <p> </p><p>geo</p>             | <p> </p><p>object</p>                     | Location of the user’s home base defined by a Geo object. This is not necessarily their current location.                                                                                                                     |
| data                           | object array                              | Additional user data. Each Data object represents a different data source.                                                                                                                                                    |
| <p> </p><p>ext</p>             | <p> </p><p>object</p>                     | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                                       |

&#x20;

**App**

| **Attribute**                    | **Type**                                        | **Description**                                                                                                                                                                                                      |
| -------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                               | string; recommended                             | Exchange-specific app ID.                                                                                                                                                                                            |
| name                             | string                                          | App name (may be aliased at the publisher’s request).                                                                                                                                                                |
| <p> </p><p>bundle</p>            | <p> </p><p>string; required</p>                 | A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric ID. |
| domain                           | string                                          | Domain of the app (e.g., “[http://mygame.foo.com](http://mygame.foo.com/) ”).                                                                                                                                        |
| storeurl                         | string                                          | App store URL for an installed app; for IQG 2.1 compliance.                                                                                                                                                          |
| <p><br><br></p><p>cat</p>        | <p><br><br></p><p>string array; recommended</p> | Array of IAB content categories of the app.                                                                                                                                                                          |
| <p><br><br></p><p>sectioncat</p> | <p><br><br></p><p>string array</p>              | Array of IAB content categories that describe the current section of the app.                                                                                                                                        |
| <p><br><br></p><p>pagecat</p>    | <p><br><br></p><p>string array</p>              | Array of IAB content categories that describe the current page or view of the app.                                                                                                                                   |
| ver                              | string                                          | Application version.                                                                                                                                                                                                 |
| privacypolicy                    | integer                                         | Indicates if the app has a privacy policy, where 0 = no, 1 = yes.                                                                                                                                                    |
| paid                             | integer                                         | 0 = app is free, 1 = the app is a paid version.                                                                                                                                                                      |
| publisher                        | object                                          | Details about the Publisher of the app.                                                                                                                                                                              |
| content                          | object                                          | Details about the Content within the app.                                                                                                                                                                            |
| keywords                         | string                                          | Comma separated list of keywords about the app.                                                                                                                                                                      |
| <p> </p><p>ext</p>               | <p> </p><p>object</p>                           | Placeholder for exchange-specific extensions to OpenRTB                                                                                                                                                              |

## **Bid Response** <a href="#bid-response" id="bid-response"></a>

DTXplatform expects to receive a Bid Response for each BidRequest. The following table describes the fields and objects in the BidResponse message. All calls should return HTTP code 200 except for an empty bid response (no bids) which should return HTTP code 204.

&#x20;

| **Attribute**                     | **Type**                           | **Description**                                                                                                                                                                                                            |
| --------------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                                | string; required                   | ID of the bid request to which this is a response.                                                                                                                                                                         |
| <p><br><br></p><p>seatbid</p>     | <p><br><br></p><p>object array</p> | Array of seatbid objects; 1+ required if a bid is to be made.                                                                                                                                                              |
| bidid                             | string                             | Bidder generated response ID to assist with logging/tracking.                                                                                                                                                              |
| <p><br><br></p><p>cur</p>         | <p>string;</p><p>default “USD”</p> | Bid currency using ISO-4217 alpha codes.                                                                                                                                                                                   |
| <p> </p><p> </p><p>customdata</p> | <p> </p><p> </p><p>string</p>      | Optional feature to allow a bidder to set data in the exchange’s cookie. The string must be in base85 cookie safe characters and be in any format. Proper JSON encoding must be used to include “escaped” quotation marks. |
| nbr                               | integer                            | Reason for not bidding.                                                                                                                                                                                                    |
| ext                               | object                             | Placeholder for bidder-specific extensions to OpenRTB                                                                                                                                                                      |

&#x20;

Note: we recommend using field “cur”, even if you set USD as default currency, except cases when it is specified in the agreement.

**Seat Bid**

| **Attribute**               | **Type**                                 | **Description**                                                                          |
| --------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------- |
| bid                         | <p>object array;</p><p>required</p>      | Array with 1 Bid object.                                                                 |
| <p><br><br></p><p>seat</p>  | <p><br><br></p><p>string</p>             | ID of the buyer seat (e.g., advertiser, agency) on whose behalf this bid is made.        |
| <p><br><br></p><p>group</p> | <p><br><br></p><p>integer; default 0</p> | 0 = impressions can be won individually; 1 = impressions must be won or lost as a group. |
| <p><br><br></p><p>ext</p>   | <p><br><br></p><p>object</p>             | Placeholder for bidder-specific extensions to OpenRTB.                                   |

&#x20;

&#x20;

**Bid**

| **Attribute**                  | **Type**                               | **Description**                                                                                                                                                                                                                              |
| ------------------------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><br><br></p><p>id</p>       | <p><br><br></p><p>string; required</p> | Bidder generated bid ID to assist with logging/tracking.                                                                                                                                                                                     |
| impid                          | string; required                       | ID of the Imp object in the related bid request.                                                                                                                                                                                             |
| <p> </p><p> </p><p>price</p>   | <p> </p><p> </p><p>float; required</p> | Bid price expressed as CPM although the actual transaction is for a unit impression only. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java).                  |
| <p><br><br></p><p>adid</p>     | <p><br><br></p><p>string</p>           | ID of a preloaded ad to be served if the bid wins.                                                                                                                                                                                           |
| <p> </p><p>nurl</p>            | <p> </p><p>string</p>                  | Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad); optional means of serving ad markup.                                                                              |
| <p> </p><p>adm</p>             | <p> </p><p>string</p>                  | <p>Optional means of conveying ad markup in case the bid wins;</p><p>supersedes the win notice if markup is included in both.</p>                                                                                                            |
| <p> </p><p> </p><p>adomain</p> | <p> </p><p> </p><p>string array</p>    | <p>Advertiser domain for block list checking (e.g., “<a href="http://ford.com/"><http://ford.com></a> ”).</p><p>This can be an array of for the case of rotating creatives.</p><p>Exchanges can mandate that only one domain is allowed.</p> |
| <p> </p><p> </p><p>bundle</p>  | <p> </p><p> </p><p>string</p>          | A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric ID.                         |
| <p> </p><p>cid</p>             | <p> </p><p>string</p>                  | Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative.                                                                                                                         |
| <p> </p><p>crid</p>            | string                                 | Creative ID to assist with ad quality checking.                                                                                                                                                                                              |
| cat                            | string array                           | IAB content categories of the creative.                                                                                                                                                                                                      |
| attr                           | integer array                          | Set of attributes describing the creative.                                                                                                                                                                                                   |
| api                            | integer                                | API required by the markup if applicable.                                                                                                                                                                                                    |
| protocol                       | integer                                | Video response protocol of the markup if applicable.                                                                                                                                                                                         |
| <p> </p><p>w</p>               | <p> </p><p>integer</p>                 | Width of the creative in device independent pixels (DIPS).                                                                                                                                                                                   |
| h                              | integer                                | Height of the creative in device independent pixels (DIPS).                                                                                                                                                                                  |
| <p> </p><p>ext</p>             | <p> </p><p>object</p>                  | Placeholder for bidder-specific extensions to OpenRTB                                                                                                                                                                                        |

&#x20;

**Substitution Macros**

Any of the following substitution macros can be included in the Win Notice URL or Ad Markup. If present, they will each be replaced by the appropriate data.

If the suffi&#x78;**: B64** is appended to the macro name, the data will be Base64-encoded prior to the substitution.

For example, ${AUCTION\_AD\_ID:B64}.

| Macro                                      | Description                                                                |
| ------------------------------------------ | -------------------------------------------------------------------------- |
| ${AUCTION\_ID}                             | ID of the bid request; from “id” attribute.                                |
| ${AUCTION\_BID\_ID}                        | ID of the bid; from “bidid” attribute.                                     |
| ${AUCTION\_IMP\_ID}                        | ID of the impression just won; from “impid” attribute.                     |
| ${AUCTION\_SEAT\_ID}                       | ID of the bidder’s seat for whom the bid was made.                         |
| <p><br><br></p><p>${AUCTION\_AD\_ID}</p>   | ID of the ad markup the bidder wishes to serve; from “adid” attribute.     |
| ${AUCTION\_PRICE}                          | Settlement price using the same currency and units as the bid.             |
| <p><br><br></p><p>${AUCTION\_CURRENCY}</p> | The currency used in the bid (explicit or implied); for confirmation only. |

&#x20;

## **Banner Bid Request Example** <a href="#banner-bid-request-example" id="banner-bid-request-example"></a>

<br>

```
{

"id":"6d5a5f43e41f8c3291e55610a2",

"tmax":270,

"cur":[

"USD"

],

"imp":[

{

"id":"21342",

"instl":0,

"secure":0, "bidfloor":0.822, "banner":{

"w":300,

"h":250,

"btype":[ 4

],

"battr":[ 8,

10

]

}

}

],

"device":{

"dnt":0, "devicetype":4, "geo":{

"country":"USA", "type":2,

"lat":37.0154,

"lon":-88.5805,

"city":"Paducah", "accuracy":10

},

"connectiontype":2, "language":"en",

"model":"Z899VL",

"make":"ZTE", "carrier":"Comcast Business",

"dpidsha1":"11423CE1D87419405EBA4032D12820A6C1832014",


"dpidmd5":"A773B99F95ED68CA6BAA54C12C545491",

"ifa":"087bd6ba-63c4-4cbd-bbae-6dddc4712525", "os":"android",

"osv":"7.1.1", "js":1,

"ua":"Mozilla/5.0 (Linux; Android 7.1.1; Z899VL Build/NMF26V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/67.0.3396.87 Mobile Safari/537.36",

"ip":"74.93.62.129"

}, "at":2,

"bcat":[

"IAB24",

"IAB25", "IAB26"

],

"user":{

},

"regs":{

"ext":{

"gdpr":0

}

},

"app":{

"id":"e6348673bbdb", "name":"DTX Test App", "bundle":"test.DTX", "cat":[

"IAB19-18",

"IAB19-30", "IAB19"

],

"pagecat":[

"IAB19-18",

"IAB19-30", "IAB19"

],

"publisher":{

"id":"72835"

}

}

}
```

## **Native Bid Request Example** <a href="#native-bid-request-example" id="native-bid-request-example"></a>

<br>

```
{

"id":"1f6ee57f713696acda0dff10a3", "tmax":380,

"cur":[

"USD"

],

"imp":[

{

"id":"17502",

"instl":0,

"secure":0,

"native":{




"request":"{\"ver\":\"1.1\",\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"data\":{\"type\":12}},{\"id\":2,\"required\":1,\"title\

":{\"len\":50}},{\"id\":3,\"required\":1,\"img\":{\"type\":1,\"wmin\":80,\"hmin\":80}},{\"id\":4,\"required\":1,\"img\"

:{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"data\":{\"type\":3}},{\"id\":6,\"required\":1,\"data\":{\"type\": 2,\"len\":100}}]}",

"ver":"1.1"

},

"bidfloor":0.236, "tagid":"1"

}

],

"device":{

"dnt":0, "devicetype":1, "geo":{

"country":"USA", "type":2,

"lat":39.9524,

"lon":-75.0884,

"region":"NJ",

"city":"Camden",

"zip":"08105"

},

"connectiontype":2, "language":"en",


"model":"android", "carrier":"Comcast Cable",

"dpidsha1":"21748b97f0e829adfb0ee79b84a5b4e9c34e5c87", "dpidmd5":"04c33b085c1f50f9d461ef89eafa8c65", "ifa":"56C40F4C-9EAD-4602-A844-EC85A37B3B60",

"os":"android",

"osv":"8.0.0",

"ua":"Mozilla/5.0 (Linux; Android 8.0.0; SM-G955U Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/67.0.3396.87 Mobile Safari/537.36",

"ip":"68.83.71.69"

}, "at":2,

"badv":[

"adv_13_dom.com"

],

"user":{

"ext":{

"consent":""

}

},

"regs":{

"ext":{

"gdpr":0

}

},

"app":{

"id":"20828a1253e0",

"name":"DTXtest app", "bundle":"test.DTX", "cat":[

"IAB3"

],

"publisher":{

"id":"1006445"

}

}

}
```

<br>

## **Video Bid Request Example** <a href="#video-bid-request-example" id="video-bid-request-example"></a>

```
{

"id":"8cf436a2a4025181bfde59cc492c4833rt44282", "at":2,

"cur":[

"USD"

],

"tmax":500,

"imp":[

{

"id":"3592",

"instl":0,

"secure":0, "bidfloor":0.8801, "video":{

"w":320,

"h":480,

"mimes":[

"video/mp4", "application/javascript"

],

"protocols":[

2,

5,

3,

6

],

"linearity":1, "minduration":1, "maxduration":120, "boxingallowed":1, "minbitrate":250, "api":[2],

"battr":[8, 10]

},





}],

"bcat":[

 

 

],

"tagid":"f8310c5872b6d7c61ca3ab1d43515ebd"

 

"IAB9-7",

"IAB14-1",

"IAB25-3"


"user":{"id":"3bd4b338a544d1aa4615cb2ace29a3c117096160"}, "regs":{

"coppa":0,

"ext":{


"gdpr":0

}

},


"device":{

"geo":{

 

 

 

 

 

 

},

 




"type":2,

"lat":33.9224,

"lon":-117.2476,

"country":"USA", "city":"Moreno Valley", "metro":"803",

"zip":"92553"


"ip":"47.180.20.79",

"osv":"8.1.0",

"os":"android", "make":"sky_devices", "model":"platinum_e5",

"ua":"Mozilla/5.0 (Linux; Android 8.1.0; Platinum_E5 Build/O11019; wv) AppleWebKit/537.36 (KHTML,

like Gecko) Version/4.0 Chrome/74.0.3729.136 Mobile Safari/537.36", "ifa":"2288AC1D-91F8-4124-865A-96585719A87F",

"carrier":"Frontier Communications", "connectiontype":2,

"language":"en-US", "dnt":0,

"lmt":0, "devicetype":4

},

"app":{

"id":"03adaee12c95482136962e3f4a086841",

"bundle":"com.c125tek.inputsv55.skin.keyboard_theme_neon_blue_heart_keyboard", "name":"ime_skin",




"storeurl":"https://play.google.com/store/apps/details?id=com.c125tek.inputsv55.skin.keyboard_theme_ne on_blue_heart_keyboard",

"publisher":{"id":"79"}, "cat":["IAB1"]

}

}
```

\ <br>

## **Site Pop Bid Request Example** <a href="#site-pop-bid-request-example" id="site-pop-bid-request-example"></a>

```
{ "id":"16133315580841",

"user":{"id":"0"},

"ext":{"format":"json-web","topic_id":6,"key":""}, "imp":[

{

"id":"866438918186",

"bidfloor":0.35, "bidfloorcur":"USD", "banner":

{


 

 

}

}

],

"site":

{

"ext":{"type":1}, "w":1,

"h":1


"domain":"site.net",

"id":"451708-none_1935_69040000",

"page":"http://site.net",

"keywords":"",

"ref":"", "cat":[

"IAB6","IAB7","IAB8","IAB10","IAB16","IAB17"

],

"ext":{"userid":451708}

},

"device":

{

"ip":"124.36.182.22",

"ua":"Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.31 Safari/537.36",

"geo":{"country":"US","type":2,"ipservice":3,"region":"North Carolina","city":"Winston-Salem"}, "language":"",

"devicetype":3, "ext":{"accept_language":"","remote_addr":"95.111.127.95","x_forwarded_for":""}

}

}
```

\ <br>

## **App Push Notification Bid Request Example** <a href="#app-push-notification-bid-request-example" id="app-push-notification-bid-request-example"></a>

```
{ "cur":["USD"],

"tmax":150,

"imp":[

{

"bidfloor":0.049, "tagid":"5d2316e6ddfe096f9bf233e2ab7f6cb7", "instl":1,

"native":

{

"request":"{ \"adunit\": 2, \"assets\": [ { \"id\": 3, \"img\": { \"h\": 120, \"hmin\": 0, \"type\": 3, \"w\":

180, \"wmin\": 0 }, \"required\": 1 }, { \"id\": 0, \"required\": 1, \"title\": { \"len\": 140 } }, { \"data\": { \"len\": 25,

\"type\": 1 }, \"id\": 4, \"required\": 1 }, { \"data\": { \"len\": 140, \"type\": 2 }, \"id\": 6, \"required\": 1 } ],

\"context\": 1, \"layout\": 1, \"contextsubtype\": 11, \"plcmtcnt\": 1, \"plcmttype\": 2, \"ver\":

\"1.1\",\"ext\":{\"banner\":{\"w\":320,\"h\":480}}}"}, "id":"102",

"secure":0

}

],

"ext":{"location":"inpage"}, "version":"2.3",

"at":2,

"device":

{


"geo":

{

 

 

 

 

 

},

 




"lat":6.335,

"country":"NGA", "lon":5.6274999999999995,

"city":"Benin City", "accuracy":200


"language":"en-US",

"ua":"Mozilla/5.0 (Linux; Android 8.1.0; TECNO LA7 Pro Build/O11019; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/69.0.3497.100 Mobile Safari/537.36",

"make":"TECNO MOBILE LIMITED",

"connectiontype":6, "osv":"8.1.0",

"dpidsha1":"a440dc2544a51bec313c9f4b8af6fd2ce4485d1f", "dnt":0,

"carrier":"Airtel Networks Limited", "devicetype":4,

"ifa":"aab2455a-1051-45ea-94a4-6a96a41f72e6",


 

 

 

 

 

},

"app":

{

"ip":"105.112.96.239",

"model":"TECNO LA7 Pro", "js":1,

"os":"android", "dpidmd5":"19e72f4c14003c3db5041f9b15824c6e"

 

 

"publisher":{"id":"25139"},

"name":"PDScreen - Colorful Flash Themes", "bundle":"com.color.flash.colorpd",


"cat":["IAB1","IAB19","IAB19-29","IAB19-18","IAB3-4","IAB3","IAB14","IAB10-6","IAB10","IAB9","IAB9-7","

IAB9-30","IAB19-23","IAB15-10","IAB15","IAB1-6","IAB7","IAB7-44","IAB17-30","IAB17","IAB23-7","IAB23

","IAB25","IAB22","IAB9-11","IAB9-10","IAB1-1","IAB9-23","IAB9-5","IAB12","IAB8","IAB8-17","IAB17-42",

"IAB19-6","IAB12-3","IAB26-3","IAB13-3","IAB13","IAB5","IAB2","IAB6","IAB19-16","IAB19-5","IAB7-1","IA

B17-4","IAB20","IAB7-32","IAB1-7","IAB5-8","IAB18","IAB16","IAB11-4","IAB11","IAB17-44","IAB4","IAB1 9-17"],

"pagecat":["IAB24"], "id":"fec1575d64e4",

"storeurl":"https://play.google.com/store/apps/details?id=com.color.flash.colorpd"

},

"id":"331-5c8798219b2921-339",

"user":

{

"buyeruid":"", "id":"so0Lj3PGuzW+V9gyQUwgmlkL3D/vcIBgx03RIMqq0fE="

},

"_state":{}, "bundle":"com.color.flash.colorpd"

}

```

\ <br>

## Audio Bid request Example <a href="#audio-bid-request-example" id="audio-bid-request-example"></a>

```
{

  "id": "5yf48752-548a-45dr-45h5-dut4950647",

  "imp": [

    {

      "id": "46056hf1-0685-69k4-84h3-6lt59659f4eru",

      "audio": {

        "mimes": [

          "audio/ogg",

          "audio/mpeg",

          "audio/mp3",

          "audio/aac",

          "audio/wav",

          "audio/mp2",

          "audio/m4a",

          "audio/wma",

          "audio/flac"

        ],

        "minduration": 1,

        "maxduration": 150,

        "protocols": [

          2,

          3,

          5,

          6,

          9,

          10

        ],

        "startdelay": -1,

        "minbitrate": 30,

        "maxbitrate": 300800,

        "api": [

          6

        ]

      },

      "bidfloor": 3.3407432346,

      "bidfloorcur": "USD",

      "secure": 0,

      "tagid": "2946952_1"

    }

  ],

  "site": {

    "id": "10008756",

    "name": "SAMPLE-SH",

    "domain": "http://sample.com ",

    "cat": [

      "IAB1"

    ],

    "sectioncat": [

      "IAB1"

    ],

    "pagecat": [

      "IAB1"

    ],

    "page": "http://www.sample.com ",

    "ref": "http://www.sample.com ",

    "publisher": {

      "id": "650",

      "name": "SH_Sample",

      "domain": ""

    },

    "content": {

      "genre": "Talk"

    }

  },

  "device": {

    "ua": "AppleCoreMedia/1.0.0.18F72 (iPhone; U; CPU OS 14_6 like Mac OS X; en_us)",

    "geo": {

      "country": "usa"

    },

    "ip": "174.248.121.124",

    "devicetype": 4,

    "os": "iOS",

    "language": "en",

    "ifa": "",

    "dpidsha1": "",

    "dpidmd5": "",

    "js": 0,

    "flashver": "-1"

  },

  "user": {

    "id": "PDY6HD3D1A865AS2"

  },

  "at": 1,

  "bcat": [

    "IAB25",

    "IAB26",

    "IAB2-1"

  ],

  "regs": {

    "ext": {

      "us_privacy": "1---"

    }

  }

}

 

 

 
```

&#x20;

&#x20;

&#x20;

## **Banner Bid Response Example** <a href="#banner-bid-response-example" id="banner-bid-response-example"></a>

```
{

"id":"1604878679620146",

"bidid":"6c528cc37f7cb7b991314d07539ba636", "seatbid":[

{

"bid":[

{

"id":"80a5b9489b88b1fd819ed3ac92ddba1a", "impid":"1",

"price":0.20505,




"nurl":"http://s1e.smarthub.smartyads.com/?win=nurl&sp=${AUCTION_PRICE}&t=banner&uniq=d84cecf8 1051da76a95ef2b89b4b1105",

"adm":"<img src='http://s1e.smarthub.smartyads.com/?win=impr&price=${AUCTION_PRICE}&prt=4_9563cbab5ac513 b0cae7454f06b59fa6&t=banner&uniq=d84cecf81051da76a95ef2b89b4b1105' border='0' width='1' height='1'>",

"w":320,

"h":50,

"adomain":[ "dtx.smartyads.com"

],

"cat":[

"IAB20-3"

],

"attr":[ 4

],

"adid":"dea25016e99c", "cid":"4_79_771_19594",

"crid":"9563cbab5ac513b0cae7454f06b59fa6"

}

],

"seat":"4"

}

],

"cur":"USD"

}
```

<br>

## **Native Bid Response Example** <a href="#native-bid-response-example" id="native-bid-response-example"></a>

<br>

```
{

"id":"-6546523267599067373",

"bidid":"5413cb366a2560cd74344af4c94bae99", "seatbid":[

{

"bid":[

{

"id":"fbb2aab10a46131f02166d0e01b61881", "impid":"1",

"price":0.06932,




"nurl":"http://s1e.dtx.smartyads.com/?win=nurl&sp=${AUCTION_PRICE}&t=native&uniq=f79594a4 4ff05947706842c79503fb71",

"adm":"{\"native\":{\"assets\":[{\"id\":1,\"title\":{\"text\":\"Erro De Mercado: IPhone X Por 1€ Em Moita\"}},{\"id\":3,\"data\":{\"value\":\"Money And

Business\"}},{\"id\":4,\"img\":{\"url\":\"https://teutorigos-cat.com/281de20c-2a2e-49f1-b6a0-a91a1881e229/ a93b64ee-81bb-4c66-98b0-7c30f05c815c.jpeg\",\"w\":300,\"h\":250}}],\"imptrackers\":[\"http://s1e.smarthu b.smartyads.com/?win=impr&price=${AUCTION_PRICE}&prt=247&t=native&uniq=f79594a44ff05947706 842c79503fb71\"],\"ver\":\"1.1\"}}",

"adomain":[ "dtx.smartyads.com"

],

"cat":[

"IAB22"

],

"adid":"c0a830e0f670", "cid":"247_2b32b_546_4", "crid":"68c69d5c0c776982dbeb65afa9166727"

}

],

"seat":"247"

}

],

"cur":"USD"

}

```

\ <br>

## **Video Bid Response Example (Linear VAST 2.0)** <a href="#video-bid-response-example-linear-vast-2.0" id="video-bid-response-example-linear-vast-2.0"></a>

```
{

"id":"d103514d4b03b142776d2610a161", "bidid":"413101757fc629385bf81419b154f262", "cur":"USD",

"seatbid":[

{


"bid":[

{

 




"id":"fa4556a8d9878b4c51af58f122540b34",

"adm":"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><VAST version=\"2.0\"><Ad id=\"ad_kXVEk65GcAkbubzFbUefGd45cXzwO\"><Wrapper><AdS ystem version=\"1.0\">NUVIAD</AdSystem><VASTAdTagURI><![CDAT A[https://vast.site.com/ssp/vast/59e5ed4b8346f30002000001/5cb4 77340551f200016d8232?cb=1557216435228&width=320&height= 480&dnt=&sub_id=G150Ads_Video&app_name=Neon%20Blue%2 0Heart%20Stylish%20Reading&bundle_id=com.c125tek.inputsv55. skin.keyboard_theme_neon_blue_heart_keyboard&ifa=2288ac1d- 91f8-4124-865a-96585719a87f&app_store_url=https://play.google. com/store/apps/details?id=com.125tek.inputsv55.skin.keyboard_th eme_neon_blue_heart_keyboard&app_category=&ip=47.180.20.7 9&ua=Mozilla%2F5.0%20(Linux%3B%20Android%208.1.0%3B%2 0Platinum_E5%20Build%2FO11019%3B%20wv)%20AppleWebKit

%2F537.36%20(KHTML%2C%20like%20Gecko)%20Version%2F4

.0%20Chrome%2F74.0.3729.136%20Mobile%20Safari%2F537.36

&user_lat=33.9224&user_lon=-117.2476&user_consent=[USER_C ONSENT]&gdpr=[GDPR]]]></VASTAdTagURI><Impression><![CD ATA[http://ssp.c10.io/?w=i&p=${AUCTION_PRICE}&t=b&uq=bb15 e294163eb402df00883963c377ae]]></Impression><Impression><! [CDATA[http://ns6.dsp35.com/?v=impr&sp=1.60025&dp=23_d2a9 4b297e6f76a060bc7751016aab24&tt=vid&hp=e993aae4463c694a 001b53b9022839db]]></Impression><Impression><![CDATA[http:// us-e-node8.trade-rtb5com/?event=impression&price=1.84377&sea t=446|9fc2ccb0aa30be6230b18d555b136176&traffic=video&hash= b1e5a2860952c4b7da5df78babca0616]]></Impression><Impressi on><![CDATA[http://notify.video152.com/pixel/214-b4fd50cbeb271 7f-819/1.97203/pixdata?data=H4sIAAAAAAAAA5VU23LbNhD9FQ 1eK3JAile9uePYaSa2k3rk+I2DGylUJMABQUpUpv/eBS+uPX1J9U Kdxe7B7tld/ESqHyThheRoj4ylRTmkZ41NedbldTif47ovsyKI4zQMk mgXh2GCtohKPgWEQeTRqOQxZlTQMA3S0suCHDw6QSw4EGa 1KZo/MnN39zX+cXv+9uXUvHwR/a7pn6vL96/3Ty14L0kA7f9PpGi NZALtwxkxMzEA2+n15dMpie/ZzYn29HpHD6K851HMXq/npyWWc


N0QqSDAGjmQSvtMN8uZbNqJKk12IZhsh/bvr8+2iJGmJbJSc9Jv6 PjYK9p8PxxfvjF6yG/L25gmD6x6vTw9/gCmWZQ5zV/Tp3Zi7nZ+H oYRIA0Je0GQ+mGUJlvEiRWuGTjIPRx7OIWIo+4N2mdzJY1kRoN CePptUSNV70LSLeo7saQCFWWEBdzLgzLzoiCMvCyJiZcncRan QU6ytARipntlzQgBh+cbh6V14EEbofTmhdS1GMGsO1ed4kYDuY MD4MwPfOwEaNtCkcYl/Si02vxe92LzWRBjN892rGV33PwpCJeq Wpxpr3jt3KE70CFtxcnvGvCXqu3tEPvdSSr/JEaqieGFPYpGFAqo CwrUxdFRF+sxcHIxFDUB+j0Syjs8uzqIMVKAZggtqlRC8dXgkphU EkkS0CDOdknOJzWUKuzYzvPX9W1bjwt2MW4RpBXF25SthpZU 4h00onyH2LQ6K5quXcGi2priqCnaQ0MpUWrt4y9MvriwI1TvmP6S 0afnfHw4fHZV8qKTV2fehfgSZWuvICFR6anpYJEtfKPUDzLsh9hP 3b,of0R7ct+gMYxpit/6sN2LKDSQaoN5R93bOFQayrLUGZbEfONd aMCt4rdlSaE+LrmsX4a01nbxMkVyQera2PXVTsnanrQmDjiv73wY pYuUgoNlv9/O5PbBHbP4XTPMAb0jRkJMrvjuNxWzp0L9nmgt3O9 wFU9c3hYhnxVo36ti9D9cPS7jB2R6n8GT8hp2OshOX1ohudtZdI2 GALTtOsBJath8scAus+QeTEZV0m49ujLxqRaZnqq5hSwoofVrDyY vUQ+/eB+hGPU1EzKKY8F2U5TGmOM5DLBLKsACCspbt+oDiBc

4D9/c/afijqRsGAAA=]]></Impression><Error><![CDATA[http://notif y.video152.com/vast/event/rtb_fv7wo0rfwofzvww5luf8_155721643 5226/campaign_hNunbmQUhVPcbU9DfD5b6McgXxONW/ad_kXV Ek65GcAkbubzFbUefGd45cXzwO/actor_mI8rFFL5WDwPJkmVJe u3muSgxQLGOp/ERROR]]></Error><Creatives><Creative id=\"ad_kXVEk65GcAkbubzFbUefGd45cXzwO\" AdID=\"ad_kXVEk65GcAkbubzFbUefGd45cXzwO\" sequence=\"1\"><Linear><TrackingEvents><Tracking event=\"start\"><![CDATA[http://notify.video152.com/vast/event/rtb

_fv7wo0rfwofzvww5luf8_1557216435226/campaign_hNunbmQUh VPcbU9DfD5b6McgXxONW/ad_kXVEk65GcAkbubzFbUefGd45cX zwO/actor_mI8rFFL5WDwPJkmVJeu3muSgxQLGOp/start]]></Tra cking><Tracking event=\"firstQuartile\"><![CDATA[http://notify.video152.com/vast/ev ent/rtb_fv7wo0rfwofzvww5luf8_1557216435226/campaign_hNunb mQUhVPcbU9DfD5b6McgXxONW/ad_kXVEk65GcAkbubzFbUefG d45cXzwO/actor_mI8rFFL5WDwPJkmVJeu3muSgxQLGOp/Q1]]>

</Tracking><Tracking event=\"midpoint\"><![CDATA[http://notify.video152.com/vast/event

/rtb_fv7wo0rfwofzvww5luf8_1557216435226/campaign_hNunbmQ UhVPcbU9DfD5b6McgXxONW/ad_kXVEk65GcAkbubzFbUefGd45 cXzwO/actor_mI8rFFL5WDwPJkmVJeu3muSgxQLGOp/Q2]]></Tr acking><Tracking event=\"thirdQuartile\"><![CDATA[http://notify.video152.com/vast/e vent/rtb_fv7wo0rfwofzvww5luf8_1557216435226/campaign_hNunb mQUhVPcbU9DfD5b6McgXxONW/ad_kXVEk65GcAkbubzFbUefG d45cXzwO/actor_mI8rFFL5WDwPJkmVJeu3muSgxQLGOp/Q3]]>

</Tracking><Tracking event=\"complete\"><![CDATA[http://notify.video152.com/vast/even t/rtb_fv7wo0rfwofzvww5luf8_1557216435226/campaign_hNunbmQ


UhVPcbU9DfD5b6McgXxONW/ad_kXVEk65GcAkbubzFbUefGd45 cXzwO/actor_mI8rFFL5WDwPJkmVJeu3muSgxQLGOp/Q4]]></Tr acking><Tracking event=\"creativeView\"><![CDATA[http://notify.video152.com/vast/e vent/rtb_fv7wo0rfwofzvww5luf8_1557216435226/campaign_hNunb mQUhVPcbU9DfD5b6McgXxONW/ad_kXVEk65GcAkbubzFbUefG d45cXzwO/actor_mI8rFFL5WDwPJkmVJeu3muSgxQLGOp/CV]]>

</Tracking></TrackingEvents><VideoClicks><ClickTracking><![CD ATA[http://notify.video152.com/click/rtb_fv7wo0rfwofzvww5luf8_15 57216435226/campaign_hNunbmQUhVPcbU9DfD5b6McgXxONW

/ad_kXVEk65GcAkbubzFbUefGd45cXzwO/actor_mI8rFFL5WDwP JkmVJeu3muSgxQLGOp]]></ClickTracking></VideoClicks></Line ar></Creative></Creatives></Wrapper></Ad></VAST>",

"price":1.1518,




"nurl":"http://ssp.c10.io/?w=n&p=${AUCTION_PRICE}&t=b&uq=bb15e294163eb402df00883963c377ae",

"impid":"552", "adomain":["trivsite10.com"],

"cat":["IAB1"],

"attr":[4], "iurl":"http://ns6.dsp35.com/?t=preview&k=a430e1cfbcc9",

"cid":"469|23_446|campaign_hNunbmQUhVPcbU9DfD5b6McgXxONW", "crid":"c10_469|23_446|ad_kXVEk65GcAkbubzFbUefGd45cXzwO"

}

],

"seat":"469"

}

]

}
```

\ <br>

## **Site Pop Bid Response Example** <a href="#site-pop-bid-response-example" id="site-pop-bid-response-example"></a>

```
{ "id":"11558084613331",

"bidid":"64c7b45221cadc429e2620f97f85455a", "cur":"USD",

"seatbid":[

{

"bid":[

{

"id":"ddc05de1be2b651af86433ca6c7c0df4", "price":2.6595,




"nurl":"http://endpoint.at.io/?w=n&p=${AUCTION_PRICE}&t=p&uq=860c92d105277e2f6614b0bf771d3da c",

"impid":"888949858886",

"adomain":[""], "adid":"f359d38b264f", "cat":["IAB24"],

"attr":[4], "iurl":"http://ep1.at.io/?t=iurl&bid=157", "cid":"616|7767",

"crid":"at_616|157", "adm":"<?xml version=\"1.0\"

encoding=\"ISO-8859-1\"?><ad><popunderAd><url><![CDATA[http://endpoint.at.io/?w=i&p=${AUCTION

_PRICE}&ds=616|undefined&t=p&uq=860c92d105277e2f6614b0bf771d3dac]]></url></popunderAd></ad

>",




"ext":{"url":["http://endpoint.at.io/?w=i&p=${AUCTION_PRICE}&t=p&uq=860c92d105277e2f6614b0bf771 d3dac"]}

}

],

"seat":"616"

}

]

}

```

\ <br>

## **App Push Notification Bid Response Example** <a href="#app-push-notification-bid-response-example" id="app-push-notification-bid-response-example"></a>

```
{

"id":"331-5519b2928798241-386",

"bidid":"ca37bc02a536cc1a805774063009110f", "cur":"USD",

"seatbid":[

{"bid":[{"id":"4653b4a2eb37bbe9a469fa8dbcd6f8f7",




"adm":"{\"native\":{\"ver\":\"1.1\",\"link\":{\"url\":\"http://ep1.at.io/c.js?t=nativeClick&uniq=44eb8af5d662c65 8acb7496055be478b&redirectTo=https%3A%2F%2Fappdatum.com%2Fpath%2Flp.php%3Ftrvid%3D137 39%26trvx%3Df7aee7d1%26cost%3Dnone%26var1%3D41c_none\",\"clicktrackers\":[\"http://ep1.at.io/c.j s?t=click&k=44eb8af5d662c658acb7496055be478b\"]},\"imptrackers\":[\"http://ep1.at.io/?t=impr&bwpr=0. 057&uniq=44eb8af5d662c658acb7496055be478b\",\"http://endpoint.at.io/?w=i&p=${AUCTION_PRICE}&t

=b&uq=1c85a98038b390416dffa6d8d8cd14ba\"],\"jstracker\":\"\\n <script>(function(){\\n var newImg = document.createElement('img');\\n newImg.setAttribute('src', 'http://ep1.at.io/?t=check&uniq=44eb8af5d662c658acb7496055be478b&u=encodeURIComponent(windo w.location.hostname)');\\n newImg.setAttribute('alt', '');\\n newImg.setAttribute('height', '1');\\n newImg.setAttribute('width', '1');\\n document.getElementsByTagName('body')[0].appendChild(newImg);\\n

})();</script>\",\"assets\":[{\"id\":3,\"img\":{\"url\":\"https://ftp.at.io:4443/1690-050779ea6cc958fbe3751beac a9981b5.jpg\",\"w\":492,\"h\":328}},{\"id\":0,\"title\":{\"text\":\"Africasino™ - Join and

WIN\"}},{\"id\":4,\"data\":{\"value\":\"Win back money!\"}},{\"id\":6,\"data\":{\"value\":\"Get up to R10.000 and start off as a winner !\"}}]}}",

"price":0.0515,




"nurl":"http://endpoint.at.io/?w=n&p=${AUCTION_PRICE}&t=b&uq=1c85a98038b390416dffa6d8d8cd14b a",

"impid":"102", "adomain":["Nairabet "],

"cat":["IAB24"],

"attr":[4], "iurl":"http://ep1.at.io/?t=iurl&bid=192", "cid":"529|7801",

"crid":"at_529|192"}],

"seat":"529"}

]

}
```

Audio Bid Response Example\
\ <a href="#audio-bid-response-example-hardbreak" id="audio-bid-response-example-hardbreak"></a>
------------------------------------------------------------------------------------------------

```
{

  "id": "01s92359-a78g-57sq-72d4-swf736208825",

  "seatbid": [

    {

      "seat": "142150f4-4920-5593-025q-d7g63dwrt736",

      "bid": [

        {

          "id": "01s92359-a78g-57sq-72d4-swf736208825",

          "impid": "82036ka1-8356-24l3-03h8-6kg5749f4bec",

          "price": 2.4,

          "nurl": "http://sample.com/i/23/2eAuGcike6Eo84RT1mSceKTRVduq6jzRcc8bSB2_6j8_o6Ln1qrX6I9UkonDBM_gt4u-ef1m7ZrYvdZtuvX4gs-Y8P-AUX1zIV3sK5_Z39cKIllwmJMo-dLZKph_R1Mye21DLCuo34WTHHg_uH4UCsNhDUYssDRvLWE3XL-CDUzaLerV4ZIXVruV2DaI41_5dNVmA6YUg/${AUCTION_PRICE}/ ",

          "adm": "<VAST version=\"2.0\"><Ad id=\"3e3ce1d7a53b45668be5f579e75c5dd7\"><Wrapper><Error><![CDATA[http://sample.com/er/6/CYAzZTNjZTFkN2E1M2I0NTY2OGJlNWY1NzllNzVjNWRktxMBykilMDhmODI2NDItYjkxYi00M2NlLTg1ZjUtZGVmMDYzNTg3OTcxAw/?errorCode=[ERRORCODE] ]]></Error><AdSystem>Sample DSP</AdSystem><VASTAdTagURI><![CDATA[https://api.testing.com/163/vast/3.0/?apikey=7a891b7c-1b0a-451b-944e-79c3ee55de9d&stationid=2d0fb4ce-e6e3-4e2f-8ac2-58492fe16320&product=gamestreaming&placement=midroll&ip=181.252.120.123]]></VASTAdTagURI><Creatives><Creative><Linear><Duration>00:00:05</Duration><TrackingEvents><Tracking event=\"firstQuartile\"><![CDATA[http://sample.com/vr/4/NWEwODM1MzMzNjBmNDkzYzk3ZmRiZGUyOTczYjFlNrLw64Svxl5iMGE5OGRkYzMyNzA3YzIwMmMxNzY5MThjMWE4OTQxtgmQThOO7AGlMDhmODI2NDItYjkxYi00M2NlLTg1ZjUtZGVmMDYzNTg3OTcx/0/ ]]></Tracking><Tracking event=\"midpoint\"><![CDATA[sample.com ]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[sample.com ]]></Tracking><Tracking event=\"complete\"><![CDATA[sample.com ]]></Tracking><Tracking event=\"close\"><![CDATA[sample.com ]]></Tracking><Tracking event=\"start\"><![CDATA[sample.com ]]></Tracking></TrackingEvents></Linear></Creative></Creatives></Wrapper></Ad></VAST>",

          "protocol": 5,

          "adomain": [

            "test.com"

          ],

          "attr": [

            1

          ],


```

<br>