Today we are launching v201302 of the DFP API. This version includes many of the most requested features, such as managing contacts, running sell-through reports (if enabled on your network), and improved partner management integration. We've also added the new ad rule service, activity/activity group services, content bundle service, as well as many other features, which can all be found on our
release notes page.
Keeping in touch
Starting with v201302, you will be able to manage all of your DFP
contacts in one place. We believe this is a powerful feature for the API since quite a few publishers have large databases of contacts that can now be easily synced. Once your contacts are in DFP, you can add them to
companies and
orders. You can also fetch all contacts that haven’t been invited to view their partner orders yet and use that list to invite contacts in the UI.
We've also improved partner management in the API. You can now set up ad units for affiliate/distribution partners using the
partnerId field. Once your partner ad units are set up, you can then
report on them using partner revenue
dimensions and
columns.
Reporting
We've added over 60 new columns and dimensions in this version to more closely match what exists in the UI today. In addition to reporting on your partners as discussed above, you’ll now be able to run
sell-through reports (if enabled on your network) on your inventory and
reach reports on the
lifetime (i.e. the last 6 months) of your orders.
As well as adding new columns, we've also changed a few existing ones. To provide more flexible revenue reporting, existing revenue columns have been
renamed to indicate that they do not include cost-per-day (CPD) revenue. New
WITH_CPD columns have been added to include CPD revenue in your reports.
Finally, we've made some changes to entity dimensions. Since including a dimension like
Dimension.LINE_ITEM added both the name and the ID as columns in the report, the exact behavior of including a dimension wasn't always clear. Ambiguous dimensions have now been replaced by
NAME and
ID counterparts. To replicate the old behavior, include both of these dimensions in your report.
Housekeeping and deprecation
Starting in v201302, we are shifting many of the disjointed creative asset properties to a single manageable object -
CreativeAsset. The first type of creatives to get this treatment is
image creative. The 4 fields that previously represented the image asset have been replaced by a single
primaryImageAsset field. With the new field, you’ll always know where to find the URL to
preview the asset, instead of having to programmatically determine the name of the property.
Last but not least, to make room for all the new features, versions
v201203,
v201204, and
v201206 are now deprecated. On
June 1st, we’ll be removing them from our online documentation and
client libraries. If you are using one of these deprecated versions, now would be great time to update to take advantage of all the new features.
Be sure to also follow us on our
Ads Developer Google+ page. We'll be publishing some great tips on using the API there soon. If you have any suggestions or questions about the new version, but sure to visit our
forum.