Tag Archives: release

Announcing v202408 of the Google Ad Manager API

We're pleased to announce that v202408 of the Google Ad Manager API is available starting today, August 21, 2024. This release brings support for setting contextual targeting with ContentLabelTargeting and VerticalTargeting. It also adds AdsTxtService for reading MCM supply chain diagnostics.

In reporting, the VIDEO_PLACEMENT_NAME dimension has been replaced by the VIDEO_PLCMT_NAME dimension which reflects the updated IAB definition.

For the full list of changes, check the release notes. Contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Source: Google Ads Developer Blog

Announcing v17_1 of the Google Ads API

Today, we’re announcing the v17_1 release of the Google Ads API. To use some of the v17_1 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week. This version has no breaking changes.

Here are the highlights:

ShareablePreviewService.GenerateShareablePreviews() generates the URLs for shareable ad previews for enabled and paused asset groups. The URLs are available for a limited amount of time and the expiration date is returned in the response.
AdGroupAdService.RemoveAutomaticallyCreatedAssets() allows you to remove specified automatically created assets linked to Responsive Search Ads.
Support for returning ASSET_GROUP as a new Change Status resource type.
New report for retrieving offline conversion diagnostics, offline_conversion_upload_conversion_action_summary. This supports returning information about the overall health of your conversion upload and adjustment processes at the conversion action level.
Added metrics to the offline diagnostics reports to convey the number of uploaded conversions that are still being processed. See Monitor offline data diagnostics for updated information.
Added segments.sk_ad_network_version which represents the version of the SKAdNetwork API, such as 3.0, 4.0.
Support for segmenting per_store_view based on segments.date.
Support for retrieving information related to standard bidding strategies for video campaigns (Fixed CPM (cost per thousand impression) and Target CPV (cost per view)) using reports.
Added segments.ad_format_type to segment some compatible reports (such as ad_group and campaign based on the video ad format type.

Where can I learn more?
The following resources can help you get started:

If you have any questions or need additional help, contact us via the forum.

- Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Source: Google Ads Developer Blog

Announcing v17 of the Google Ads API

Today, we’re announcing the v17 release of the Google Ads API. To use some of the v17 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week.

Here are the highlights:

To prepare for the resource usage policy change that will happen on June 17, 2024, we added two new values to QuotaError, thrown for excessive resource consumption over a period of time by a query pattern for GoogleAdsService.Search() and GoogleAdsService.SearchStream() requests.
The page_size field is always set to 10,000, and you can no longer pass a page_size to GoogleAdsService.Search. Doing so will result in a RequestError.PAGE_SIZE_NOT_SUPPORTED error.
Added campaign_aggregate_asset_view and channel_aggregate_asset_view for reporting more metrics of Performance Max and Search campaigns.
Changes to batch processing:
- Added support for setting MutateOperation.asset_group_operation when using BatchJobService. This lets you use batch processing to create and manage entire Performance Max campaigns.
- Added the BatchJobError.REQUEST_TOO_LARGE error for submitting a AddBatchJobOperationsRequest that is larger than 10,484,504 bytes. You should divide the operations into smaller groups and send them as a separate request.
Added Campaign.keyword_match_type to allow setting a keyword match type for all keywords in a campaign.
Removed AdService.getAd to align the service with others in the Google Ads API. For recommendations on how to fetch resources, see Retrieving objects.
Added primary_status and primary_status_reasons to AdGroupCriterion to show whether the ad group criterion is serving, or the reasons why it's not serving.
Added a new report shopping_product, which corresponds to the Products page of the Google Ads UI.
Added more validations for ImageAdInfo.image_asset regarding dimensions and format, which makes it more consistent with other image validations in the Google Ads API.
Added segments.sk_ad_network_redistributed_fine_conversion_value, which redistributes NULL values to other values based on a machine learning model on recent SkAdNetwork postback data.
Renamed Discovery to Demand Gen in all fields, enums, errors of all resources across the Google Ads API.
You can now select only fields related to one linked product when querying product_link. Failing to do so will throw QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
Added UserListCustomerTypeService.MutateUserListCustomerTypes() to configure audience customer types. This method replaces the use of CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
Added two expiration_date_time fields local_services_verification_artifact to allow advertisers to better monitor when their artifacts expire.

Where can I learn more?
The following resources can help you get started:

If you have any questions or need additional help, contact us via the forum.

- Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Source: Google Ads Developer Blog

Announcing v202405 of the Google Ad Manager API

We're pleased to announce that v202405 of the Google Ad Manager API is available today. This release brings support for contextual targeting.

It also includes a number of deprecations, such as the removal of the ActivityService, ActivityGroupService, and ACTIVITY reporting dimensions to support the Spotlight deprecation.

For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Source: Google Ads Developer Blog

Announcing v16_1 of the Google Ads API

Today, we’re announcing the v16_1 release of the Google Ads API. To use some of the v16_1 features, upgrade your client libraries and client code. The updated client libraries and code examples will be published next week. This version has no breaking changes.

Here are the highlights:

You can now query assets of Demand Gen campaigns using ad_group_ad_asset_view and asset_field_type_view.
Added SkAdNetworkConversionValueSchema.postback_mappings which supports SKAdNetwork 4.0 features.
You can now retrieve Target ROAS campaign bid simulations for App campaigns using the campaign_simulation report.
Added CustomerNegativeCriterion.ip_block which supports adding an IP as a negative criterion at the customer level.
Added new fields to BrandInfo to return more information such as the text representation of a brand, the status of a brand, etc.
Added customer.video_brand_safety_suitability and BrandSafetySuitability which support returning video brand safety suitability at the customer level.
Added support for warnings for CustomerSkAdNetworkConversionValueSchemaService as MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. When set to true, any non-blocking errors pertaining to operation failures will be returned as MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
Added support for retrieving more information regarding Local Services:
- local_services_lead.credit_details which returns the state of credit and the timestamp when the credit state was updated.
- local_services_lead_conversation.message_details.attachment_urls which returns the URLs that can be used to download the contents of the attachment.

Where can I learn more?

The following resources can help you get started:

If you have any questions or need additional help, contact us via the forum.

- Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Source: Google Ads Developer Blog

Announcing Android Google Mobile Ads SDK Version 23.0.0

Version 23.0.0 of the Android Google Mobile Ads SDK is now available. We recommend upgrading as soon as possible to get our latest features and performance improvements.

The minimum Android API level is 21

Starting in version 23.0.0, the Google Mobile Ads SDK requires all apps to be on a minimum Android API level 21 to run. To adjust the API level, change the value of minSdk in your app-level build.gradle file to 21 or higher.

Ad Manager builder methods can now be chained

In version 23.0.0, AdManagerAdRequest.Builder methods inherited from its parent can be chained together to build an AdManagerAdRequest using a single call:

var newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

A side effect of this change is AdManagerAdRequest.Builder no longer inherits from AdRequest.Builder.

SDK deprecation and sunset timelines activated

With this Android major version 23 launch and the iOS major version 11 launch last month, we are announcing new deprecation and sunset dates for older major releases. Specifically:

Android Google Mobile Ads SDK versions 21.x.x are officially deprecated, and will sunset in Q2 2025.
Android versions 20.x.x and iOS versions 8.x.x will sunset on June 30, 2024.
- While there are currently no plans to disable ad serving on Android versions 20.x.x and iOS versions 8.x.x, we strongly recommend updating to a supported SDK version to avoid being impacted in the future.

For the full list of changes in v23.0.0, check the release notes. Check our migration guide to ensure your mobile apps are ready to upgrade. As always, if you have any questions or need additional help, contact us via the developer forum.

- Jill Song, Mobile Ads Developer Relations

Source: Google Ads Developer Blog

Announcing v16 of the Google Ads API

Today, we’re announcing the v16 release of the Google Ads API. To use some of the v16 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week.
Here are the highlights:

Added the following recommendation types: MAXIMIZE_CONVERSION_VALUE_OPT_IN, IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN, REFRESH_CUSTOMER_MATCH_LIST, CUSTOM_AUDIENCE_OPT_IN, LEAD_FORM_ASSET, IMPROVE_DEMAND_GEN_AD_STRENGTH
Added RecommendationService.GenerateRecommendations() which returns recommendations based on your specified settings, such as recommendation types or advertising channel types. This could be helpful when creating a campaign.
Added support for time-related segments, such as segments.year and segments.month, to asset_group.
Migrated advertising_partner from AccountLink to ProductLink and ProductLinkInvitation, and also removed support for data_partner and google_ads from AccountLink.
Added primary_status and primary_status_reasons to AdGroup and AdGroupAd, respectively, to provide insight into why an ad group or an ad group ad is serving or not serving.
Added support for advertiser verification by adding IdentityVerificationService to allow for programmatically starting a verification session using the provided verification_program and for retrieving all identity verifications.
Added support for setting Campaign.shopping_setting to an existing Demand Gen campaign. The following new fields are added specifically for Demand Gen campaigns:
- ShoppingSetting.disable_product_feed to disable the optional product feed.
- Ad.demand_gen_product_ad containing information about the Demand Gen product ad, such as the business name and headline.
Added Experiment.sync_enabled to let you apply changes made to the original campaign to the experiment campaign, while the experiment is running. This saves time from manually applying changes to the experiment campaign.
Recommended keywords with unset keyword match type will now have recommended_match_type set to UNSPECIFIED instead of UNKNOWN.
Updated the operation types for customer life cycle goals and campaign life cycle goals to make them consistent with other operation types.
Added support for tracking the progress of the business registration verification process of Local Services using LocalServicesVerificationArtifact.business_registration_check_verification_artifact.
Added a new report local_services_employee that lets you retrieve the employee information you've added.

Where can I learn more?
The following resources can help you get started:

If you have any questions or need additional help, contact us via the forum.

- Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Source: Google Ads Developer Blog

Announcing v202402 of the Google Ad Manager API

We're pleased to announce that v202402 of the Google Ad Manager API is available starting today, February 13, 2024. This release brings support for gross revenue metrics in reporting as well as new error messages to support the Spotlight deprecation.

For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Source: Google Ads Developer Blog

Announcing iOS Google Mobile Ads SDK Version 11.0.0

Today, we are announcing that version 11.0.0 of the Google Mobile Ads SDK is now available. We recommend upgrading as soon as possible to get our latest features and performance improvements.

Simplified SwiftUI development

Version 11.0.0 no longer requires publishers to declare a view controller to present full-screen ads. As a result, SwiftUI Publishers can now present full-screen ads without the need for UIKit or UIViewControllerRepresentable workarounds. See our SwiftUI guide for more information.

struct ContentView: View {
  private let adCoordinator = AdCoordinator()

  var body: some View {
    ...

    Button("Watch an ad") {
      adCoordinator.showAd()
    }
  }
}

private class InterstitialAdCoordinator: NSObject, GADFullScreenContentDelegate {
  private var interstitial: GADInterstitialAd?

  ...

  func showAd() {
    guard let interstitial = interstitial else {
      return print("Ad wasn't ready")
    }

    // The SDK uses the app's main window to look up view controllers
    // automatically when one is not provided.
    interstitial.present(fromRootViewController: nil)
  }
}

Continue collecting user metrics in AdMob

The Google Mobile Ads SDK dependency on GoogleAppMeasurement has been removed. This dependency that powered the user metrics toggle in AdMob will be discontinued in early 2024. To continue collecting user metrics in AdMob, link your AdMob app to Firebase and integrate the Google Analytics for Firebase SDK into your app.

Changes to minimum OS and Xcode requirements

The minimum OS version to load ads has been bumped from 12 to 13. Applications can still be built for iOS 12, but the SDK will only load ads on iOS 13 and higher.
The minimum supported Xcode version has been bumped to 15.1.

For the full list of changes, check the release notes. Check our migration guide to ensure your mobile apps are ready to upgrade.

SDK Deprecation Reminder

Per the deprecation schedule, the release of version 11.0.0 means that:

iOS Google Mobile Ads SDK versions 9.x.x are officially deprecated, and will sunset in Q2 2025.
Versions 8.x.x and below will sunset in Q2 2024, approximately 60 days following the release of Android Google Mobile Ads SDK major version 23.0.0.
- While there are currently no plans to disable ad serving on version 8.x.x, we strongly recommend updating to a supported SDK version to avoid being impacted in the future.

As always, if you have any questions or need additional help, contact us via the developer forum.

- Justin Malandruccolo, Mobile Ads Developer Relations

Source: Google Ads Developer Blog

Google Ads API 2024 release and sunset schedule

We’re announcing our tentative 2024 release and sunset schedule for upcoming versions of the Google Ads API to bring greater clarity to your planning cycle. Please keep in mind that these dates are only estimates and may be adjusted going forward. Additionally, releases may be added, removed, or switched between major and minor versions.

Version	Planned Release Type*	Projected launch*	Projected sunset*
V16	Major	January/February 2024	January 2025
V16.1	Minor	April/May 2024	January 2025
V17	Major	May/June 2024	May 2025
V17.1	Minor	July/August 2024	May 2025
V18	Major	September/October 2024	September 2025

*Estimated and subject to change

Where can I learn more?

Check back for any updates as the blog is the best place to stay informed about developments in this space.

If you have any questions or need additional help, contact us via the forum.

- David Stevens, Google Ads API Product Manager

googblogs.com

All Google blogs and Press in one site

Tag Archives: release

Announcing v202408 of the Google Ad Manager API

Source: Google Ads Developer Blog

Announcing v17_1 of the Google Ads API

Source: Google Ads Developer Blog

Announcing v17 of the Google Ads API

Source: Google Ads Developer Blog

Announcing v202405 of the Google Ad Manager API

Source: Google Ads Developer Blog

Announcing v16_1 of the Google Ads API

Source: Google Ads Developer Blog

Announcing Android Google Mobile Ads SDK Version 23.0.0

The minimum Android API level is 21

Ad Manager builder methods can now be chained

SDK deprecation and sunset timelines activated

Source: Google Ads Developer Blog

Announcing v16 of the Google Ads API

Source: Google Ads Developer Blog

Announcing v202402 of the Google Ad Manager API

Source: Google Ads Developer Blog

Announcing iOS Google Mobile Ads SDK Version 11.0.0

Simplified SwiftUI development

Continue collecting user metrics in AdMob

Changes to minimum OS and Xcode requirements

SDK Deprecation Reminder

Source: Google Ads Developer Blog

Google Ads API 2024 release and sunset schedule

Source: Google Ads Developer Blog