The Anypoint Connector for Google Ad Manager enables publishers and third-parties to consume the Google Ad Manager API to help them grow, sell, schedule, deliver, and measure their digital ad inventory on Google Ad Manager through Mule.

MuleSoft maintains the Premium version of the connector under the Certified support policy.

Google Ad Manager 4.0.0 - March 2019

Version 4.0.0 Compatibility

Software Version

Mule Runtime

3.6+

Google Ad Manager API

v201805

Issues Fixed

  • Exception handling for when parameters of Get Delivery Forecast by IDs operation are null.

New Features

  • Updated connector to Google Ad Manager.

  • Upgraded Google Ad Manager API from v201711 to v201805.

Upgrading from a Previous Version

The Google Ad Manager 4.0.0 connector is not backwards compatible with version 3.1.0. To upgrade to this version:

  • Replace any Google DFP (Premium) endpoints with Google Ad Manager (Premium) endpoints, copying any configuration from the old endpoints to the new endpoints.

  • Remove the following namespace from any Mule XML configuration files:

    xmlns:google-dfp-premium="http://www.mulesoft.org/schema/mule/google-dfp-premium

  • Remove the following elements from xsi:schemaLocation from any Mule XML configuration files:

    http://www.mulesoft.org/schema/mule/google-dfp-premium
http://www.mulesoft.org/schema/mule/google-dfp-premium/current/mule-google-dfp-premium.xsd

Google DFP 3.1.0 - March 2018

Version 3.1.0 Compatibility

Software Version

Mule Runtime

3.6+

Google DFP API

v201711

Issues Fixed

  • Upgraded Google-DFP API version from v201702 to v201711.

  • Modified key separator for composed selectors in perform operations from || to @@ avoiding conflicts for Windows OS developers.

New Features

None

Upgrading from a Previous Version

The Google DFP 3.1.0 connector offers the same functionality as version 3.0.0.

Google DFP 3.0.0 - March 2017

Version 3.0.0 Compatibility

Software Version

Mule Runtime

3.6+

Google DFP API

v201702

Issues Fixed

None

New Features

Summary

  1. New operations introduced.

  2. Connector devised between Operations (Get, Update, Perform, Update) instead of service.

  3. Datasense support has been improved.

  4. Upgraded Support for the 2016-11 Google API.

  5. Removed operations which cannot be tested in an automated fashion (these might be included on request).

  6. Added functionality to wait reports to be created before returning control.

  7. Added support for Google Service Account Authentication.

Authentication Methods

  • OAuth Authentication

  • NEW Google Service Accounts (JSON file)

Supported Operations

Operations that are Currently Supported (ordered by Service):

  • Company Service:

    • Create Companies

    • Get Companies

    • Update Companies

  • Contact Service:

    • Create Contacts

    • Get Contacts

    • Update Contacts

  • Custom Field Service:

    • Create Custom Field Options

    • Create Custom Field

    • Get Custom Field Option

    • Perform Custom Field Action

    • Update Custom Field Option

    • Update Custom Fields

  • Custom Targeting Service:

    • Create Custom Targeting Keys

    • Create Custom Targeting Values

    • Get Custom Targeting Keys

    • Get Custom Targeting Values

    • Perform Custom Targeting Keys

    • Perform Custom Targeting Values

    • Update Custom Targeting Keys

    • Update Custom Targeting Values

  • Forecast Service:

    • Get Availability Forecast

    • Get Availability Forecast by ID

    • Get Delivery Forecast

    • Get Delivery Forecast by ID

  • Inventory Service (Ad Units):

    • Create Ad Units

    • Get Ad Units

    • Get Ad Unit Sizes

    • Perform Ad Units

    • Update Ad Units

  • Line Item Service:

    • Create Line Items

    • Get Line Items

    • Perform Line Items

    • Update Line Items

  • Order Service:

    • Create Orders

    • Get Orders

    • Perform Orders Action

    • Update Orders

  • Placement Service:

    • Create Placements

    • Get Placements

    • Perform Placements

    • Update Placements

  • Publisher Query Language Service:

    • Select PQL

  • Report Service:

    • Create Report Asynchronously

    • Create Report Synchronously

    • Download Report

    • Get Report Download Url With Options

    • Get Report Status

    • Get Saved Queries by Statement

  • User Service:

    • Create Users

    • Get All Roles

    • Get Current User

    • Get Users

    • Perform Users

    • Update Users

  • Publisher Query Language Service:

    • Select PQL

Upgrading from a Previous Version

The Google DFP 3.0.0 is not backward compatible with V1.x of the connector. The table below describes how each operation performed with v1.x of the connector can be performed (if possible) with the new connector.

Old Operation Name Current Version

Create Company

Operation: Create
Service: Companies

Create Report

Operation: Create Report

Download Report

Operation: Download Report

Get advertiser by name

Operation: Get By Statement
Service: Company
Query String: type = :type AND name = :name
Query Params: type = ADVERTISER, name = CompanyName

Get agency by name

Operation: Get By Statement
Service: Company
Query String: type = :type AND name = :name
Query Params: type = AGENCY, name = CompanyName

Get all companies

Operation: Get by statement
Service: Companies

Get company by ID

Operation: Get by statement
Service: Companies

Get reconciliation report IDs by start date

Not Supported

Get reconciliation report rows

Not Supported

Update company

Operation: Update
Service: Companies

Google DFP 2.0.0 - July 2016

Version 2.0.0 Compatibility

The Google DFP connector is compatible with:

Application/Service Version

Mule Runtime

3.6.1

Google DFP

v201605

Issues Fixed

None

New Features

  • Company Service:

    • Create Company

    • Update Company

    • Get All Companies

    • Get Advertiser by Name

    • Get Agency by Name

    • Get Company by ID

    • Get Companies by ID

    • Get Company Comment by Name

    • Create Companies

    • Get Companies

    • Update Companies

  • Report Service:

    • Create Report

    • Download Report

  • Reconciliation Report Service:

    • Get Reconciliation Report IDs by Start Date

    • Get Reconciliation Reports

    • Update Reconciliation Reports

  • Reconciliation Report Row Service:

    • Get Reconciliation Report Rows

    • Get Reconciliation Report Rows

    • Update Reconciliation Report Rows

  • Audience Segment Service:

    • Get Audience Segments by Statement

  • Custom Field Service:

    • Get Custom Field Option

    • Get Custom Fields by ID

    • Get Custom Fields by Statement

  • Line Item Service:

    • Get Filtered Line Items by Statement

    • Get Line Items by ID

    • Get Line Items by Statement

    • Create Line Items

    • Get Line Items

    • Perform Line Items

    • Update Line Items

  • Order Service:

    • Get Orders by ID

    • Get Orders by Statement

    • Create Orders

    • Get Orders

    • Perform Orders

    • Update Orders

  • Custom Targeting Service:

    • Get Custom Targeting Keys by Statement

    • Get Custom Targeting Values by Statement

  • PQL Service:

    • Get All Line Items PQL

    • Get Proposal Retraction Reason PQL

  • Product Service:

    • Get Products by ID

    • Get Products by Statement

    • Get Products

    • Perform Products

    • Update Products

  • Proposal Template Service:

    • Get Product Templates by ID

    • Get Product Templates by Statement

  • Proposal Line Item Service:

    • Get Proposal Line Items by ID

    • Get Proposal Line Items by Proposal ID

    • Get Proposal Line Items by Statement

    • Create Proposal Line Items

    • Get Proposal Line Items

    • Perform Proposal Line Items

    • Update Proposal Line Items

  • Proposal Service:

    • Get Proposals by ID

    • Get Proposals by Statement

    • Create Proposals

    • Get Proposals

    • Perform Proposals

    • Update Proposals

  • Rate Card Service:

    • Get Rate Cards by Last Modified Date

  • User Service:

    • Get Users by ID

    • Get Users by Statement

  • Contact Service:

    • Get Contacts by Statement

    • Get Contact by ID

    • Get Contact by Name

    • Create Contact

    • Update Contact

  • Reconciliation Line Item Report Service:

    • Get Reconciliation Line Item Reports

    • Update Reconciliation Line Item Reports

  • Reconciliation Order Report Service:

    • Get Reconciliation Order Reports

    • Perform Reconciliation Order Reports

    • Update Reconciliation Order Reports

Upgrading from a Previous Version

The Google DFP 1.1.0 is backward compatible with V1.X of the connector.

Google DFP 1.1.0 - August 2015

Version 1.1.0 Compatibility

The Google DFP connector is compatible with:

Application/Service Version

Mule Runtime

3.6.1

Google DFP

v201505

Issues Fixed

None

New Features

  • Company Service:

    • Create Company

    • Update Company

    • Get All Companies

    • Get Advertiser by Name

    • Get Agency by Name

    • Get Company by ID

  • Report Service:

    • Create Report

    • Download Report

  • Reconciliation Report Service:

    • Create Reconciliation Report Service

    • Get Reconciliation Report IDs by Start Date

  • Reconciliation Report Row Service:

    • Get Reconciliation Report Rows

Upgrading from a Previous Version

The Google DFP 1.0.0 is backward compatible with V1.0.0 of the connector.

Google DFP 1.0.0 - May 2015

Version 1.0.0 Compatibility

The Google DFP connector is compatible with:

Application/Service Version

Mule Runtime

3.6.1

Google DFP

v201411

Issues Fixed

None

Features

  • Company Service:

    • Create Company

    • Update Company

    • Get All Companies

    • Get Advertiser by Name

    • Get Agency by Name

    • Get Company by ID

  • Report Service:

    • Create Report

    • Download Report

  • Reconciliation Report Service:

    • Create Reconciliation Report Service

    • Get Reconciliation Report IDs by Start Date

  • Reconciliation Report Row Service:

    • Get Reconciliation Report Rows

Upgrading from a Previous Version

There are no versions prior to this.

Resources