Real-time Bidding API
Version 1.0
Date | Notes |
---|---|
October 8, 2020 | Replaced fields openAuctionServingStatus , openBiddingServingStatus ,
dealsServingStatus , chinaServingStatus and
russiaServingStatus with networkPolicyCompliance ,
platformPolicyCompliance , dealsPolicyCompliance ,
chinaPolicyCompliance and russiaPolicyCompliance respectively.
|
June 24, 2020 | Initial launch of the Real-time Bidding API, to eventually replace the Ad Exchange Buyer and Ad Exchange Buyer II APIs. Migration notes. |
Legacy versions
Version 2.0
Release Date | Notes |
---|---|
8/20/2020 |
Added the |
5/6/2020 |
Added the |
3/9/2016 |
Released Client Access as an open beta. You can now let your client buyers directly access the Authorized Buyers Marketplace to be able to view, negotiate, and approve deals. And, your application can programmatically perform operations that previously had to be done manually in the Clients section of the Authorized Buyers Buyer Account Settings tab. |
Version 1.4
Release Date | Notes |
---|---|
11/11/2019 |
Added the |
1/6/2017 |
The |
10/14/2016 |
Added the
|
2/22/2016 |
Added the |
11/9/2015 |
Added the
Deprecated the native |
9/4/2015 |
Added support for apiUploadTimestamp to the
Creatives
resource.
This field provides the last upload timestamp of a creative
(in RFC 3339 format)
if it was uploaded via API.
|
9/4/2015 |
Added the ability to submit Native Ads
via the nativeAd property of the
Creatives
resource.
|
8/1/2015 | Deprecated the "Direct Deals" service. |
7/20/2015 |
Updated the
Creatives resource to provide more detail about its status.
Removed the status field and replaced it with
dealsStatus and openAuctionStatus .
Removed the disapprovalReasons field and replaced it
with servingRestrictions .
|
Version 1.3
Release Date | Notes |
---|---|
11/11/2019 |
Added the |
9/4/2015 |
Added support for apiUploadTimestamp to the
Creatives
resource.
This field provides the last upload timestamp of a creative
(in RFC 3339 format)
if it was uploaded via API.
|
12/2/2014 | Added the Budget resource that allows you to get or update the budget of a specific ad group. |
9/22/2014 | Adds the new field publisherBlocksOverridden
to the
DirectDeals resource. |
9/2/2014 | Adds the new field billingId to the
PretargetingConfig resource. |
8/12/2014 | Adds the
BillingInfo resource that allows you to retrieve an account's
adgroups that could show up as part of a BidRequest .
|
6/10/2014 | Adds the PretargetingConfig resource that allows you to pre-target impressions so that Authorized Buyers will send you only the requests for impressions that match your pre-targeting criteria. |
1/17/2014 | Includes a new performance report API that allows you to retrieve performance metrics. |
8/23/2013 | Allows you to reuse buyer creative IDs. If you submit a new creative with the buyer creative ID for an existing creative, the new creative replaces the existing creative and will be reviewed. |
Version 1.2
The following new features were added for Version 1.2 of the Ad Exchange Buyer API:
- Detailed Creative Disapproval Reasons
- Rather than returning a list of strings when a creative
has been disapproved, the
disapprovalReasons
list will contain one or moreDisapprovalReasons
objects with the following fields:Field Description reason
The categorized reason for the disapproval. details[]
Details on why this ad was disapproved for the categorized reason. - New
agencyId
field - The new
agencyId
field allows you to identify the agency that produced the ad using the IDs in the agencies.txt file.
The following feature was backported to Version 1.2 of the Ad Exchange Buyer API on 9/4/2015:
-
Added support for
apiUploadTimestamp
to the Creatives resource. This field provides the last upload timestamp of a creative (in RFC 3339 format) if it was uploaded via API.
Version 1.1
The following changes have been made for Version 1.1 of the Ad Exchange Buyer API:
- A
list
method has been added for the Creatives resource. The new method will retrieve a list of all of the active creatives for the currently authenticated user with optional filtering bycreative
status. - The
adgroupId
has been removed from the Creatives resource. This value will no longer be accepted or returned from the Creatives resource's methods. - The
bidderLocation[]
list in the Account resource now includes a third value. Theregion
property describes the region for the bidder location.
Buyer API v1.1 is deprecated on December 9, 2014.
Version 1
The initial version of the API. There are no special notes.
Buyer API v1 is deprecated on December 9, 2014.