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 paraDemandGenMultiAssetAds. 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 nuevosDemandGenMultiAssetAdsse habilitan de forma predeterminada.
- Se agregó un nuevo
AssetAutomationType:GENERATE_VIDEOS_FROM_OTHER_ASSETS: Disponible paraDemandGenMultiAssetAds. Si está habilitada, genera videos con otros recursos, como imágenes y texto. Luego, estos videos se pueden usar para crear nuevosDemandGenVideoResponsiveAds. Los nuevosDemandGenMultiAssetAdsse 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_TYPEPARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPECOMMERCE_PARTNER_NOT_ALLOWEDPARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPEPARTNER_MANAGER_ACCOUNT_DISALLOWEDPARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATAADVERTISER_TOS_NOT_ACCEPTEDADVERTISER_PARTNER_LINK_MISSINGADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATAACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPEINVALID_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 contieneUserListCrmDataSourceTypeenPlannableUserList. "ReachPlanService.ListPlannableUserLists" devuelve este mensaje para mostrar si una fuente de datos de la lista de usuarios del CRM esFIRST_PARTYoTHIRD_PARTY_PARTNER_DATA.En
ReachPlanService, se agregó el campotrueview_views, que reemplaza el campoviews.En
TrendInsight, se agregó compatibilidad conrelated_videosyrelated_creators. También se agregaron metadatos de propiedades de video y fechas de publicación enYouTubeVideoAttributeMetadata.video_propertiesyYouTubeVideoAttributeMetadata.publish_date.AudienceInsightsService.GenerateInsightsFinderReportahora admiteparental_statusyincome_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. AdGroupAdAssetViewyAdGroupAdAssetCombinationViewahora admiten por completo las métricas de rendimiento y conversiones paraRESPONSIVE_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 estrueview_average_cpvvideo_view_rateahora esvideo_trueview_view_ratevideo_viewsahora esvideo_trueview_viewsvideo_view_rate_in_feedahora esvideo_trueview_view_rate_in_feedvideo_view_rate_in_streamahora esvideo_trueview_view_rate_in_streamvideo_view_rate_shortsahora esvideo_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_maxdeCampaignpara 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 usarCampaign.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 habilitasFINAL_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 segmentosearch_term_match_type.
Recursos
Se agregaron los campos
terms_and_conditions_text,terms_and_conditions_uri,promotion_barcode_infoypromotion_qr_code_infoenPromotionAsset. Los campos de código de barras y código QR se encuentran dentro del objetopromotion_triggeroneof. Consulta el artículo del Centro de ayuda Acerca de los recursos de promoción.Se agregó
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONaAssetAutomationTypeEnum. 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 deCampaign. Este servicio solo admite la eliminación del recurso de expansión de la URL final.Se agregó
DESCRIPTION_PREFIXa la enumeraciónServedAssetFieldType. Esto corrige un problema por el que elserved_asset_field_typeenad_group_ad_asset_combination_vieweraUNKNOWNpara los recursos que se publican como prefijo de descripción.
Campañas
Se agregó un nuevo valor de enumeración
MISSING_LOCATION_TARGETINGaCampaignPrimaryStatusReason. 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 criterioLOCATION_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 unCampaignexistente. 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 deCustomerNegativeCriterionpara excluir una lista de posiciones en las cuentas de cliente individuales de los anunciantes.Se agregó
DESCRIPTION_PREFIXa la enumeraciónServedAssetFieldType. Esto corrige un problema por el que elserved_asset_field_typeenad_group_ad_asset_combination_vieweraUNKNOWNpara los recursos que se publicaban como prefijo de descripción.Se agregó compatibilidad con el campo
target_roas_tolerance_percent_millisen las estrategias de ofertasMaximizeConversionValueyTargetRoas.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 deINVALID_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 segmentoconversion_attribution_event_type.Los clientes ya no tendrán acceso al modo
debug_enabledenConversionUploadService. Este campo, si se establece enTRUE, se usaba anteriormente para distinguir el errorCLICK_NOT_FOUNDdeSUCCESSpara 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 enCONTAINS_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 errorFieldError.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 deCriterionError.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 estrue.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 segmentosearch_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 porReachPlanService.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ó
AdditionalApplicationInfoaReachPlanService.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 siguientesAudienceInsightsDimension:AGE_RANGE,GENDER,AFFINITY_USER_INTEREST,IN_MARKET_USER_INTEREST.Se actualizó el tipo de entrada de público a
InsightsAudienceparaAudienceInsightsService.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,ChannelAggregateAssetViewyCampaignAggregateAssetView. Además, paraChannelAggregateAssetViewyCampaignAggregateAssetView,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 conChangeStatuspara que los usuarios puedan obtener más información sobre el recurso de tipoAssetSetoCampaignAssetSeten una sola consulta.Se hizo que el recurso
CampaignAssetSetse pueda seleccionar conChangeStatuspara que los usuarios puedan obtener más información sobre el recurso de tipoAssetSetoCampaignAssetSeten 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_adjustmentyall_value_adjustmenten el informeAssetGroup.Se puede segmentar por
ad_network_type.AssetGroupAssetSe agregó un nuevo segmento
landing_page_sourceque se puede usar con el recursolanding_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 declick_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 ofertasMaximizeConversionValueyTargetRoascon cualquier valor divisible por 1,000 entre 10,000 (10%) y 30,000 (30%), inclusive. Las estrategias de ofertasMaximizeConversionValuetambién requerirán que se establezca el campotarget_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 tipocampaigny un tipoYouTubeVideoListAsset. Consulta el artículo del Centro de ayuda Cómo usar los videos relacionados.Se agregaron campos de metadatos nuevos a
YouTubeChannelInsightsyYouTubeVideoAttributeMetadata.Se expusieron nuevos tipos de clics:
VIDEO_RELATED_VIDEOS_CLICK,VIDEO_CHANNEL_CLICKyPRODUCT_ASSETS.Se agregó el campo
allow_non_skippable_in_streamaVideoAdInventoryControlpara 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_sequenceyAdGroup.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
YouTubeChannelInsightsyYouTubeVideoAttributeMetadata.Se agregaron el tipo de criterio
VIDEO_LINEUPy el campovideo_lineupaCampaignCriterionyAdGroupCriterion. 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 enCONTAINS_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 deCriterionError.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_valueall_new_customer_lifetime_valueconversions_by_conversion_dateall_conversions_by_conversion_dateconversions_value_by_conversion_dateall_conversions_value_by_conversion_datevalue_per_conversions_by_conversion_datevalue_per_all_conversions_by_conversion_date
Columnas de segmentación
ad_network_typeconversion_actionconversion_action_nameconversion_action_categoryexternal_conversion_sourceconversion_attribution_event_typeconversion_adjustmentconversion_lag_bucketconversion_or_adjustment_lag_bucketnew_versus_returning_customersdeviceslot
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:MAPSGMAILDISCOVER
- Se agregaron métricas para las conversiones comparables con otras plataformas:
platform_comparable_conversions_from_interactions_rateplatform_comparable_conversionsplatform_comparable_conversions_valueplatform_comparable_conversions_value_per_costplatform_comparable_conversions_by_conversion_dateplatform_comparable_conversions_value_by_conversion_dateplatform_comparable_conversions_from_interactions_value_per_interactioncost_per_platform_comparable_conversionvalue_per_platform_comparable_conversionvalue_per_platform_comparable_conversions_by_conversion_datecost_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 enCONTAINS_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 deCriterionError.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 campotall_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_BUDGETASSET_SETCAMPAIGN_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_attributesparaClickConversion.
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 paraImprovePerformanceMaxAdStrengthRecommendation, 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 deCampaignError.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_VIOLATIONCREATION_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_FAILUREBrandGuidelinesMigrationErrorBRAND_GUIDELINES_ALREADY_ENABLEDCANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGNBRAND_GUIDELINES_LOGO_LIMIT_EXCEEDEDCANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDEDAUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTEDTOO_MANY_ENABLE_OPERATIONS
CampaignErrorBRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGNBRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIREDBRAND_GUIDELINES_COLOR_INVALID_FORMATBRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILYBRAND_GUIDELINES_UNSUPPORTED_CHANNELCANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALSCUSTOMER_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_urlchannel_descriptiontop_videos
- Se agregaron nuevos campos de metadatos a
AudienceInsightsAttributeMetadata:youtube_video_metadatauser_interest_attribute_metadataknowledge_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 AdsUpdateDataLinkpara 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.