Google Ads Developer Blog: dfp

Ads Developer Blog

The official blog for information about the Google Ads, Google Ad Manager, Google Mobile Ads SDKs for AdMob and IMA SDKs.

DFP small business changes and our API

Tuesday, August 13, 2013

helping publishers grow with DFP small businessCreativesLineItemCreativeAssociationService.createLineItemCreativeAssociationLineItemCreativeAssociation.creativeIdCustomCreativesTemplateCreatives

FlashExpandableCreative → TemplateCreative.creativeTemplateId of 10001160.

FlashPushdownCreative → TemplateCreative.creativeTemplateId of 10001400.

FloatingFlashCreative → TemplateCreative.creativeTemplateId of 10000560.

TextAdCreative → TemplateCreative.creativeTemplateId of 10000440.

Targeting and DeliverymatchTypesCustomTargetingValueCustomTargetingServiceLabelServiceLineItem.appliedLabelsAdUnits.appliedLabelsReportsReportService’sreach report columnsreach report date range typescity dimensionsNetwork administrationUserService.getAllRolesassign them to your usersDFP API forumsAds Java client library’s DFP examples

- Vincent Tsao, DFP API Team

Google

Labels: dfp_api , dfp_creatives , dfp_reports

Announcing v201306 and the Sales Management Services of the DFP API

Monday, June 24, 2013

We are pleased to announce the release of v201306 of the DFP API - one of our largest launches yet. It introduces many new features for creative management, forecasting, reporting, and includes a beta release of the sales management services. A detailed list of these features and what’s changed can be found on our release notes page.

Sales Management API

With the launch of v201306 also comes the release of the Sales Management beta services. Sales Management is currently being piloted by a small group of partners and we plan to extend availability throughout the year. We'd like to offer beta access to developers who plan to leverage the API to build connections to other business tools and systems.

The sales services allow you to:

Create and track proposals
Manage a catalog of products
Define and update rate cards
Reconcile monthly reports

For more information, take a look at our use cases guide.

To request access to the Sales Management services, please complete this form and our team will be in touch with further instructions.

Reporting

As we detailed in our previous blog posts, improving the stability and feature set of the reports is a top priority. Some highlights of note for v201306:

Columns, dimensions, and dimension attributes will now appear in reports in the order in which they were requested. This does not affect previous versions.

If you have the feature enabled, you can now specify a timeZone to run the report in. Supported time zones for your network can be found using the Time_Zone table through the PublisherQueryLanguage service. Please contact your account manager for questions regarding enabling this feature.
More than 50 columns, dimensions, and dimension attributes have been added to bring the API closer to parity with the UI.

Creatives

To make managing non-standard creatives easier, beginning in v201306, the creative types FlashExpandableCreative, FlashPushdownCreative, FloatingFlashCreative, and TextAdCreative have been replaced with the type TemplateCreative. In addition, the TemplateCreative.destinationUrl field has been added for use with %u or %%DEST_URL%% macros. As more template types are added to DFP, our hope is that you’ll be able to take advantage of them with less code modification.

If you have any suggestions or questions about the new version, feel free to comment on our plus page: Ads Developer Google+ page.

- Adam Rogal, DFP API Team

Google

Labels: dfp_api , dfp_creatives , dfp_reports , dfp_sales

Announcing v201208 of the DFP API

Tuesday, August 21, 2012

At Google, we enjoy hearing from you, the developer community, and working with you to ensure that progress is being made. We think the latest DFP API release reflects positively on how we work better together and we're excited to announce version v201208. This release adds new types of creatives, support for optimization, rich media, and video interaction report columns, along with new options for downloading reports. A full list of improvements from this release can be found on our release notes page. We also want to remind you that we host virtual office hours via Google+ hangouts in order to make sure your voice is heard. Stay tuned to our Google Developers Live calendar to catch the next one on September 18th.

Reporting improvements

In v201208, we’ve added 64 new columns which enable you to pull metrics for optimization, rich media, and video. Using these new columns, you’ll now be able to better track performance of your network including determining the interaction time of your rich media (e.g. RICH_MEDIA_INTERACTION_TIME), locating videos which complete the most (e.g. VIDEO_INTERACTION_COMPLETE), or analyzing the revenue resulting from optimized impressions (e.g. OPTIMIZATION_OPTIMIZED_REVENUE). In addition to these columns, we’ve added the CREATIVE_TYPE dimension and the ability to include custom fields to help you better break down your reports.

For applications which cannot process gzip files, you can now download reports already deflated using the new ReportService.getReportDownloadUrlWithOptions method. If you choose to not use gzip compression, we still highly recommend that you set the HTTP header Accept-Encoding: gzip to speed up downloads. We’ve also added the ability to include report properties (e.g. network, user, generation date, etc...) and remove the totals row. If there are any other types of report download options you’d like to see, we’d love to hear about them on the forum.

Creative additions

For publishers who are using the cutting edge features of DFP, we’ve added support for four new creative types: AdSenseCreative, AdExchangeCreative, RichMediaStudioCreative, and AspectRatioImageCreative. AdSense and Ad Exchange creatives allow you to traffic line item level dynamic allocation ads by serving ad slot code snippets as the creative asset. Rich media studio creatives allow you to fetch creatives created using the DoubleClick rich media studio. Although these creatives are mostly used in a read-only manner (since they are created in the rich media studio and not DFP), some fields are mutable, such as the duration, any CSS overrides, and URLs. Finally, aspect ratio image creatives let you upload multiple image assets of the same aspect ratio to give you control of how images should be scaled; these creatives are mostly used in a mobile environment given the variety of screen sizes and resolution of today’s devices.

Last but not least

In our ongoing effort to bring the API up to parity with the UI, we’ve also added a number of smaller features. These include additional company partner types, the ability to set the mobile platform type on ad units, a friendly display string for inventory sizes, the option to associate line items with creative sets , and support for the recently released device category targeting criteria.

Our API and outreach efforts are constantly growing, but we can't do it without you. If there is anything you'd like to see us do better, please let us know or introduce yourself in the next Google+ hangout on September 18th.