Google Ads Developer Blog: ad_exchange

Ad Exchange Seller REST API Deprecation Reminder

Wednesday, March 21, 2018

The Ad Exchange Seller REST API is deprecated. Existing API clients should migrate to the DoubleClick for Publishers API before July 26, 2018. After this date, all requests to the Ad Exchange Seller REST API will return errors.

This migration guide provides instructions for getting started, as well as a mapping of each Ad Exchange reporting metric to its equivalent in the DFP API.

For more details about reporting in the DFP API, see the reporting guide.

For general assistance with the DFP API or your migration, reach out on our developer forum.

- Chris Seeley, DFP API Team

Ad Exchange Seller REST API Deprecation

Thursday, October 26, 2017

The Ad Exchange Seller REST API is being deprecated as of October 26, 2017. No new API clients will be supported after this date. Existing API clients will need to migrate to the DoubleClick for Publishers API before July 26, 2018. After this date, all requests to the Ad Exchange Seller REST API will return errors.

What action is required

Current Ad Exchange Seller REST API users will need to migrate to the DoubleClick for Publishers API before July 26, 2018. This migration guide provides a mapping of each Ad Exchange reporting metric to its equivalent in the DFP API.

For more details about reporting in the DFP API, see the reporting guide.

For general assistance with the DFP API or your migration, reach out on our developer forum.

Why this is happening

As a part of our effort to provide a unified tool to manage your ad business and monetize your inventory, the DoubleClick for Publishers API now supports all of the features of the Ad Exchange Seller REST API. The DFP API is more robust and has more frequent updates.

What isn't changing

Users will not need to create new accounts. All Ad Exchange Seller users already have a DoubleClick for Publishers account.

No data is changing. The only change is how you programmatically access that data.

- Chris Seeley, DFP API Team

DoubleClick Ad Exchange Seller API new metrics and dimensions

Thursday, July 21, 2016

We are delighted to announce the introduction of additional Metrics and Dimensions which are now available through the reports resource; the API now returns most of the fields that the UI Query tool makes available.

The Metrics and Dimensions reference page now includes the UI field names to help make conversions simpler.

New Dimensions	New Metrics
`AD_LOCATION`	`ACTIVE_VIEW_ELIGIBLE_COUNT`
`ADVERTISER_DOMAIN`	`ACTIVE_VIEW_MEASURABLE_COUNT`
`AGENCY_NAME`	`ACTIVE_VIEW_MEASURABLE_RATIO`
`BRAND_NAME`	`ACTIVE_VIEW_VIEWABLE_COUNT`
`CREATIVE_SIZE`	`ACTIVE_VIEW_VIEWABLE_RATIO`
`DEAL_ID`	`ACTIVE_VIEW_VIEWABLE_TIME`
`DEAL_NAME`	`AD_IMPRESSIONS`
`DFP_AD_UNIT_ID`	`AD_IMPRESSIONS_RPM`
`DFP_AD_UNITS`	`DEALS_AD_REQUESTS`
`DFP_REQUEST_SOURCE`	`DEALS_BID_RESPONSES`
`INVENTORY_OWNERSHIP`	`DEALS_MATCH_RATE`
`INVENTORY_PARTNER_NAME`	`DEALS_MATCHED_REQUESTS`
`MOBILE_APP_NAME`	`LIFT_RATE`
`MOBILE_CARRIER_NAME`	`VIDEO_AD_ABANDONMENT_RATIO`
`MOBILE_DEVICE_NAME`	`VIDEO_AD_DROPOFF_RATIO`
`MOBILE_INVENTORY_TYPE`	`VIDEO_AD_QUARTILE_ONE`
`MOBILE_OS_VERSION`	`VIDEO_AD_QUARTILE_THREE`
`MOBILE_USER_BANDWIDTH`	`VIDEO_AD_SKIPPABLE_SKIP_RATIO`
`VIDEO_AD_DURATION`	`VIDEO_AD_SKIPPABLE_VIEWS`
`VIDEO_AD_DURATION_RAW`	`VIDEO_AD_SKIPPABLE_VTR`
`VIDEO_AD_FORMAT`

-- Dean Lukies, Ad Exchange Seller API Team

DoubleClick Ad Exchange Seller API sunsets

Thursday, June 30, 2016

Versions 1 and 1.1 of the DoubleClick Ad Exchange Seller API are marked as deprecated and will be sunset on the 14th of October 2016, after which any calls to these versions will return an error.

All users must migrate to Version 2.0 of the API by this date to avoid an interruption in service.

The deprecated resources preferredDeals and reports.saved will be sunset for all API versions on the 12th of July, after which any calls to these resources will return an error.

This will NOT impact reports.generate which most of you use to generate reports.

-- Dean Lukies, Ad Exchange Seller API Team

DoubleClick Ad Exchange Seller REST API Report changes

Friday, November 6, 2015

On November 17th, 2015, we'll be updating the Ad Exchange Seller REST API to make it consistent with the user interface. Specifically, we'll remove the ability to download saved reports or retrieve the dimensions we retired in April. Requests made after this date for these dimensions will result in that dimension being ignored and requests for saved reports will result in an error. As a reminder, the dimensions we retired in April are:

AD_FORMAT_CODE

AD_UNIT_ID

AD_UNIT_CODE

DSP_ID

EXPANSION_TYPE_CODE

PLATFORM_TYPE_CODE

For a full list of available dimensions, please see the AdX Seller REST API documentation. Follow our Google+ page for other announcements and updates.

-- Dean Lukies, Ads Developer Relations

DoubleClick Ad Exchange Seller REST API Report changes

Wednesday, February 11, 2015

The ability to generate saved reports using the API will be retired on April 6th, 2015, along with six dimensions due to low usage. After the sunset, any API calls to Reports.Saved or requests for these dimensions will result an error.

After the introduction of the Query Tool to the UI last year, the ability to create and edit saved reports in the UI was removed--leading to the sunsetting of Reports.Saved in the API.

The dimensions that will be removed are

AD_FORMAT_CODE
AD_UNIT_EXTERNAL_ID*
AD_UNIT_CODE*
DSP_BUYER_NETWORK_ENCRYPTED_ID
EXPANSION_TYPE_CODE
PLATFORM_TYPE_CODE

[*] these dimensions haven't been relevant for 6 months due to the move to Enhanced Inventory Controls and only are retained in the UI for historic purposes.

To find out if you will be affected, search your code for any of the strings above and remove them; they will be associated with a call to Reports.Generate.

For a full list of available dimensions please see the AdX Seller REST API documentation.

-- Dean Lukies, Ads Developer Relations

DoubleClick Ad Exchange Seller REST API v2.0

Wednesday, September 17, 2014

Today we launch the v2.0 release of the DoubleClick Ad Exchange Seller REST API. This release adds support for associating a single user to more than one account.

If your user ID is associated with only one account, you can continue to use v1.1 of the API as you have previously, although we recommend you always use v2.0 of the API. If your user ID is associated with more than one account, you must use the v2.0 API and supply the accountId of the appropriate customer account with each request.

For example, resource requests in v1.1 like this:
https://www.googleapis.com/adexchangeseller/v1.1/{resourceType}/{resourceId}

Will become this in v2.0:
https://www.googleapis.com/adexchangeseller/v2.0/accounts/{accountId}/{resourceType}/{resourceId}

Follow our Google+ page for other announcements and updates.

Dean Lukies, Ads Developer Relations

New version of the DoubleClick Ad Exchange Seller REST API

Tuesday, September 24, 2013

Version 1.1 of the Ad Exchange Seller REST API is now available, and with it comes three new features:

the ability to retrieve alerts;
the ability to retrieve preferred deals and private auctions;
the ability to retrieve metrics and dimensions metadata for reporting.

This version is fully backwards-compatible with v1, so the changes required to upgrade are minimal, but we've prepared a migration guide to help you through the process.

Give the new version a try, and be sure to take a look at our Google+ Page for Ads Developers!

- Sérgio Gomes, Ads Developer Relations

A new API: DoubleClick Ad Exchange Seller REST API

Thursday, October 25, 2012

Today we’re happy to announce the launch of the new DoubleClick Ad Exchange Seller REST API. With it, you can list your inventory and programmatically run reports, opening up possibilities such as:

checking out how much money you made last month, on your phone
adding stylish charts to your earnings reports
making your own reporting interface, suited to your specific needs
using real ad unit or channel performance data in your internal systems, to help with business decisions.

This API, like all of our new APIs, is built on the same RESTful, standards-based technology stack you’re used to. This means you have access to all sorts of useful tools for trying out the API, such as the APIs explorer (which is also built into the documentation for each method), and our generic, cross-API client libraries.

Give it a try, and let us know if you have any questions!

- Sérgio Gomes, on behalf of the DoubleClick Ad Exchange Seller REST API Team

Ads Developer Blog

Ad Exchange Seller REST API Deprecation Reminder

Ad Exchange Seller REST API Deprecation

DoubleClick Ad Exchange Seller API new metrics and dimensions

DoubleClick Ad Exchange Seller API sunsets

DoubleClick Ad Exchange Seller REST API Report changes

DoubleClick Ad Exchange Seller REST API Report changes

DoubleClick Ad Exchange Seller REST API v2.0

New version of the DoubleClick Ad Exchange Seller REST API

A new API: DoubleClick Ad Exchange Seller REST API

Labels

Archive