Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

AttributeTypeDescriptionSupported
idStringBidder generated bid ID to assist with logging/tracking.Yes
impidStringID of the Imp object in the related bid request.Yes
priceStringBid price expressed as CPM although the actual transaction is for a unit impression only.Yes
cidStringCampaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative. Yes
admStringMeans of conveying ad markup in case the bid wins.Yes
adomainString ArrayAdvertiser domain for block list checking (e.g., "ford.com"). This can be an array of for the case of rotating creatives.Yes
iurlStringURL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking.Yes
burlStringBilling notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy (e.g., typically delivered, viewed, etc.). needs to replace ${AUCTION_PRICE} macro with actual bid price in case pubmatic win bid.Yes
catString arrayIAB content categories of the creative as per OpenRTB 2.5.Yes
attrInteger arraySet of attributes describing the creative as per OpenRTB 2.5/2.3/2.1.Yes
cridStringCreative ID to assist with ad quality checking.Yes
adidString

ID of a preloaded ad to be served if the bid wins. Please contact your account manager to enable this.

Yes
dealidStringReference to the deal.id from the bid request if this bid pertains to a private marketplace direct deal.No
extObjectPlaceholder for bidder-specific extensions to OpenRTB.Yes
hIntegerHeight of the creative in pixels.Yes
wIntegerWidth of the creative in pixelsYes

Object: Bid.ext

AttributeTypeDescriptionSupported
dspidStringDsp IDYes
advidStringAdvertiser IDYes
skadnobjectA skadn object, will be sent as received from DSPYes

imp.ext.skadn

ATTRIBUTE

TYPE

DESCRIPTION

EXAMPLE

versionstring

The version of skadnetwork that is desired.

  • It is always 2.0 or higher, and it is dependent on both the OS version and the SDK version.
  • Maximum number of characters in string: 16 (ASCII)
2.0
networkstringAd network identifier used in signature.
Maximum number of characters in string: 64 (ASCII)
example123.skadnetwork
campaignstringCampaign ID compatible with Apple’s spec. As of 2.0, should be an integer between 1 and 100, expressed as a string.
Maximum number of characters in string: 32 (ASCII)
4
sourceappstring

ID of publisher app in Apple’s App Store.

Maximum number of characters in string: 256 (ASCII).

123456789

itunesitem string

ID of advertiser’s app in Apple’s app store.

Maximum number of characters in string: 256  (ASCII)

987654321
noncestring

An id unique to each ad response.

Maximum number of characters in string: 64 (ASCII)

12345678-1234-1234-
1234-123456789012
timestampstringUnix time in millis string used at the time of signature.
Maximum number of characters in string: 16 (ASCII)
1596695461984
signaturestring

SKAdNetwork signature as specified by Apple.

Maximum number of characters in string: 200 (ASCII)

MDUCGQDreBN5/xBN
547tJeUdqcMSBtBA+L
k06b8CGFkjR1V56rh/H
9osF8iripkuZApeDsZ
+lQ==

Integration Step

Once contract is completed, PubMatic will share the end point with publisher. End point will be similar to http://openbid.pubmatic.com/translator. On this end point, publisher can send open RTB request to PubMatic.

...