The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

Release Notes

v0 (2024-11-08)

This update includes new fields and new resources. Be sure to update the client library to take advantage of all these changes.

New fields

We are adding ad_group_ad.effective_labels and ad_group_criterion.effective_labels.

Effective Labels are labels inherited or directly assigned.

New resources

User Location View

Using it with geo segments can get metrics related to region, metro and city.

See user_location_view resource details.

Related to the new effective_labels fields, there are 2 new resources that keep the metadata of the association between the effective labels and the ad_group_ad (ad_group_ad_effective_label) or ad_group_criterion (ad_group_criterion_effective_label).

v0 (2024-10-07)

This update includes new metrics, resources, fields and some new mapping definitions. Be sure to update the client library to take advantage of all these changes.

Metrics added

cross_device_conversions_by_conversion_date: The number of cross-device conversions by conversion date.
cross_device_conversions_value_by_conversion_date: The sum of cross-device conversions value by conversion date.
general_invalid_click_rate: The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks.
general_invalid_clicks: Number of general invalid clicks.

cross_device_conversions_by_conversion_date and cross_device_conversions_value_by_conversion_date are compatible with these resources: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view, and shopping_performance_view.

Field mappings redefined

The field mappings for dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv have changed for some legacy reports.

Field	Previously	New Definition
`dfaActions`	metrics.all_conversions - metrics.cross_device_conversions	metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
`dfaActionsCrossEnv`	metrics.all_conversions	metrics.all_conversions_by_conversion_date
`dfaRevenue`	metrics.all_conversions_value - metrics.cross_device_conversions_value	metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
`dfaRevenueCrossEnv`	metrics.all_conversions_value	metrics.all_conversions_value_by_conversion_date
`dfaTransactions`	metrics.all_conversions - metrics.cross_device_conversions	metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
`dfaTransactionsCrossEnv`	metrics.all_conversions	metrics.all_conversions_by_conversion_date

List of legacy reports that have changed the field mapping

New fields

We are adding campaign.effective_labels and ad_group.effective_labels.

Effective Labels are labels inherited or directly assigned.

New resources

Related to the new effective_labels fields, the new resources keep metadata of the association between the effective labels and the campaign (campaign_effective_label) or ad_group (ad_group_effective_label).

v0 (2024-08-23)

In this update Custom Column metadata adds the renderType field .

See the CustomColumnRenderType details.

A new owner_customer_id field has been added to campaign_label, ad_group_label, ad_group_ad_label and ad_group_criterion_label resources.

Be sure to update the client library to take advantage of these new fields.

v0 (2024-08-01)

This updates includes the hourly segmentation and several new fields

Hourly segmentation

Hourly segmentation can now be specified in a query. See more details in segments.hour.

Added start_time to customer_manager_link resource

See more details in customer_manager_link.start_time

Added MULTIMEDIA_AD to ad_group_ad.ad.type

Metrics and segments can now be selected with MULTIMEDIA_AD type. Querying multimedia-specific attributes isn't supported in this version.

Added SOCIAL campaign type to campaign.advertising_channel_type and SOCIAL_FACEBOOK_TRACKING_ONLY subtype to campaign.advertising_channel_sub_type

Metrics and segments can now be selected with SOCIAL campaign type and SOCIAL_FACEBOOK_TRACKING_ONLY subtype. Querying SOCIAL or SOCIAL_FACEBOOK_TRACKING_ONLY specific attributes aren't supported in this version.

Added support for average_quality_score

See more details in metrics

v0 (2024-04-18)

This updates includes the Accessible Bidding Strategy resource

Accessible Bidding Strategy

Represents a view of BiddingStrategies owned by and shared with the customer. In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.

See accessible_bidding_strategy resource details.

v0 (2024-02-12)

This updates includes access to Custom Columns and Custom Floodlight Variables

Custom Columns

Custom Conversion Columns and Custom Formula Columns can now be specified in a query. See more details in the Custom Columns documentation.

Custom Floodlight Variables

Custom Floodlight Variables can now be specified in a query, for stats after 2024/01/30. See more details in the Custom Floodlight variables documentation.

v0 (2023-11-09)

This update includes the following resources. Visit the links to see the fields that can be queried for these resources, and the metrics and segmentations that can be used with them.

Asset Group

See asset_group resource details.

Asset Group Asset

See asset_group_asset resource details.

Asset Group Listing Group Filter

See asset_group_listing_group_filter resource details.

Asset Group Signal

See asset_group_signal resource details.

Asset Group Top Combination View

See asset_group_top_combination_view resource details.

Cart Data Sales View

See cart_data_sales_view resource details.

Conversion

See conversion resource details.

Shopping Performance View

See shopping_performance_view resource details.

Visit

See visit resource details.

v0 (2023-08-15)

This update includes the following resources and a new parameter to configure currency conversion for metrics.

Visit the links to see the fields that can be queried for these resources, and the metrics and segmentations that can be used with them.

Ad Group Asset

See ad_group_asset resource details.

Ad Group Asset Set

See ad_group_asset_set resource details.

Asset

See asset resource details.

Asset Set

See asset_set resource details.

Asset Set Asset

See asset_set_asset resource details.

Campaign Asset

See campaign_asset resource details.

Campaign Asset Set

See campaign_asset_set resource details.

Customer Asset

See customer_asset resource details.

Customer Asset Set

See customer_asset_set resource details.

Currency Conversion

It is possible to specify the currency for metrics calculation using metrics_currency in the PARAMETERS section.

List Accessible Customers

List all the accessible accounts using ListAccessibleCustomers method

v0 (2023-05-15)

This update includes the following resource. Visit the links to see the fields that can be queried for this resource, and the metrics and segmentations that can be used with it.

Ad Group Ad

See ad_group_ad resource details.

v0 (2023-04-06)

This update includes the following resources. Visit the links to see the fields that can be queried for each resource, and the metrics and segmentations that can be used with that resource.

Ad Group Audience View

See ad_group_audience_view resource details.

Ad Group Criterion Label

See ad_group_criterion_label resource details.

Ad Group Label

See ad_group_label resource details.

Age Range View

See age_range_view resource details.

Campaign Criterion

See campaign_criterion resource details.

Campaign Label

See campaign_label resource details

Dynamic Search Ads Search Term View

See dynamic_search_ads_search_term_view resource details.

Webpage View

See webpage_view resource details.

Label

See label resource details.

v0 (2022-12-05)

The v0 version includes the following resources and services. Visit the links to see the fields that can be queried for each resource, and the metrics and segmentations that can be used with that resource.

Ad Group

See ad_group resource details.

Bidding

See bidding_strategy resource details.

Campaigns

See campaign resource details.

Conversion Action

See conversion_action resource details.

Customer

See customer resource details.

Keyword

See keyword_view resource details.

Product Group

See product_group_view resource details.

SearchAds360FieldService

SearchAds360FieldService provides a catalog of all queryable fields. The metadata on these fields includes descriptions, types, and compatibility with other fields. Learn more.

SearchAds360Service

SearchAds360Service is meant for retrieving multiple resources in a single query. Queryable resources include:
- AdGroup
- BiddingStrategy
- Campaign
- ConversionAction
- Customer
- Keyword
- ProductGroup
Metrics such as impressions and clicks can also be retrieved using SearchAds360Service for these resources:
- AdGroup
- BiddingStrategy
- Campaign
- ConversionAction
- Customer
- Keyword
- ProductGroup
SearchAds360Service allows segmentation by fields, such as date fields. Learn more.