v22 (2025-10-15)
En la versión 22, 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 agregó LANDING_PAGE_PREVIEWcomo 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, instrucciones de formato libre, palabras clave y el contexto de la campaña existente.
- 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 para instalación de aplicació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, haz lo siguiente:- OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Se usa 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, comoMERCHANT_CENTER_FEEDpara el comercio minorista.
- Se permite adjuntar conjuntos compartidos de NEGATIVE_KEYWORDSa campañas deMULTI_CHANNEL(para campañas de aplicaciones) y campañas deLOCAL.
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.
 
- Establece el CPC objetivo a nivel de la campaña con 
- Se agregó un nuevo AssetAutomationType:- GENERATE_DESIGN_VERSIONS_FOR_IMAGES: Disponible para- DemandGenMultiAssetAds. Si está habilitado, agrega elementos de diseño y recursos de texto integrados en los recursos de imagen para crear recursos de imagen nuevos con diferentes relaciones de aspecto. Los nuevos- DemandGenMultiAssetAdsse habilitan 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. Los nuevos- DemandGenMultiAssetAdsse habilitan de forma predeterminada.
 
- Se cambió el nombre del campo BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_microsaminimum_budget_amount_micros.
General
- Se agregó un límite de 10,000 operaciones por solicitud de AddBatchJobOperations.
- Se actualizó el control del campo page_sizeenListBatchJobResultsRequest:- Si page_sizeno está configurado o es 0, ahora se establece de forma predeterminada en el máximo de 1,000 (anteriormente, se devolvíaINVALID_PAGE_SIZE).
- Si page_sizesupera los 1,000, la API ahora devuelve un errorINVALID_PAGE_SIZE(antes se limitaba de forma silenciosa a 1,000).
 
- Si 
- Se agregó un nuevo código de error:
QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDEDpara indicar cuándo se excedió el límite de tasas de activación del perfil de pagos.
Máximo rendimiento
- Se agregaron nuevos valores de AssetAutomationTypepara las campañas de máximo rendimiento:- GENERATE_IMAGE_ENHANCEMENT: Habilita 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. El valor predeterminado es el parámetro de configuración de la extensión de imagen dinámica a nivel de la cuenta.
 
- Se quitó AssetPerformanceLabelpara las campañas de máximo rendimiento.
- La funcionalidad del elemento Campaign.url_expansion_opt_outquitado ahora se administra configurandoAssetAutomationTypeFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONenAssetAutomationSetting.
- 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 valorTHIRD_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_creatoraYouTubeMetrics.ContentCreatorInsightsService.GenerateCreatorInsightsdevuelve este valor, que indica si un creador publicó una transmisión en vivo en los últimos 90 días.
- Se agregó un nuevo mensaje - PlannableUserListMetadataque contiene- UserListCrmDataSourceTypeen- PlannableUserList. "ReachPlanService.ListPlannableUserLists" devuelve este mensaje para mostrar si una fuente de datos de la lista de usuarios del CRM es- FIRST_PARTYo- THIRD_PARTY_PARTNER_DATA.
- En - ReachPlanService, se agregó el campo- trueview_views, que reemplaza el campo- views.
- En - TrendInsight, se agregó compatibilidad con- related_videosy- related_creators. También se agregaron metadatos de propiedades de video y fechas de publicación en- YouTubeVideoAttributeMetadata.video_propertiesy- YouTubeVideoAttributeMetadata.publish_date.
- AudienceInsightsService.GenerateInsightsFinderReportahora admite- parental_statusy- income_ranges, además de combinaciones AND/OR más complejas de temas y públicos.
Informes
- Se agregaron dos tipos de clics nuevos: CLICK_TO_MESSAGE_THIRD_PARTY_CLICKyCLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
- Ahora, AssetGroupAssetse puede segmentar pordevice,conversion_action,conversion_action_nameyconversion_action_category.
- AdGroupAdAssetViewy- AdGroupAdAssetCombinationViewahora admiten por completo las métricas de rendimiento y conversiones para- RESPONSIVE_SEARCH_AD. Anteriormente, solo se devolvían las impresiones para este tipo de anuncio en estas vistas.
- Para facilitar la Exploración de Ofertas inteligentes, las siguientes métricas ahora se pueden segmentar 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.
- 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 con la campaña. (Actualmente, solo se permite la lista de entidades permitidas).
- TARGET_ALL(Predeterminado): Segmenta a todos los usuarios para reactivar su participación.
 
 
- Configura la segmentación con 
Video
- Se cambiaron los nombres de varias métricas relacionadas con las vistas de video:
- average_cpvahora es- trueview_average_cpv
- video_view_rateahora es- video_trueview_view_rate
- video_viewsahora es- video_trueview_views
- video_view_rate_in_feedahora es- video_trueview_view_rate_in_feed
- video_view_rate_in_streamahora es- video_trueview_view_rate_in_stream
- video_view_rate_shortsahora 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 reproducción promedio por impresión.
 
v21 (6/8/2025)
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_maxde- Campaignpara 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 creatividades cuando se configuran. Se seguirán respetando los controles de automatización de recursos de texto y de listas de marcas que se establecieron en solicitudes de versiones anteriores 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_requiredpara determinar si se debe habilitar IA Max para las campañas de Búsqueda para respetar o modificar los controles de automatización de recursos de texto y de listas de marcas.- AdGroup.ai_max_ad_group_setting.disable_search_term_matchingse puede usar para inhabilitar la concordancia con 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_AUTOMATIONsin 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_viewpara 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_MAXcomo 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_infoy- promotion_qr_code_infoen- PromotionAsset. Los campos de código de barras y código QR se encuentran dentro del objeto- promotion_triggeroneof. Consulta el artículo del Centro de ayuda Acerca de los recursos de promoción.
- Se agregó - FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONa- 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.RemoveCampaignAutomaticallyCreatedAssetpara 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_PREFIXa la enumeración- ServedAssetFieldType. Esto corrige un problema por el que el- served_asset_field_typeen- ad_group_ad_asset_combination_viewera- UNKNOWNpara los recursos que se publican como prefijo de descripción.
Campañas
- Se agregó un nuevo valor de enumeración - MISSING_LOCATION_TARGETINGa- CampaignPrimaryStatusReason. Este nuevo motivo de estado solo se devolverá para las campañas restringidas por ubicación que no especifiquen la segmentación geográfica. En el caso de las campañas restringidas por ubicación, cualquier intento de agregar segmentación geográfica 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_partnersy 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_idspara un- Campaignexistente. Anteriormente, este campo solo se podía establecer para una campaña nueva durante su creación. El campo sigue siendo inmutable después de establecerse.
- Con una lista compartida del tipo - TYPE_PLACEMENT_LISTdefinida a nivel de la cuenta de administrador, los anunciantes ahora pueden usar criterios de- CustomerNegativeCriterionpara excluir una lista de posiciones en las cuentas de cliente individuales de los anunciantes.
- Se agregó - DESCRIPTION_PREFIXa la enumeración- ServedAssetFieldType. Esto corrige un problema por el que el- served_asset_field_typeen- ad_group_ad_asset_combination_viewera- UNKNOWNpara los recursos que se publicaban como prefijo de descripción.
- Se agregó compatibilidad con el campo - target_roas_tolerance_percent_millisen las estrategias de ofertas- MaximizeConversionValuey- TargetRoas.- TargetRoas.target_roas_tolerance_percent_millissolo 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. En el caso de las solicitudes con una falla parcial habilitada, se devolverá- LISTING_GROUP_ERROR_IN_ANOTHER_OPERATIONen lugar de- INVALID_LISTING_GROUP_HIERARCHY.
- Se agregó un nuevo recurso - LocationInterestViewque resume el rendimiento de los criterios de interés por ubicación del grupo de anuncios.
Conversiones
- Se agregó - ENGAGED_VIEWcomo un valor nuevo para el segmento- conversion_attribution_event_type.
- Los clientes ya no tendrán acceso al modo - debug_enableden- ConversionUploadService. Este campo, si se establece en- TRUE, se usaba anteriormente para distinguir el error- CLICK_NOT_FOUNDde- SUCCESSpara 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 errorbudgetDailyMinimumErrorDetails.
Cambios en la publicidad política de la UE
Estos cambios en la publicidad política de la UE también se implementaron 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.REQUIREDsi no se establece este campo.- En el caso de las campañas existentes, debes establecer el campo - contains_eu_political_advertisingantes 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 grupo de anuncios para las campañas existentes fallarán con un error de- CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONsi 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 - ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONsi 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_enabledahora es- true.
- Se agregó el informe - campaign_search_term_view. Esta vista ofrece 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_MAXcomo 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 usuarios en el mercado) 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 de acceso.
- Se agregó - AdditionalApplicationInfoa- ReachPlanService.ListPlannableUserListscomo un campo de entrada opcional.
- Se agregó compatibilidad con - AudienceInsightsService.ListAudienceInsightsAttributespara recuperar las listas de usuarios propias disponibles para el ID de cliente que realiza la solicitud.
- Se agregó compatibilidad con las listas de usuarios propias a - AudienceInsightsService.GenerateAudienceCompositionInsightspara recuperar estadísticas sobre los públicos segmentados para una lista de usuarios. Cualquier solicitud que tenga como objetivo 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 - InsightsAudiencepara- AudienceInsightsService.GenerateTargetingSuggestionMetrics. La nueva entrada de público permite una combinación de intereses del usuario con la lógica AND-of-ORs, lo que admite métricas de alcance potencial para definiciones de público más personalizadas.
- Se agregó el parámetro de público compartido a - TrendInsightMetricspara obtener la proporción de un público para una tendencia.
- Se agregaron nuevas categorías relacionadas a - KnowledgeGraphAttributeMetadatapara que los usuarios puedan filtrar los atributos del Gráfico de conocimiento por categoría.
Informes
- Ahora hay disponible una variedad de métricas nuevas para - AssetGroupAsset,- ChannelAggregateAssetViewy- CampaignAggregateAssetView. Además, para- ChannelAggregateAssetViewy- 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 - AssetSetse pueda seleccionar con- ChangeStatuspara que los usuarios puedan obtener más información sobre el recurso de tipo- AssetSeto- CampaignAssetSeten una sola consulta.
- Se hizo que el recurso - CampaignAssetSetse pueda seleccionar con- ChangeStatuspara que los usuarios puedan obtener más información sobre el recurso de tipo- AssetSeto- CampaignAssetSeten una sola consulta.
- Se agregó un segmento nuevo - search_term_targeting_statusque 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_adjustmenty- all_value_adjustmenten el informe- AssetGroup.
- Se puede segmentar por - ad_network_type.- AssetGroupAsset
- Se agregó un nuevo segmento - landing_page_sourceque se puede usar con el recurso- landing_page_view.
- Se agregó un nuevo segmento - search_term_match_sourceque 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_typeque 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 lo siguiente: 
- Se agregó un nuevo tipo de clic - VEHICLE_ASSETSen la segmentación de- click_viewpara hacer un seguimiento de los clics relacionados con los formatos de anuncio 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 configurando el campo - target_roas_tolerance_percent_millisen las estrategias de ofertas- MaximizeConversionValuey- TargetRoascon cualquier valor divisible por 1,000 entre 10,000 (10%) y 30,000 (30%), inclusive. Las estrategias de ofertas- MaximizeConversionValuetambién requerirán que se establezca el campo- target_roas.- TargetRoas.target_roas_tolerance_percent_millissolo está disponible para las estrategias de cartera. Consulta nuestra entrada de blog sobre la Exploración de las 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- campaigny un tipo- YouTubeVideoListAsset. Consulta el artículo del Centro de ayuda Cómo usar los videos relacionados.
- Se agregaron campos de metadatos nuevos a - YouTubeChannelInsightsy- YouTubeVideoAttributeMetadata.
- Se expusieron nuevos tipos de clics: - VIDEO_RELATED_VIDEOS_CLICK,- VIDEO_CHANNEL_CLICKy- PRODUCT_ASSETS.
- Se agregó el campo - allow_non_skippable_in_streama- VideoAdInventoryControlpara 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 no saltable con otros formatos.
- Se agregaron los campos - Campaign.VideoCampaignSettings.video_ad_sequencey- AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting(de 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 - YouTubeChannelInsightsy- YouTubeVideoAttributeMetadata.
- Se agregaron el tipo de criterio - VIDEO_LINEUPy el campo- video_lineupa- CampaignCriteriony- 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 "Idoneidad 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_advertisingantes 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 grupo de anuncios para las campañas existentes fallarán con un error de- CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONsi 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 - ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONsi las campañas del experimento no declararon por sí mismas si incluyen publicidad política que se segmenta 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
- new_customer_lifetime_value
- all_new_customer_lifetime_value
- 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
Columnas de segmentación
- ad_network_type
- conversion_action
- conversion_action_name
- conversion_action_category
- external_conversion_source
- conversion_attribution_event_type
- conversion_adjustment
- conversion_lag_bucket
- conversion_or_adjustment_lag_bucket
- new_versus_returning_customers
- device
- slot
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_customeren un cliente existente para habilitar el seguimiento de conversiones de múltiples cuentas o cambiar su cuenta principal existente del seguimiento de conversiones a una cuenta de administrador diferente.
- Se agregó el campo - ClickConversion.user_ip_address. Google Ads no admite la correlación de direcciones IP para los usuarios finales del Espacio Económico Europeo (EEE), el Reino Unido (RU) o Suiza (CH). Agrega lógica para excluir de forma condicional el uso compartido de direcciones IP 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_typeque 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:
- platform_comparable_conversions_from_interactions_rate
- platform_comparable_conversions
- platform_comparable_conversions_value
- platform_comparable_conversions_value_per_cost
- platform_comparable_conversions_by_conversion_date
- platform_comparable_conversions_value_by_conversion_date
- platform_comparable_conversions_from_interactions_value_per_interaction
- cost_per_platform_comparable_conversion
- value_per_platform_comparable_conversion
- value_per_platform_comparable_conversions_by_conversion_date
- cost_converted_currency_per_platform_comparable_conversion
 
Recomendaciones
- Se agregó compatibilidad con ShoppingSettingdurante la creación de la campaña cuando se usaGenerateRecommendationsRequest.
- Se agregó el campo merchant_center_account_idaGenerateRecommendationsRequestpara indicar cuándo se deben generar recomendaciones para el comercio minorista, en lugar de las campañas de máximo rendimiento estándares.
Planificación
- Se agregó AudienceInsightsDimension.YOUTUBE_LINEUPpara reemplazarAudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUPenAudienceInsightsServiceyContentCreatorInsightsService. 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 conYOUTUBE_DYNAMIC_LINEUP, comoDynamicLineupAttributeMetadatayAudienceInsightsDynamicLineup, para alinearse con la eliminación más amplia de las alineaciones dinámicas en Google Ads. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
- Se agregaron AdditionalApplicationInfoyApplicationInstanceenAudienceInsightsService,ContentCreatorInsightsServiceyReachPlanService. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
- Se actualizaron AudienceInsightsServiceyContentCreatorInsightsServicepara proporcionar estadísticas más detalladas. Ahora puedes segmentar los datos de los creadores de contenido por dispositivo con los nuevos camposAudienceInsightsDimension.DEVICEyAudienceInsightsAttribute.deviceen 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 GenerateCreatorInsightsResponsepara 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_countyis_brand_connect_creator. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
- Se agregó sub_country_locationsaGenerateCreatorInsightsRequestparaContentCreatorInsightsService. Esto permite especificar ubicaciones geográficas secundarias para definir mejor las búsquedas de estadísticas de creadores. El camposub_country_locationssolo se admite cuando se usa el camposearch_attributesoneof en el campocriteria. Si se proporcionansub_country_locationscon 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 de origen que posee un cliente, y se agregóUserListInfoa las opciones de segmentación por público enGenerateReachForecastRequest. 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 personalizado, ya que incorporan tus datos de público de origen directamente en las previsiones. El pronóstico de alcance solo está disponible para las cuentas incluidas en la lista de entidades permitidas.
Videos
- Se agregaron anuncios de AdFormatType.PAUSEque se publican en videos orgánicos de YouTube en pantallas de TV, los cuales se incluyen en los informes. Estos anuncios se muestran directamente junto al fotograma estático del video 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 pausado, que se registran enAdFormatType.INFEED.
v19.2 (6/8/2025)
Estos cambios en la publicidad política de la UE también se implementaron en las versiones v20.1 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_advertisingantes 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 grupo de anuncios para las campañas existentes fallarán con un error de- CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONsi 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. Espera el anuncio de este cambio. 
- Las pruebas y los experimentos arrojarán un error - ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATIONsi las campañas del experimento no declararon por sí mismas si incluyen publicidad política que se segmenta para la Unión Europea.
v19.1 (2025-04-16)
En la versión 19.1, se agregaron las siguientes funciones y cambios:
Recursos
- Se agregó un campo asset_coverageparaAssetGroupque devuelve información sobre las brechas en tu grupo de recursos.- Contiene un subcampo ad_strength_action_itemsque devuelve una lista de acciones que un anunciante puede realizar para mejorar la calidad del anuncio de un grupo de recursos.
 
- Contiene un subcampo 
Campañas
- Ahora puedes calificar los clientes potenciales o proporcionar comentarios sobre ellos en las campañas de Servicios Locales. Como parte de este cambio, la versión 19.1 - Se agregó un nuevo servicio llamado LocalServicesLeadService. Puedes usar el métodoProvideLeadFeedbackpara subir calificaciones y comentarios sobre los clientes potenciales.
- Se agregó un nuevo campo llamado lead_feedback_submittedaLocalServicesLeadpara ayudar a determinar si se envió comentarios sobre un cliente potencial.
 
- Se agregó un nuevo servicio llamado 
- Se agregó una nueva columna de métricas
biddable_cohort_app_post_install_conversionspara las campañas de aplicaciones.
Generación de demanda
- Se incorporaron métodos adicionales en los servicios de planificación para admitir las campañas de generación de demanda.
- Se agregó compatibilidad con los controles de canal a nivel del grupo de anuncios para las campañas de generación de demanda. Puedes seleccionar una agrupación general predefinida de canales o un subconjunto de canales con el campo - demand_gen_ad_group_settings. En la versión actual, se admiten los siguientes canales:- Anuncio in-stream de YouTube
- In-feed de YouTube
- YouTube Shorts
- Descubre
- Gmail
- Display
 
- Se expuso un nuevo tipo de recurso para - TALL_PORTRAIT_MARKETING_IMAGE. Este tipo de recurso se relaciona con el campo- tall_portrait_marketing_imagesdel formato de anuncio de recursos múltiples de las campañas de Generación de demanda.
Historial de cambios
- Se agregó compatibilidad con tres tipos de recursos más en ChangeStatusResourceType:
- CAMPAIGN_BUDGET
- ASSET_SET
- CAMPAIGN_ASSET_SET
 
- Puedes recuperar estos tres tipos más detallados del informe change_status.
Conversiones
- Ahora puedes establecer el campo - google_ads_conversion_customercuando creas un cliente nuevo con la API de Google Ads. Antes, este era un campo de solo lectura.- NOTA: Esta función se encuentra detrás de una lista de entidades permitidas cerrada. Para usarla, comunícate con tu administrador de cuentas. 
- Ahora puedes especificar el tipo de cliente asociado con la conversión cuando subas conversiones sin conexión. 
- Se agregó un nuevo campo - session_attributespara- ClickConversion.
Anuncios de Servicios Locales
- Se agregó una nueva RPC ProvideLeadFeedbackaLocalServicesLeadServicepara proporcionar comentarios sobre la calidad deLocalServicesLead.
- Se agregó un nuevo campo lead_feedback_submittedal recursoLocalServicesLeadque confirma si se proporcionó comentarios para un recurso específico.
Servicios de planificación
- Se agregó compatibilidad con las previsiones mensuales de la frecuencia objetivo en ReachPlanService.GenerateReachForecast.- Los desarrolladores pueden establecer TargetFrequencyTimeUnit.MONTHLYenTargetFrequencySettingscuando usan el código de producto planificableTARGET_FREQUENCYpara generar una previsión del alcance mensual de la frecuencia objetivo.
 
- Los desarrolladores pueden establecer 
- Se agregó un nuevo método ReachPlanService.GenerateConversionRatesque permite a los anunciantes solicitar porcentajes de conversiones sugeridos para los productos compatibles que se pueden planificar.
- Previsión de las campañas de generación de demanda en ReachPlanService.GenerateReachForecast:- Ahora los desarrolladores pueden solicitar previsiones de alcance para las campañas de generación de demanda.
Los desarrolladores pueden usar el nuevo código de producto planificable DEMAND_GEN_MAX_CONVERSIONSpara generar previsiones de alcance de las campañas de generación de demanda.
- Se agregó un nuevo campo conversion_rateque permite a los desarrolladores que solicitan previsiones de alcance de las campañas de generación de demanda proporcionar un porcentaje de conversiones. Las tasas de conversión sugeridas se pueden recuperar con el nuevo métodoReachPlanService.GenerateConversionRates. Este campo es obligatorio para las solicitudes de previsión de las campañas de generación de demanda. No se admite para otros productos planificables.
- Se agregó un nuevo campo conversionsa los pronósticos devueltos. Este campo contiene la cantidad de conversiones en un punto determinado de la curva de alcance. Las conversiones solo se admiten para el producto planificableDEMAND_GEN_MAX_CONVERSIONS.
 
- Ahora los desarrolladores pueden solicitar previsiones de alcance para las campañas de generación de demanda.
Los desarrolladores pueden usar el nuevo código de producto planificable 
Recomendaciones
- El nuevo campo - ad_strengthestá disponible para- ImprovePerformanceMaxAdStrengthRecommendation, que devuelve la puntuación actual de la calidad del anuncio del grupo de recursos asociado con la recomendación.- Shopping
- Ahora puedes anular las exclusiones de marca para los anuncios de Shopping en las campañas de máximo rendimiento. Esta opción se expone a través de un nuevo campo - pmax_campaign_settingsa nivel de la campaña y solo funciona para las campañas de máximo rendimiento para el comercio minorista. Se arrojará un error nuevo de- CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTEDsi intentas establecer este campo para un tipo de campaña incompatible.
Videos
- Se agregó compatibilidad de solo lectura para los anuncios de audio. Consulta el Centro de ayuda de Google Ads para obtener más información sobre esta función. Este cambio expone lo siguiente:
- Un nuevo AdvertisingChannelSubTypellamadoYOUTUBE_AUDIO.
- Un nuevo AdGroupTypellamadoYOUTUBE_AUDIO.
- Se agregó una nueva enumeración de formato de anuncio llamada YOUTUBE_AUDIO_ADy sus camposYouTubeAudioAdInfocorrespondientes.
 
- Un nuevo 
- Se agregaron nuevas métricas y segmentos a las métricas de alcance de la búsqueda con ajuste demográfico. Como parte de estos cambios, sucederá lo siguiente:
- Se introdujeron dos columnas de métricas nuevas llamadas coviewed_impressionsyprimary_impressions.
- Se introdujeron dos segmentos nuevos llamados adjusted_age_rangeyadjusted_gender.
- Si se selecciona cualquiera de los dos segmentos nuevos junto con un campo de métrica de alcance (coviewed_impressions,primary_impressions,unique_usersoaverage_impression_frequency_per_user), también se debe seleccionar el otro segmento para recuperar estadísticas válidas para estas columnas.
- Actualmente, esta función solo está disponible para los clientes incluidos en la lista de anunciantes permitidos.
 
- Se introdujeron dos columnas de métricas nuevas llamadas 
v19 (26/2/2025)
En la versión 19, se agregaron las siguientes funciones y cambios:
Consulta Cómo actualizar a la versión más reciente para obtener orientación.
Administración de cuentas
- Se agregaron los siguientes valores a CustomerErrorpara tener en cuenta los próximos cambios:- CREATION_DENIED_FOR_POLICY_VIOLATION
- CREATION_DENIED_INELIGIBLE_MCC
 
Anuncios
- Se agregó DemandGenMultiAssetAdInfo.tall_portrait_marketing_imagespara admitir recursos de imagen verticales con una relación de aspecto de 9:16 en los anuncios de generación de demanda.
Recursos
- (Solo para cuentas incluidas en la lista de entidades permitidas) Se agregó compatibilidad con los recursos de mensaje a través de Asset.business_message_asset,BusinessMessageAssety los siguientes enums y errores.- Enumeraciones:
 
- Se agregó AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEWpara admitir la generación automática de una vista previa de la página de destino.
- AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOSahora está habilitado de forma predeterminada para los anuncios adaptables de video de las campañas de generación de demanda.
- (Solo para cuentas incluidas en la lista de entidades permitidas; actualmente, la lista está cerrada) Se agregaron Asset.app_deep_link_assetyAppDeepLinkAsset.
Conversiones
- Objetivos de conversión
- LifecycleGoalValueSettings.high_lifetime_valuedejó de ser beta y ahora es mutable.
- Se agregó CustomerLifecycleGoal.owner_customerpara mostrar el nombre del recurso del cliente propietario del objetivo de ciclo de vida del cliente.
 
- ConversionActionType.SALESFORCEquedó obsoleto.
Feeds
- Se quitaron todas las entidades relacionadas con el feed, como Feed,FeedMapping,FeedService,AdGroupFeed,feed_placeholder_view, etcétera. Ahora, los usuarios deben usarassetspara lograr el mismo objetivo.
Hotel y viajes
- Se convirtieron min_daysymax_daysdeValueRuleItineraryAdvanceBookingWindowen un campooptionalpara permitir especificar 0 como valor. Esto admite la segmentación para las búsquedas de viajes que se realizan hoy.
Máximo rendimiento
- (Solo para cuentas incluidas en la lista de anunciantes permitidos) Lineamientos de desarrollo de la marca
- Solo se puede modificar Campaign.brand_guidelines_enabledcuando se crea una campaña de máximo rendimiento.
- Esta opción es incompatible con las campañas de máximo rendimiento para objetivos de viaje.
- Para habilitar los lineamientos de desarrollo de la marca en las campañas de máximo rendimiento existentes, usa un CampaignService.EnablePMaxBrandGuidelinesagregado recientemente. No se admite la inhabilitación de los lineamientos de la marca.
- Se agregaron Campaign.brand_guidelinesyBrandGuidelinespara permitir la configuración de los colores y la familia de fuentes de la marca.
- Nuevos valores de error:
- BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
- BrandGuidelinesMigrationError
- BRAND_GUIDELINES_ALREADY_ENABLED
- CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
- BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
- CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
- AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
- TOO_MANY_ENABLE_OPERATIONS
 
- CampaignError
- BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
- BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
- BRAND_GUIDELINES_COLOR_INVALID_FORMAT
- BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
- BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
- CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
- CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
 
- Solo se puede modificar 
- Se agregó AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOSpara admitir la generación automática de recursos de video mejorados para las campañas de máximo rendimiento.
Planificación
- (Solo para las cuentas incluidas en la lista de entidades permitidas) Se agregó ContentCreatorInsightsService.GenerateTrendingInsights, que permite a los usuarios ver los temas de contenido populares en YouTube para las definiciones de público determinadas.
- Se agregó GenerateCreatorInsightsRequest.country_locations[]para especificar los países en los que se buscarán los criterios determinados.
- Se agregó GenerateCreatorInsightsRequest.search_brandpara especificar una marca para buscar creadores
- Se agregaron campos nuevos a YouTubeChannelInsightspara proporcionar información adicional del canal para las solicitudes desearch_channels:- channel_url
- channel_description
- top_videos
 
- Se agregaron nuevos campos de metadatos a AudienceInsightsAttributeMetadata:- youtube_video_metadata
- user_interest_attribute_metadata
- knowledge_graph_attribute_metadata
 
Videos
- Después del lanzamiento de DataLinkService.CreateDataLink, agregamos los siguientes métodos para permitir la modificación de los vínculos de datos creados anteriormente:- RemoveDataLinkpara quitar vínculos de datos en una cuenta de Google Ads
- UpdateDataLinkpara aceptar, rechazar y revocar vínculos de datos en una cuenta de Google Ads
 
- Se quitó la compatibilidad con VIDEO_OUTSTREAMde las siguientes enumeraciones:
Notas de la versión archivadas
Consulta Versiones descontinuadas para ver las notas de la versión archivadas.