Únete a nosotros en vivo en Discord en el servidor de la comunidad de Google Advertising and Measurement y en YouTube el 29 de enero a las 10:00 a.m. (EST). Analizaremos las nuevas funciones que se agregaron en la versión 23 de la API de Google Ads.

Notas de la versión

v23 (28-01-2026)

En la versión 23, se agregaron las siguientes funciones y actualizaciones nuevas.

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

Anuncios

Se agregó AD_SHARING_NOT_ALLOWED a AdGroupAdErrorEnum. Este error se devuelve cuando se intenta compartir un anuncio entre varios grupos de anuncios, lo que ya no se permite.
Se agregaron nuevos tipos de formato a AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK y VERTICAL_ADS_PROMOTION.
Se quitó la compatibilidad con CallAd y CallAdInfo en la versión 23. Consulta https://support.google.com/google-ads/answer/6341403 para obtener más información.

Recursos

Se agregaron métricas adicionales al informe asset_group:
Se agregaron métricas adicionales al informe asset_group_asset:
Se agregó el campo de solo lectura orientation a los recursos de imagen y video en Asset.
Se agregó compatibilidad para recuperar CampaignAsset con field_type HEADLINE y DESCRIPTION.
Se agregaron HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE y DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO a ServedAssetFieldType para los recursos que se publican como vínculos a sitios.
Se actualizaron los recursos de mensaje para la empresa:
- Se agregó compatibilidad con Facebook Messenger y Zalo como proveedores en BusinessMessageAsset, y se agregaron FACEBOOK_MESSENGER y ZALO a BusinessMessageProviderEnum.BusinessMessageProvider, y los nuevos campos facebook_messenger_info y zalo_info a BusinessMessageAsset.
- Se agregó CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS a AssetErrorEnum.

Facturación

Ahora, InvoiceService.ListInvoices puede devolver detalles más específicos en Invoice, incluido el desglose de costos a nivel de la campaña, los costos reglamentarios detallados y la información de ajustes, si se establece include_granular_level_invoice_details en ListInvoicesRequest.
Se agregaron RegulatoryFeeTypeEnum y UnitOfMeasureEnum.

Campañas

Se agregaron los códigos de error CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET y CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Se agregaron Campaign.start_date_time y Campaign.end_date_time para reemplazar Campaign.start_date y Campaign.end_date, lo que permite especificar componentes de tiempo para ciertos tipos de campañas.

Conversiones

Se agregó YOUTUBE_FOLLOW_ON_VIEWS a ConversionActionCategory para admitir el seguimiento de los usuarios que miran un anuncio y, luego, miran un video del mismo canal.

Generación de demanda

Se agregó el campo DemandGenVideoResponsiveAdInfo.companion_banner.
Se quitó el campo lead_form_only de DemandGenMultiAssetAdInfo.

Incentivos

Se agregó compatibilidad con los incentivos de Elige tu propia oferta (CYO), lo que permite a los socios recuperar y aplicar de forma programática los incentivos de Google Ads para sus clientes:
- Se agregó IncentiveService:
  - El método FetchIncentive permite recuperar los incentivos disponibles para un usuario según el país, el idioma y, de manera opcional, el correo electrónico del usuario. Esto puede devolver opciones de incentivos personalizadas de "Elige tu propia aventura" (CYO).
  - El método ApplyIncentive permite aplicar un incentivo seleccionado por el usuario a una cuenta de cliente específica de Google Ads.
- Se agregó el recurso de solo lectura AppliedIncentive, al que se puede consultar a través de GoogleAdsService.Search y GoogleAdsService.SearchStream. Proporciona detalles sobre los incentivos canjeados, incluido su estado, el progreso del cumplimiento, los importes de las recompensas y las fechas relevantes.
- Se agregaron nuevos códigos de error en IncentiveErrorEnum para controlar problemas relacionados con la recuperación o la aplicación de incentivos.
- Se agregó INVALID_EMAIL_ADDRESS a AuthenticationErrorEnum.
Para facilitar el control programático más detallado de las fallas, agregaremos códigos de error adicionales a IncentivesService en versiones futuras. Te recomendamos que supervises los próximos anuncios y las notas de la versión para conocer estos nuevos códigos de error y asegurarte de que tus aplicaciones puedan administrar estos nuevos modos de falla.

Planificación

Se agregó LIFE_EVENT_USER_INTEREST a AudienceInsightsDimensionEnum. Esta nueva dimensión permite a los usuarios crear públicos con Acontecimientos de la vida para los siguientes métodos:
Los eventos de la vida no se admiten en otros métodos de AudienceInsightsService, como AudienceInsightsService.GenerateAudienceOverlap y AudienceInsightsService.GenerateTargetingSuggestionMetrics.
La respuesta de ReachPlanService.GenerateConversionRates ahora incluye plataformas, lo que permite ofrecer diferentes sugerencias de tasas de conversión según los controles de la plataforma (por ejemplo, Gmail y Shorts). Esta opción solo se admite en las campañas de generación de demanda.
Se agregó LanguageDistribution a YouTubeChannelInsights, lo que proporciona la distribución de idiomas en el contenido de los canales de YouTube.
Se agregó BenchmarksService para comparar los datos de los anuncios de YouTube con las comparativas de la industria.
Se agregó AudienceInsightsService.GenerateAudienceDefinition para traducir una descripción de texto libre de un público objetivo en atributos de público coincidentes con IA generativa.
Se agregó YouTubeChannelInsights.relevance_score, que evalúa la relevancia de un creador para un tema ponderado por las vistas.
Se agregó TrendInsightMetrics.trend_change_percent, que representa el cambio porcentual en el valor de una tendencia durante el período de comparación.

Recomendaciones

Se agregó el campo is_new_customer a GenerateRecommendationsRequest. Cuando se establece en true para las recomendaciones de tipo CAMPAIGN_BUDGET, genera recomendaciones con un modelo para clientes nuevos. Esta opción solo se recomienda para los clientes que no tienen campañas.

Informes

Métricas y segmentación
- AdGroupAdAssetView y AdGroupAdAssetCombinationView ahora admiten métricas de impresiones, rendimiento y conversiones para RESPONSIVE_DISPLAY_AD.
- Se agregó el segmento ad_sub_network_type para obtener un desglose más detallado del rendimiento dentro de una red de publicidad. Inicialmente, estará disponible para las campañas de DemandGen en YouTube (in-stream, in-feed y Shorts). Este segmento se debe seleccionar junto con ad_network_type.
- Es el desglose de los tipos de redes de anuncios habilitados para las campañas de máximo rendimiento.
- Ahora, UserLocationView y GeographicView admiten métricas segmentadas por fecha de conversión:
  - conversions_by_conversion_date,
  - all_conversions_by_conversion_date
  - conversions_value_by_conversion_date
  - all_conversions_value_by_conversion_date
  - value_per_conversions_by_conversion_date
  - value_per_all_conversions_by_conversion_date
  - cross_device_conversions_by_conversion_date
  - cross_device_conversions_value_by_conversion_date.
Nuevos segmentos para los anuncios verticales
Vistas nuevas:
- Se agregó PerStoreView para consultar los detalles de la ubicación de la tienda.
- Se agregó MatchedLocationInterestView para las campañas de IA Max, que proporciona métricas de rendimiento desglosadas por ubicaciones geográficas en las que los usuarios mostraron interés.
Performance Max:
- Es el desglose de los tipos de redes de anuncios habilitados para las campañas de máximo rendimiento.
Eliminaciones:
- Se quitaron las métricas de etiquetas de rendimiento de recursos agregados. El enum de la etiqueta de rendimiento ya no se devuelve para la Búsqueda y Display.

Shopping

ShoppingPerformanceView ahora admite las siguientes métricas segmentadas por fecha de conversión: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date y value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView ahora admite las siguientes métricas de la competencia: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share y search_rank_lost_absolute_top_impression_share.
Se agregó product_image_uri a ShoppingProduct.

Anuncios verticales

Se agregó vertical_ads_format_setting a AdGroup para las campañas de búsqueda que utilizan feeds de viajes, lo que permite controlar qué formatos de anuncios se pueden publicar.
Se agregó el tipo de criterio vertical_ads_item_group_rule_list a AdGroupCriterion. Se agregó vertical_ads_item_group_rule a SharedCriterion. Estos criterios permiten segmentar grupos de artículos en campañas de Búsqueda con feeds de viajes.
Ahora puedes conectar un feed de datos de anuncios verticales a una campaña de búsqueda que ejecute IA Max para que muestre anuncios de promoción de la propiedad y anuncios de viajes con vínculo para reservar junto con tus anuncios de texto. A nivel del grupo de anuncios, puedes controlar qué formatos mostrar con vertical_ads_format_setting y definir un conjunto de reglas de grupos de artículos para segmentar un subconjunto de tus entidades del feed de datos de anuncios verticales. Además, ahora los informes se pueden segmentar por AdFormatType y por dimensiones del feed de datos de anuncios verticales.

Video

Se agregó el campo AdVideoAssetInfo.ad_video_asset_feature_control.
Se agregó el código de error CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.
Se agregaron métricas de audibilidad para los anuncios de audio en YouTube, que indican si un anuncio fue audible y en cuántas impresiones se pudo medir la audibilidad.

v22 (2025-10-15)

En la versión 22, se agregaron las siguientes funciones y actualizaciones nuevas.

Recursos

Se agregó LANDING_PAGE_PREVIEW como un nuevo tipo de campo de recurso de imagen.
Se introdujo AssetGenerationService (beta):
- Este servicio permite generar recursos de texto y de imagen con IA generativa. Inicialmente, este servicio solo estará disponible para un conjunto limitado de participantes de la versión beta cerrada.
- GenerateText: Genera texto basado en entradas como la URL final, las instrucciones de formato libre, las palabras clave y el contexto existente de la campaña.
- GenerateImages: Genera imágenes basadas en entradas como la URL final, instrucciones de formato libre, el contexto de la campaña existente o la recontextualización de imágenes de productos existentes.
- Los errores durante la generación de recursos se devuelven con códigos de AssetGenerationErrorEnum.

Campañas

Se agregaron nuevos objetivos de ofertas para las campañas de aplicaciones de instalación (ACi) para realizar optimizaciones sin especificar un objetivo, lo que resulta útil para el escalamiento rápido o cuando determinar el objetivo adecuado es difícil. En AppCampaignBiddingStrategyGoalType: * OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Úsala con la estrategia estándar Maximizar conversiones.
- OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Se usa con la estrategia estándar Maximizar valor de conversión.
Se agregó compatibilidad con el tipo de estrategia de ofertas de porcentaje de participación fijo.
Se agregó Campaign.feed_types, que muestra los tipos de feeds adjuntos a una campaña. En el caso de las campañas de máximo rendimiento, puede indicar la vertical de la empresa, como MERCHANT_CENTER_FEED para el comercio minorista.
Se permitió adjuntar conjuntos compartidos de NEGATIVE_KEYWORDS a campañas de MULTI_CHANNEL (para las campañas de aplicaciones) y LOCAL.

Generación de demanda

Se agregó la estrategia de ofertas de CPC objetivo para las campañas de generación de demanda. Esta estrategia establece ofertas para maximizar los clics con el costo por clic (CPC) objetivo configurado.
- Establece el CPC objetivo a nivel de la campaña con Campaign.target_cpc.
- Anula la configuración a nivel del grupo de anuncios con AdGroup.target_cpc_micros.
Se agregó un nuevo AssetAutomationType: * GENERATE_DESIGN_VERSIONS_FOR_IMAGES: Disponible para DemandGenMultiAssetAds. Si está habilitado, agrega elementos de diseño y textos integrados a los recursos de imagen para crear nuevos recursos de imagen con diferentes relaciones de aspecto. Nuevos DemandGenMultiAssetAds están habilitados de forma predeterminada.
Se agregó un nuevo AssetAutomationType: * GENERATE_VIDEOS_FROM_OTHER_ASSETS: Disponible para DemandGenMultiAssetAds. Si está habilitada, genera videos con otros recursos, como imágenes y texto. Luego, estos videos se pueden usar para crear nuevos DemandGenVideoResponsiveAds. Nuevos DemandGenMultiAssetAds están habilitados de forma predeterminada.
Se cambió el nombre del campo BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros a minimum_budget_amount_micros.

General

Se agregó un límite de 10,000 operaciones por solicitud de AddBatchJobOperations.
Se actualizó el control del campo page_size en ListBatchJobResultsRequest:
- Si page_size no está configurado o es 0, ahora se establece de forma predeterminada en el máximo de 1,000 (anteriormente, se devolvía INVALID_PAGE_SIZE).
- Si page_size supera los 1,000, la API ahora devuelve un error INVALID_PAGE_SIZE (antes se limitaba de forma silenciosa a 1,000).
Se agregó un nuevo código de error: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED para indicar cuándo se superó el límite de tasas de activación del perfil de pagos.

Máximo rendimiento

Se agregaron nuevos valores de AssetAutomationType para las campañas de máximo rendimiento:
- GENERATE_IMAGE_ENHANCEMENT: Permite la creación automática de imágenes mejoradas, como el recorte automático. Habilitada de forma predeterminada.
- GENERATE_IMAGE_EXTRACTION: Habilita la obtención automática de imágenes de las URLs finales. De forma predeterminada, se utiliza el parámetro de configuración de la extensión de imagen dinámica a nivel de la cuenta.
Se quitó AssetPerformanceLabel para las campañas de máximo rendimiento.
La funcionalidad del Campaign.url_expansion_opt_out quitado ahora se administra configurando el AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION en AssetAutomationSetting.
Se agregaron segmentos nuevos para las campañas de máximo rendimiento. Cada uno de estos segmentos solo está disponible para las campañas de máximo rendimiento y no devolverá datos cuando se seleccione cualquier otro tipo de campaña.
- ad_using_product_data: Indica si un anuncio usa datos de productos de un feed de Google Merchant Center.
- ad_using_video: Indica si un anuncio usa un recurso de video.

Planificación

En UserListCrmDataSourceType, se agregó el valor THIRD_PARTY_PARTNER_DATA.
- Se agregaron nuevos códigos de error relacionados con los públicos de socios:
- PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
- PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
- COMMERCE_PARTNER_NOT_ALLOWED
- PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
- PARTNER_MANAGER_ACCOUNT_DISALLOWED
- PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
- ADVERTISER_TOS_NOT_ACCEPTED
- ADVERTISER_PARTNER_LINK_MISSING
- ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
- ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
- INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
Se agregó is_active_live_stream_creator a YouTubeMetrics. ContentCreatorInsightsService.GenerateCreatorInsights devuelve este valor y, además, indica si un creador publicó una transmisión en vivo en los últimos 90 días.
Se agregó un nuevo mensaje PlannableUserListMetadata que contiene UserListCrmDataSourceType en PlannableUserList. "ReachPlanService.ListPlannableUserLists" devuelve este mensaje para mostrar si una fuente de datos de la lista de usuarios del CRM es FIRST_PARTY o THIRD_PARTY_PARTNER_DATA.
En ReachPlanService, se agregó el campo trueview_views, que reemplaza el campo views.
En TrendInsight, se agregó compatibilidad con related_videos y related_creators. También se agregaron metadatos de propiedades de video y fechas de publicación en YouTubeVideoAttributeMetadata.video_properties y YouTubeVideoAttributeMetadata.publish_date.
- AudienceInsightsService.GenerateInsightsFinderReport ahora admite parental_status y income_ranges, además de combinaciones Y/O más complejas de temas y públicos.

Informes

Se agregaron dos tipos de clics nuevos: CLICK_TO_MESSAGE_THIRD_PARTY_CLICK y CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
- Ahora, AssetGroupAsset se puede segmentar por device, conversion_action, conversion_action_name y conversion_action_category.
  - AdGroupAdAssetView y AdGroupAdAssetCombinationView ahora admiten por completo las métricas de rendimiento y conversiones para RESPONSIVE_SEARCH_AD. Anteriormente, en estas vistas, solo se devolvían las impresiones para este tipo de anuncio.
Para facilitar la Exploración de Ofertas inteligentes, ahora se pueden segmentar las siguientes métricas por campos de fecha (date, month, quarter, week, year):
Se agregó un nuevo recurso: TargetingExpansionView, que informa métricas para las expansiones en la segmentación manual, como la expansión sin palabras clave para las campañas potenciadas por IA Max de Búsqueda.
Se agregaron segmentos nuevos para las campañas de máximo rendimiento. Consulta las actualizaciones de las campañas de máximo rendimiento.

### Shopping
Se corrigió el alcance de las métricas de la campaña y el grupo de anuncios en el recurso ShoppingProduct.

Objetivos unificados

Se agregó compatibilidad con los objetivos de retención de clientes para optimizar la reactivación de clientes existentes.
- Configura la segmentación con CampaignRetentionGoalSettings.target_option: * TARGET_SPECIFIC: Solo usa usuarios de las listas de usuarios asociadas a la campaña. (Actualmente, solo se puede usar con una lista de entidades permitidas).
  - TARGET_ALL (predeterminado): Segmenta a todos los usuarios para reactivar su participación.

Video

Se cambiaron los nombres de varias métricas relacionadas con las vistas de video:
- average_cpv ahora es trueview_average_cpv
- video_view_rate ahora es video_trueview_view_rate
- video_views ahora es video_trueview_views
- video_view_rate_in_feed ahora es video_trueview_view_rate_in_feed
- video_view_rate_in_stream ahora es video_trueview_view_rate_in_stream
- video_view_rate_shorts ahora es video_trueview_view_rate_shorts
Se agregaron métricas para el tiempo de reproducción de los anuncios de video:
- video_watch_time_duration_millis: Es el tiempo de reproducción total.
- average_video_watch_time_duration_millis: Es el tiempo de visualización promedio por impresión.

v21 (2025-08-06)

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

IA Max para campañas de Búsqueda

Ahora puedes usar el campo ai_max_setting.enable_ai_max de Campaign para habilitar IA Max para campañas de Búsqueda. IA Max para campañas de Búsqueda expande el alcance de una campaña de Búsqueda a través de la concordancia con términos de búsqueda y permite controlar si se publican los controles de segmentación y de creatividades cuando se configuran. La automatización de recursos de texto y los controles de listas de marcas que se establecieron en solicitudes de versiones anteriores seguirán vigentes hasta que se active y desactive explícitamente IA Max para las campañas de Búsqueda. Se puede usar Campaign.ai_max_setting.bundling_required para determinar si se debe habilitar IA Max para las campañas de Búsqueda para respetar o modificar la automatización de recursos de texto y los controles de listas de marcas. AdGroup.ai_max_ad_group_setting.disable_search_term_matching se puede usar para inhabilitar la concordancia de términos de búsqueda cuando una campaña principal tiene habilitada IA Max para las campañas de Búsqueda. Consulta nuestra entrada de blog Descubre un rendimiento óptimo con IA Max para campañas de Búsqueda.
Se agregó CampaignError.AI_MAX_MUST_BE_ENABLED, que se arroja para las campañas de Búsqueda cuando habilitas FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION sin habilitar IA Max para campañas de Búsqueda en la campaña.
Se agregó compatibilidad para aplicar controles de segmentación a nivel del grupo de anuncios en IA Max para campañas de Búsqueda. Ahora puedes agregar los siguientes criterios a los grupos de anuncios:
- Lista de marcas
- Ubicaciones
- Páginas web (reglas de URL)
Se agregó el ai_max_search_term_ad_combination_view para generar informes sobre el rendimiento de las combinaciones de términos de búsqueda, títulos y páginas de destino. En esta vista, se muestran las búsquedas que activaron tus anuncios y el rendimiento de esas combinaciones específicas. En una versión futura, se incluirá una vista adicional que también incluirá datos de las campañas de máximo rendimiento. Si deseas evitar migrar tu implementación para obtener datos de las campañas de máximo rendimiento, considera esperar a esa versión.
Se agregó AI_MAX como un valor nuevo para el segmento search_term_match_type.

Recursos

Se agregaron los campos terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info y promotion_qr_code_info en PromotionAsset. Los campos de código de barras y código QR se encuentran dentro del objeto promotion_trigger oneof. Consulta el artículo del Centro de ayuda Acerca de los recursos de promoción.
Se agregó FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION a AssetAutomationTypeEnum. Con este parámetro de configuración, puedes controlar la generación automática de recursos de texto y páginas de destino a partir de la URL final en las campañas de Búsqueda.
Se agregó un nuevo servicio AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset para quitar los recursos creados automáticamente de Campaign. Este servicio solo admite la eliminación del recurso de expansión de la URL final.
Se agregó DESCRIPTION_PREFIX a la enumeración ServedAssetFieldType. Esto corrige un problema en el que el served_asset_field_type en ad_group_ad_asset_combination_view era UNKNOWN para los recursos que se publican como prefijo de descripción.

Campañas

Se agregó un nuevo valor de enumeración MISSING_LOCATION_TARGETING a CampaignPrimaryStatusReason. Este nuevo motivo de estado solo se devolverá para las campañas restringidas por ubicación que no especifiquen la segmentación por ubicación. En el caso de las campañas restringidas por ubicación, cualquier intento de agregar segmentación por ubicación fuera del área permitida generará el error de criterio LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.
Se agregó compatibilidad con socios de integración externos en los niveles VideoCustomer.third_party_integration_partners y Campaign.third_party_integration_partners. Consulta el artículo del Centro de ayuda Cómo hacer un seguimiento de las conversiones de aplicaciones con estadísticas de aplicaciones de terceros.
Ahora puedes establecer el campo advertising_partner_ids para un objeto Campaign existente. Anteriormente, este campo solo se podía configurar para una campaña nueva durante su creación. El campo sigue siendo inmutable después de configurarse.
Con una lista compartida de tipo TYPE_PLACEMENT_LIST definida a nivel de la cuenta de administrador, los anunciantes ahora pueden usar criterios de CustomerNegativeCriterion para excluir una lista de posiciones en las cuentas de cliente individuales de los anunciantes.
Se agregó DESCRIPTION_PREFIX a la enumeración ServedAssetFieldType. Esto corrige un problema por el que el served_asset_field_type en ad_group_ad_asset_combination_view era UNKNOWN para los recursos que se publican como prefijo de descripción.
Se agregó compatibilidad con el campo target_roas_tolerance_percent_millis en las estrategias de ofertas MaximizeConversionValue y TargetRoas. TargetRoas.target_roas_tolerance_percent_millis solo está disponible para las estrategias de cartera, que a su vez solo están disponibles para las campañas de Búsqueda.
Se cambió un código de error ProductGroup. Para las solicitudes con fallas parciales habilitadas, se devolverá LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION en lugar de INVALID_LISTING_GROUP_HIERARCHY.
Se agregó un nuevo recurso LocationInterestView que resume el rendimiento de los criterios de interés por ubicación de los grupos de anuncios.

Conversiones

Se agregó ENGAGED_VIEW como un valor nuevo para el segmento conversion_attribution_event_type.
Los clientes ya no tendrán acceso al modo debug_enabled en ConversionUploadService. Si este campo se establece en TRUE, antes se usaba para distinguir el error CLICK_NOT_FOUND de SUCCESS para las importaciones de conversiones avanzadas de clientes potenciales.

Generación de demanda

Se agregó el código de error CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. En el futuro, se mostrará este error cuando se intente establecer un importe de presupuesto muy bajo para una campaña de generación de demanda. Los detalles sobre el presupuesto mínimo requerido se pueden encontrar en el nuevo campo de detalles del error budgetDailyMinimumErrorDetails.

Cambios en la publicidad política de la UE

Estos cambios en la publicidad política de la UE también se realizaron en las versiones v19.2 y v20.1.

Se agregó Campaign.contains_eu_political_advertising. Este campo indica si tu campaña incluye contenido publicitario político segmentado para la Unión Europea. Si este campo se establece en CONTAINS_EU_POLITICAL_ADVERTISING, la campaña dejará de publicarse en la UE a partir del 22 de septiembre de 2025. Las llamadas a la API para crear una campaña nueva fallarán con un error FieldError.REQUIRED si no se configura este campo.

En el caso de las campañas existentes, debes establecer el campo contains_eu_political_advertising antes de intentar cambiar la segmentación por proximidad, ubicación o grupo de ubicaciones a nivel de la campaña o del grupo de anuncios. Las llamadas a la API para crear o actualizar estos criterios de campaña o de grupo de anuncios para las campañas existentes fallarán con un error CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si la campaña no completó la autodeclaración.

En las versiones v19.x y 20.x, aún no se aplica el requisito de establecer este campo, pero se aplicará en el futuro. Este cambio se anunciará con anticipación.
Las pruebas y los experimentos arrojarán un error de ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si las campañas del experimento no declararon por sí mismas si contienen publicidad política segmentada para la Unión Europea.

Máximo rendimiento

Para las campañas de máximo rendimiento nuevas, el valor predeterminado de Campaign.brand_guidelines_enabled ahora es true.
Se agregó el informe campaign_search_term_view. En esta vista, se ofrecen métricas de términos de búsqueda agregadas a nivel de la campaña. En esta vista, también se introduce la compatibilidad de las campañas de máximo rendimiento con los términos de búsqueda.
Se agregó PERFORMANCE_MAX como un valor nuevo para el segmento search_term_match_type.

Planificación

Se agregó un nuevo método ReachPlanService.ListPlannableUserInterests, que permite a los anunciantes descubrir los intereses de los usuarios (afinidad y mercados en el segmento) admitidos por ReachPlanService.GenerateReachForecast. El método admite la búsqueda de tipos de interés específicos del usuario y la consulta de nombres y rutas.
Se agregó AdditionalApplicationInfo a ReachPlanService.ListPlannableUserLists como un campo de entrada opcional.
Se agregó compatibilidad con AudienceInsightsService.ListAudienceInsightsAttributes para recuperar las listas de usuarios de 1P disponibles para el ID de cliente que realiza la solicitud.
Se agregó compatibilidad con las listas de usuarios propias a AudienceInsightsService.GenerateAudienceCompositionInsights para recuperar estadísticas sobre los públicos segmentados para una lista de usuarios. Cualquier solicitud que se dirija a una lista de usuarios solo devolverá el índice de público y solo estará disponible para los siguientes AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.
Se actualizó el tipo de entrada de público a InsightsAudience para AudienceInsightsService.GenerateTargetingSuggestionMetrics. La nueva entrada de público permite una combinación de intereses del usuario con la lógica Y de O, lo que admite métricas de alcance potencial para definiciones de público más personalizadas.
Se agregó la métrica de participación del público a TrendInsightMetrics para obtener la participación de un público en una tendencia.
Se agregaron nuevas categorías relacionadas a KnowledgeGraphAttributeMetadata para que los usuarios puedan filtrar los atributos del Gráfico de conocimiento por categoría.

Informes

Ahora hay una variedad de métricas nuevas disponibles para AssetGroupAsset, ChannelAggregateAssetView y CampaignAggregateAssetView. Además, para ChannelAggregateAssetView y CampaignAggregateAssetView, impressions, que antes se establecía en cero para las campañas de máximo rendimiento, ahora informará su valor real.
Se hizo que el recurso AssetSet se pueda seleccionar con ChangeStatus para que los usuarios puedan obtener más información sobre el recurso de tipo AssetSet o CampaignAssetSet en una sola búsqueda.
Se hizo que el recurso CampaignAssetSet se pueda seleccionar con ChangeStatus para que los usuarios puedan obtener más información sobre el recurso de tipo AssetSet o CampaignAssetSet en una sola consulta.
Se agregó un nuevo segmento search_term_targeting_status que se puede seleccionar en la vista de términos de búsqueda de la campaña.
Se agregó un nuevo final_url_expansion_asset_view.
Se agregó compatibilidad con las métricas value_adjustment y all_value_adjustment en el informe AssetGroup.
Se hizo segmentable por ad_network_type.AssetGroupAsset
Se agregó un nuevo segmento landing_page_source que se puede usar con el recurso landing_page_view.
Se agregó un nuevo segmento search_term_match_source que se puede seleccionar en las vistas de términos de búsqueda y términos de búsqueda de la campaña.
Se agregó un nuevo segmento match_type que se puede seleccionar en la vista de palabras clave.
Se agregó compatibilidad con métricas para clústeres de intención de búsqueda únicos con las siguientes características:
Se agregó un nuevo tipo de clic VEHICLE_ASSETS en la segmentación de click_view para hacer un seguimiento de los clics relacionados con los formatos de anuncios específicos de los recursos de vehículos y generar informes sobre ellos.

Exploración de Ofertas inteligentes para las estrategias de ofertas de ROAS objetivo en la Búsqueda

Ahora puedes habilitar la Exploración de Ofertas inteligentes en las campañas de Búsqueda estableciendo el campo target_roas_tolerance_percent_millis en las estrategias de ofertas MaximizeConversionValue y TargetRoas en cualquier valor divisible por 1,000 entre 10,000 (10%) y 30,000 (30%), inclusive. Las estrategias de ofertas MaximizeConversionValue también requerirán que se establezca el campo target_roas. TargetRoas.target_roas_tolerance_percent_millis solo está disponible para las estrategias de cartera. Consulta nuestra entrada de blog sobre la Exploración de Ofertas inteligentes y el artículo del Centro de ayuda.
Ahora se admiten los informes de diversidad agregados para las siguientes métricas de clústeres de intención de búsqueda únicos. En la IU de Google Ads, está disponible una vista segmentada por tiempo.

Video

Se agregó YouTubeVideoListAsset. También se agregó Asset#youtube_video_list_asset, que se puede usar para crear un vínculo entre un tipo campaign y un tipo YouTubeVideoListAsset. Consulta el artículo del Centro de ayuda Cómo usar los videos relacionados.
Se agregaron campos de metadatos nuevos a YouTubeChannelInsights y YouTubeVideoAttributeMetadata.
Se expusieron nuevos tipos de clics: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK y PRODUCT_ASSETS.
Se agregó el campo allow_non_skippable_in_stream a VideoAdInventoryControl para permitir que los anuncios de video responsivos se publiquen como anuncios in-stream que no se pueden omitir. Esta opción está disponible para las campañas que admiten la combinación del formato que no se puede omitir con otros formatos.
Se agregaron los campos Campaign.VideoCampaignSettings.video_ad_sequence y AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting (solo lectura). Consulta el artículo del Centro de ayuda Acerca de la secuenciación de anuncios de video.
Se agregaron campos de metadatos nuevos a YouTubeChannelInsights y YouTubeVideoAttributeMetadata.
Se agregaron el tipo de criterio VIDEO_LINEUP y el campo video_lineup a CampaignCriterion y AdGroupCriterion. Esta función solo está disponible para las cuentas incluidas en la lista de entidades permitidas. Comunícate con tu representante de desarrollo comercial de Google para obtener más detalles.
Se agregó un informe de idoneidad del contenido a nivel del detalle y del grupo. Consulta el artículo del Centro de ayuda Acerca del informe "Adecuación del contenido".

v20.1 (6/8/2025)

Estos cambios en la publicidad política de la UE también se implementaron en las versiones v19.2 y v21.

Cambios en la publicidad política de la UE

Se agregó Campaign.contains_eu_political_advertising. Este campo indica si tu campaña incluye contenido publicitario político segmentado para la Unión Europea. Si este campo se establece en CONTAINS_EU_POLITICAL_ADVERTISING, la campaña dejará de publicarse en la UE a partir del 22 de septiembre de 2025.

En el caso de las campañas existentes, debes establecer el campo contains_eu_political_advertising antes de intentar cambiar la segmentación por proximidad, ubicación o grupo de ubicaciones a nivel de la campaña o del grupo de anuncios. Las llamadas a la API para crear o actualizar estos criterios de campaña o de grupo de anuncios para las campañas existentes fallarán con un error CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si la campaña no completó la autodeclaración.

En las versiones v19.x y 20.x, aún no se aplica el requisito de establecer este campo, pero se aplicará en el futuro. Este cambio se anunciará con anticipación.
Las pruebas y los experimentos arrojarán un error de ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si las campañas del experimento no declararon por sí mismas si contienen publicidad política segmentada para la Unión Europea.

v20 (2025-06-04)

En la versión 20, se agregaron las siguientes funciones y actualizaciones nuevas.

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

Recursos

Se agregaron varias métricas nuevas y columnas de segmentos para el informe asset_group.

Columnas de métricas

Columnas de segmentación

Campañas

Se agregó compatibilidad para agregar y actualizar palabras clave negativas a nivel de la campaña para las campañas de máximo rendimiento.

Conversiones

Ahora puedes actualizar el campo google_ads_conversion_customer en un cliente existente para habilitar el seguimiento de conversiones de múltiples cuentas o cambiar su cuenta principal existente del seguimiento de conversiones a otra cuenta de administrador.

Nota: Esta función está detrás de una lista de entidades permitidas cerrada. Para usarla, comunícate con tu administrador de cuentas.
Se agregó el campo ClickConversion.user_ip_address. Google Ads no admite la correlación de direcciones IP de los usuarios finales del Espacio Económico Europeo (EEE), el Reino Unido (UK) ni Suiza (CH). Agrega lógica para excluir de forma condicional las direcciones IP compartidas de los usuarios de estas regiones. Asegúrate de proporcionar a los usuarios información clara y completa sobre los datos que recopilas en tus sitios, aplicaciones y otras propiedades, y de obtener su consentimiento cuando lo exija la ley o las políticas aplicables de Google. Consulta la página Acerca de las importaciones de conversiones sin conexión para obtener más detalles.

Generación de demanda

Se agregaron valores nuevos al segmento ad_network_type que permiten segmentar las campañas de generación de demanda por canal:
- MAPS
- GMAIL
- DISCOVER
Se agregaron métricas para las conversiones comparables con otras plataformas:

Recomendaciones

Se agregó compatibilidad con ShoppingSetting durante la creación de la campaña cuando se usa GenerateRecommendationsRequest.
- Se agregó el campo merchant_center_account_id a GenerateRecommendationsRequest para indicar cuándo se deben generar recomendaciones para las campañas de máximo rendimiento para minoristas, en lugar de las campañas de máximo rendimiento estándares.

Planificación

Se agregó AudienceInsightsDimension.YOUTUBE_LINEUP para reemplazar AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP en AudienceInsightsService y ContentCreatorInsightsService. Esta nueva dimensión te permite recuperar estadísticas y metadatos de las selecciones de contenido de YouTube Select (YTS). Se reemplazaron los objetos asociados con YOUTUBE_DYNAMIC_LINEUP, como DynamicLineupAttributeMetadata y AudienceInsightsDynamicLineup, para alinearse con la eliminación más amplia de las combinaciones dinámicas en Google Ads. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregaron AdditionalApplicationInfo y ApplicationInstance en AudienceInsightsService, ContentCreatorInsightsService y ReachPlanService. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se actualizaron AudienceInsightsService y ContentCreatorInsightsService para proporcionar estadísticas más detalladas. Ahora puedes segmentar los datos de los creadores de contenido por dispositivo con los nuevos AudienceInsightsDimension.DEVICE y AudienceInsightsAttribute.device en ambos servicios. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregaron métricas de video agregadas adicionales a GenerateCreatorInsightsResponse para un análisis más integral de los creadores de contenido: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count y is_brand_connect_creator. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregó sub_country_locations a GenerateCreatorInsightsRequest para ContentCreatorInsightsService. Esto permite especificar ubicaciones geográficas secundarias del país para definir mejor las búsquedas de estadísticas de creadores. El campo sub_country_locations solo se admite cuando se usa el campo search_attributes oneof en el campo criteria. Si se proporcionan sub_country_locations con otros tipos de criterios, la solicitud no será válida. Esto permite una segmentación y un análisis geográficos más detallados para las estadísticas de los creadores de contenido. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregó ReachPlanService.ListPlannableUserLists, que devuelve las listas de usuarios propias de un cliente, y se agregó UserListInfo a las opciones de segmentación por público en GenerateReachForecastRequest. Esto te permite recuperar listas de usuarios planificables para un cliente determinado y, luego, generar previsiones de alcance para las campañas segmentadas para esos públicos específicos. Estas mejoras optimizan la planificación del alcance personalizada, ya que incorporan tus datos de público de origen directamente en las previsiones. La previsión de alcance solo está disponible para las cuentas incluidas en la lista de entidades permitidas.

Videos

Se agregaron anuncios de AdFormatType.PAUSE que se publican en videos orgánicos de YouTube en pantallas de TV, lo que se incluye en los informes. Estos anuncios se muestran directamente junto al fotograma de video estático en la pantalla de pausa. Esto no incluye los anuncios de video de las campañas de generación de demanda que se muestran en el panel de anuncios debajo o encima de un video orgánico en pausa, que se registran en AdFormatType.INFEED.