Release Notes

v8.1.0 (2021-08-11)

The functionality and changes below were added in v8.1.0.

Ads

  • Added action_items to AdGroupAd to provide you with feedback to improve your ad strength.

Bidding

  • Added support for seasonality adjustments and data exclusions, which can be applied to specific campaigns, to all campaigns that belong to specific channel types, or to specific devices:
    • Added BiddingSeasonalityAdjustment to let Smart Bidding apply conversion rate adjustments for future events such as promotions or sales.
    • Added BiddingDataExclusion to let Smart Bidding exclude data from specific dates when there are issues with an account's conversion tracking.
  • Added BiddingStrategyType.INVALID to indicate a campaign does not have a bidding strategy and cannot serve. This can occur if a campaign was previously using a manager-owned bidding strategy before being unlinked from the manager account. In this case, the campaign would transition to the INVALID bidding strategy type.

Campaigns

Change History

  • Added the following resource types to ChangeEventResourceType:
    • AD_GROUP_ASSET
    • ASSET
    • CAMPAIGN_ASSET
    • CUSTOMER_ASSET
  • Added the following new resource types to ChangeStatusResourceType:
    • AD_GROUP_ASSET
    • ASSET
    • CAMPAIGN_ASSET
    • CAMPAIGN_SHARED_SET
    • CUSTOMER_ASSET
    • SHARED_SET

Conversions

Criteria

Planning

v8.0 (2021-06-09)

The functionality and changes below were added in v8.0.

Account Management

Ads

Asset

  • Set response_content_type to MUTABLE_RESOURCE as a request parameter to return all the fields mutated in a mutate request for CustomerAssetService, CampaignAssetService and AdGroupAssetService.
  • Added support for the following metrics for CustomerAsset, CampaignAsset and AdGroupAsset:
    • absolute_top_impression_percentage
    • all_conversions
    • all_conversions_from_interactions_rate
    • all_conversions_value
    • average_cost
    • average_cpc
    • average_cpe
    • average_cpm
    • average_cpv
    • clicks
    • conversions
    • conversions_from_interactions_rate
    • conversions_value
    • cost_micros
    • cost_per_all_conversions
    • cost_per_conversion
    • cross_device_conversions
    • ctr
    • engagement_rate
    • engagements
    • interactions
    • interaction_event_types
    • interaction_rate
    • impressions
    • top_impression_percentage
    • value_per_all_conversions
    • value_per_conversion
    • video_view_rate
    • video_views
  • Added segments.asset_interaction_target for CustomerAsset, CampaignAsset and AdGroupAsset to indicate if the interactions are on the asset itself.
  • Added AssetFieldTypeViewService to support retrieving metrics for each asset field type when the asset is used as extension.
  • Updated the following values of LeadFormFieldUserInputType:
    • Replaced GIVEN_NAME with FIRST_NAME.
    • Replaced FAMILY_NAME with LAST_NAME.
  • Asset-based extensions

Audiences

  • Added TransactionAttribute.item_attribute to support associate information about a sold item with a transaction.
  • Added the following fields to UserAttribute:
    • last_purchase_date_time
    • average_purchase_count
    • average_purchase_value_micros
    • acquisition_date_time
  • Added the following values to OfflineUserDataJobError:
    • FUTURE_TIME_NOT_ALLOWED
    • LAST_PURCHASE_TIME_LESS_THAN_ACQUISITION_TIME

Bidding

  • Updated Maximize_conversion_value.target_roas to support an optional Target ROAS setting on the Maximize Conversion Value portfolio and standard bidding strategies for Search campaigns. This field will become mutable for all customers at a future date. We will post a notification on the Google Ads Developer blog when developers can update this field.
  • Updated Maximize_conversions.target_cpa to support an optional Target CPA setting on the Maximize Conversions portfolio and standard bidding strategies for Search campaigns. This field will become mutable for all customers at a future date. We will post a notification on the Google Ads Developer blog when developers can update this field.
  • Added support for creating and managing cross-account bidding strategies in manager accounts, and the ability to attach them to campaigns in customer accounts:
    • Added BiddingStrategy.currency_code for bidding strategies in manager customers, which can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
    • Added AccessibleBiddingStrategy to represent a view of all BiddingStrategies owned by and shared with the customer.
    • Added AccessibleBiddingStrategyService to read accessible bidding strategies.
    • Added Campaign.accessible_bidding_strategy for retrieving the fields of the portfolio bidding strategy identified by bidding_strategy.When a campaign uses a cross-account bidding strategy, this will be a subset of the properties normally defined for a bidding strategy, since certain properties are only accessible by a bidding strategy’s owner.

Campaigns

Conversions

Criteria

Feeds

Recommendations

v7.0 (2021-04-28)

The functionality and changes below were added in v7.0.

Account Management

Ads

Assets

Audiences

Batch Jobs

Bidding

Campaigns

  • Added CampaignError.PAYMENT_MODE_NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION to report incompatibilities with view through conversions setup.

Campaign Drafts and Experiments

Conversions

Criteria

Feeds

Hotel Ads

  • Added hotel_check_in_date_range to AdGroupBidModifier. By setting the range of dates, the bid will be modified if the user's check-in date falls within the range.

Planning

Protos

  • Updated the method comments in the proto library to include a list of possible errors that can be thrown for each method.

Recommendations

Reporting

Resources

  • Added support for returning errors that specifically say which resources has exceeded the limit when ResourceCountLimitExceededError.RESOURCE_LIMIT is returned:
    • Added ResourceLimitTypeEnum to include which resource limit was exceeded.
    • Added resource_count_details to ErrorDetails to include details of the maximum limit of the resource and the current count of the resource type in the account.

Tools

Video