ℹ️Integration Document RTB

Specification for Integration with SSP’s/DSP’s

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 FT.pdf https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf

Bid Request

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.

Attribute

Type

Description

string; required

Unique ID of the bid request, provided by the exchange.

imp

object array;

required

Array with 1 Imp object.

site

object; required

Details via a Site object about the publisher’s website. Only applicable and required for websites.

app

object; required

Details via an App object about the publisher’s app (i.e., non-browser applications). Only applicable and required for apps.

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.

test

integer; default 0

Indicator of test mode in which auctions are not billable,

where 0 = live mode, 1 = test mode.

integer; default 2

Auction type, where 1 = First Price, 2 = Second Price Plus.

Exchange-specific auction types can be defined using values greater than 500.

tmax

integer

Maximum time in milliseconds to submit a bid to avoid timeout. This value is commonly communicated offline.

wseat

string array

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 a priori.

Omission implies no seat restrictions.

allimps

integer; default 0

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 =

yes, the impressions offered represent all that are available.

cur

string array

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 ”).

bapp

string array

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.

regs

object

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

Impression

Attribute

Type

Description

string

A unique identifier for this impression within the context of the bid request (typically, starts with 1 and increments.

banner

object

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.

native

object

A Native object; required if this impression is offered as a native ad opportunity.

displaymanager

string

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.

Bid Response

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.

Attribute

Type

Description

string; required

ID of the bid request to which this is a response.

seatbid

object array

Array of seatbid objects; 1+ required if a bid is to be made.

bidid

string

Bidder generated response ID to assist with logging/tracking.

cur

string;

default “USD”

Bid currency using ISO-4217 alpha codes.

customdata

string

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

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

object array;

required

Array with 1 Bid object.

seat

string

ID of the buyer seat (e.g., advertiser, agency) on whose behalf this bid is made.

group

integer; default 0

0 = impressions can be won individually; 1 = impressions must be won or lost as a group.

ext

object

Placeholder for bidder-specific extensions to OpenRTB.

Bid

Attribute

Type

Description

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. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java).

adid

string

ID of a preloaded ad to be served if the bid wins.

nurl

string

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.

adm

string

Optional means of conveying ad markup in case the bid wins;

supersedes the win notice if markup is included in both.

adomain

string array

Advertiser domain for block list checking (e.g., “http://ford.com ”).

This can be an array of for the case of rotating creatives.

Exchanges can mandate that only one domain is allowed.

bundle

string

cid

string

Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative.

crid

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.

integer

Width of the creative in device independent pixels (DIPS).

integer

Height of the creative in device independent pixels (DIPS).

ext

object

Placeholder for bidder-specific extensions to OpenRTB

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 suffix: 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.

${AUCTION_AD_ID}

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.

${AUCTION_CURRENCY}

The currency used in the bid (explicit or implied); for confirmation only.

Banner Bid Request Example

{

"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

{

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

}

}

}

Video Bid Request Example

{

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

}

}

Site Pop Bid Request Example

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

}

}

App Push Notification Bid Request Example

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

}

Audio Bid request Example

{

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

    }

  }

}

Banner Bid Response Example

{

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

}

Native Bid Response Example

{

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

}

Video Bid Response Example (Linear VAST 2.0)

{

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

}

]

}

Site Pop Bid Response Example

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

}

]

}

App Push Notification Bid Response Example

{

"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

{

  "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

          ],

PreviousHow can I understand the reason my Campaign was declined?

Last updated 2 years ago

Was this helpful?