Change log

This page lists in-version changes for the Google Bid Manager API.

Version 2

2024-05-01

Sunset of Full Path and Path Attribution Reports

Full Path and Path Attribution reports are sunset. Retrieving or creating these types of Query and Report resources results in an error.

The following ReportType values are sunset:

  • FULL_PATH
  • PATH_ATTRIBUTION

The pathQueryOptions field of the Options object is also sunset.

2024-02-28

Sunset of cross-device conversion metric values

Cross-device conversion metrics are sunset. The following Bid Manager API metric values are included:

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

Version 1.1

2021-04-15

SDF and Line Item services sunset

SDF and Line Item services are now sunset.

Users who seek to download Structured Data Files or manage line items must instead use the Display & Video 360 API.

2020-08-06

Path & Path Attribution Reports

TYPE_PATH and TYPE_PATH_ATTRIBUTION report types are now live.

This includes the addition of new field params.options.pathQueryOptions (which contains fields pathFilters and channelGrouping) to query and report resources.

New Filters added:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

New Metrics added:

  • METRIC_ACTIVITY_REVENUE
  • METRIC_CONVERTING_PATHS
  • METRIC_EXPOSURE_CONVERSION_RATE
  • METRIC_LAST_TOUCH_CLICK_THROUGH_CONVERSIONS
  • METRIC_LAST_TOUCH_TOTAL_CONVERSIONS
  • METRIC_LAST_TOUCH_VIEW_THROUGH_CONVERSIONS
  • METRIC_PATH_CONVERSION_RATE
  • METRIC_PROVISIONAL_IMPRESSIONS
  • METRIC_TOTAL_EXPOSURES
  • METRIC_TOTAL_PATHS

2020-03-20

Asynchronous query run

Queries.createquery and Queries.runquery method now allow running queries asynchronously.

See new parameter asynchronous in createquery and runquery for more details.

2020-01-14

Query schedule start time

Queries.createquery method now allows specifying the date at which query run schedules start.

See new field schedule.startTimeMs for more details.

2020-01-08

Toggle targeted audience lists data

Queries.createquery method now allows specifying whether audience list data should be limited to specific insertion orders or line items.

See new field params.options.includeOnlyTargetedUserLists for more details.