v21 (6/8/2025)
IA Max para campañas de Búsqueda
Ahora puedes usar el campo
ai_max_setting.enable_ai_max
deCampaign
para habilitar IA Max para las 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. Los controles de automatización de recursos de texto y 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 usarCampaign.ai_max_setting.bundling_required
para 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_matching
se 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 Desbloquea 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_AUTOMATION
sin habilitar IA Max para las 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 segmentosearch_term_match_type
.
Recursos
Se agregaron los campos
terms_and_conditions_text
,terms_and_conditions_uri
,promotion_barcode_info
ypromotion_qr_code_info
enPromotionAsset
. Los campos de código de barras y código QR se encuentran dentro del elementopromotion_trigger
oneof.Se agregó
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
aAssetAutomationTypeEnum
. 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 deCampaign
. Este servicio solo admite la eliminación del recurso de expansión de la URL final.Se agregó
DESCRIPTION_PREFIX
a la enumeraciónServedAssetFieldType
. Esto corrige un problema por el que elserved_asset_field_type
enad_group_ad_asset_combination_view
eraUNKNOWN
para los recursos que se publican como prefijo de descripción.
Campañas
Se agregó un nuevo valor de enumeración
MISSING_LOCATION_TARGETING
aCampaignPrimaryStatusReason
. 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 por ubicación 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_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 objetoCampaign
existente. Anteriormente, este campo solo se podía establecer para una campaña nueva durante su creación.Con una lista compartida del tipo
TYPE_PLACEMENT_LIST
definida a nivel de la cuenta de administrador, los anunciantes ahora pueden usar criterios deCustomerNegativeCriterion
para excluir una lista de posiciones en las cuentas de cliente individuales de los anunciantes.Se agregó
DESCRIPTION_PREFIX
a la enumeraciónServedAssetFieldType
. Esto corrige un problema por el que elserved_asset_field_type
en elad_group_ad_asset_combination_view
eraUNKNOWN
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 ofertasMaximizeConversionValue
yTargetRoas
.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
. En el caso de las solicitudes con una falla parcial habilitada, se devolveráLISTING_GROUP_ERROR_IN_ANOTHER_OPERATION
en lugar deINVALID_LISTING_GROUP_HIERARCHY
.Se agregó un nuevo recurso
LocationInterestView
que resume el rendimiento de los criterios de interés por ubicación del grupo de anuncios.
Conversiones
Se agregó
ENGAGED_VIEW
como un valor nuevo para el segmentoconversion_attribution_event_type
.Los clientes ya no tendrán acceso al modo
debug_enabled
enConversionUploadService
. Este campo, si se establece enTRUE
, se usaba anteriormente para distinguir el errorCLICK_NOT_FOUND
deSUCCESS
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 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 contiene 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.REQUIRED
si no se establece 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 grupo de anuncios para las campañas existentes fallarán con un error deCriterionError.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
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 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 incluye 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 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) que admiteReachPlanService.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ó
AdditionalApplicationInfo
aReachPlanService.ListPlannableUserLists
como un campo de entrada opcional.Se agregó compatibilidad con
AudienceInsightsService.ListAudienceInsightsAttributes
para 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.GenerateAudienceCompositionInsights
para 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
InsightsAudience
paraAudienceInsightsService.GenerateTargetingSuggestionMetrics
. La nueva entrada de público permite una combinación de Y de O de los intereses del usuario, 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
TrendInsightMetrics
para obtener la proporción de un público para 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 disponible una variedad de métricas nuevas para
AssetGroupAsset
,ChannelAggregateAssetView
yCampaignAggregateAssetView
. Además, paraChannelAggregateAssetView
yCampaignAggregateAssetView
,impressions
, que antes se establecía en cero para las campañas de máximo rendimiento, ahora mostrará su valor real.Se hizo que el recurso
AssetSet
se pueda seleccionar conChangeStatus
para que los usuarios puedan obtener más información sobre el recurso de tipoAssetSet
oCampaignAssetSet
en una sola consulta.Se hizo que el recurso
CampaignAssetSet
se pueda seleccionar conChangeStatus
para que los usuarios puedan obtener más información sobre el recurso de tipoAssetSet
oCampaignAssetSet
en una sola consulta.Se agregó un segmento nuevo
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
yall_value_adjustment
en el informeAssetGroup
.Se puede segmentar
AssetGroupAsset
porad_network_type
.Se agregó un nuevo segmento
landing_page_source
que se puede usar con el recursolanding_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 lo siguiente:
Se agregó un nuevo tipo de clic
VEHICLE_ASSETS
en la segmentación declick_view
para 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_millis
en las estrategias de ofertasMaximizeConversionValue
yTargetRoas
con cualquier valor divisible por 1,000 entre 10,000 (10%) y 30,000 (30%), inclusive. Las estrategias de ofertasMaximizeConversionValue
también requerirán que se establezca el campotarget_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 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 tipocampaign
y un tipoYouTubeVideoListAsset
. Consulta el artículo del Centro de ayuda Cómo usar los videos relacionados.Se agregaron nuevos campos de metadatos a
YouTubeChannelInsights
yYouTubeVideoAttributeMetadata
.Se expusieron nuevos tipos de clics:
VIDEO_RELATED_VIDEOS_CLICK
,VIDEO_CHANNEL_CLICK
yPRODUCT_ASSETS
.Se agregó el campo
allow_non_skippable_in_stream
aVideoAdInventoryControl
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 no saltable con otros formatos.Se agregaron los campos
Campaign.VideoCampaignSettings.video_ad_sequence
yAdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting
(solo lectura). Consulta el artículo del Centro de ayuda Acerca de la secuenciación de anuncios de video.Se agregaron nuevos campos de metadatos a
YouTubeChannelInsights
yYouTubeVideoAttributeMetadata
.Se agregaron el tipo de criterio
VIDEO_LINEUP
y el campovideo_lineup
aCampaignCriterion
yAdGroupCriterion
. 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 contiene 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_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 grupo de anuncios para las campañas existentes fallarán con un error deCriterionError.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
ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION
si las campañas del experimento no declararon por sí mismas si contienen 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.
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_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 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_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:
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
ShoppingSetting
durante la creación de la campaña cuando se usaGenerateRecommendationsRequest
. - Se agregó el campo
merchant_center_account_id
aGenerateRecommendationsRequest
para 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_LINEUP
para reemplazarAudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP
enAudienceInsightsService
yContentCreatorInsightsService
. 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
, comoDynamicLineupAttributeMetadata
yAudienceInsightsDynamicLineup
, 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
AdditionalApplicationInfo
yApplicationInstance
enAudienceInsightsService
,ContentCreatorInsightsService
yReachPlanService
. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas. - Se actualizaron
AudienceInsightsService
yContentCreatorInsightsService
para proporcionar estadísticas más detalladas. Ahora puedes segmentar los datos de los creadores de contenido por dispositivo con los nuevos camposAudienceInsightsDimension.DEVICE
yAudienceInsightsAttribute.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
yis_brand_connect_creator
. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas. - Se agregó
sub_country_locations
aGenerateCreatorInsightsRequest
paraContentCreatorInsightsService
. Esto permite especificar ubicaciones geográficas secundarias para definir mejor las búsquedas de estadísticas de creadores. El camposub_country_locations
solo se admite cuando se usa el camposearch_attributes
oneof en el campocriteria
. Si se proporcionansub_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 de origen que posee un cliente, y se agregóUserListInfo
a las opciones de segmentación por público enGenerateReachForecastRequest
. Esto te permite recuperar listas de usuarios aptas para la planificación de 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 los anuncios
AdFormatType.PAUSE
publicados en videos orgánicos de YouTube en pantallas de TV, que 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 (2025-08-06)
Estos cambios en la publicidad política de la UE también se realizaron 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 contiene 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_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 grupo de anuncios para las campañas existentes fallarán con un error deCriterionError.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. Espera el anuncio de este cambio.
Las pruebas y los experimentos arrojarán un
ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION
si las campañas del experimento no declararon por sí mismas si contienen 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_coverage
paraAssetGroup
que devuelve información sobre las brechas en tu grupo de recursos.- Contiene un subcampo
ad_strength_action_items
que 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étodoProvideLeadFeedback
para subir calificaciones y comentarios sobre los clientes potenciales. - Se agregó un nuevo campo llamado
lead_feedback_submitted
aLocalServicesLead
para 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_conversions
para las campañas de aplicaciones.
Generación de demanda
- Se introdujeron 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_images
del 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_customer
mientras creas un cliente nuevo con la API de Google Ads. Anteriormente, este era un campo de solo lectura. - Ahora puedes especificar el tipo de cliente asociado con la conversión cuando subas conversiones sin conexión.
- Se agregó un nuevo campo
session_attributes
paraClickConversion
.
Anuncios de Servicios Locales
- Se agregó una nueva RPC
ProvideLeadFeedback
aLocalServicesLeadService
para proporcionar comentarios sobre la calidad deLocalServicesLead
. - Se agregó un nuevo campo
lead_feedback_submitted
al recursoLocalServicesLead
que 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.MONTHLY
enTargetFrequencySettings
cuando usan el código de producto planificableTARGET_FREQUENCY
para generar una previsión del alcance mensual de la frecuencia objetivo.
- Los desarrolladores pueden establecer
- Se agregó un nuevo método
ReachPlanService.GenerateConversionRates
que 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_CONVERSIONS
para generar previsiones de alcance de las campañas de generación de demanda. - Se agregó un nuevo campo
conversion_rate
que 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
conversions
a 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_strength
está disponible paraImprovePerformanceMaxAdStrengthRecommendation
, que devuelve la puntuación actual de la calidad del anuncio del grupo de recursos asociado con la recomendación.Compras
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_settings
a 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_SUPPORTED
si 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
AdvertisingChannelSubType
llamadoYOUTUBE_AUDIO
. - Un nuevo
AdGroupType
llamadoYOUTUBE_AUDIO
. - Se agregó una nueva enumeración de formato de anuncio llamada
YOUTUBE_AUDIO_AD
y sus camposYouTubeAudioAdInfo
correspondientes.
- 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_impressions
yprimary_impressions
. - Se introdujeron dos segmentos nuevos llamados
adjusted_age_range
yadjusted_gender
. - Si se selecciona cualquiera de los dos segmentos nuevos junto con un campo de métrica de alcance (
coviewed_impressions
,primary_impressions
,unique_users
oaverage_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:
Administración de cuentas
- Se agregaron los siguientes valores a
CustomerError
para tener en cuenta los próximos cambios:CREATION_DENIED_FOR_POLICY_VIOLATION
CREATION_DENIED_INELIGIBLE_MCC
Anuncios
- Se agregó
DemandGenMultiAssetAdInfo.tall_portrait_marketing_images
para 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
,BusinessMessageAsset
y los siguientes enums y errores.- Enumeraciones:
- Se agregó
AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW
para admitir la generación automática de una vista previa de la página de destino. AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS
ahora 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_asset
yAppDeepLinkAsset
.
Conversiones
- Objetivos de conversión
LifecycleGoalValueSettings.high_lifetime_value
dejó de ser beta y ahora es mutable.- Se agregó
CustomerLifecycleGoal.owner_customer
para mostrar el nombre del recurso del cliente propietario del objetivo de ciclo de vida del cliente.
ConversionActionType.SALESFORCE
quedó 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 usarassets
para lograr el mismo objetivo. Visita las Notas de migración para ver la lista de todas las entidades quitadas.
Hotel y viajes
- Se convirtieron
min_days
ymax_days
deValueRuleItineraryAdvanceBookingWindow
en un campooptional
para 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_enabled
cuando 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.EnablePMaxBrandGuidelines
agregado recientemente. No se admite la inhabilitación de los lineamientos de la marca. - Se agregaron
Campaign.brand_guidelines
yBrandGuidelines
para 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_VIDEOS
para 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_brand
para especificar una marca para buscar creadores - Se agregaron campos nuevos a
YouTubeChannelInsights
para 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
- Tras el lanzamiento de
DataLinkService.CreateDataLink
, agregamos los siguientes métodos para permitir la modificación de los vínculos de datos creados anteriormente:RemoveDataLink
para quitar vínculos de datos en una cuenta de Google AdsUpdateDataLink
para aceptar, rechazar y revocar vínculos de datos en una cuenta de Google Ads
- Se quitó la compatibilidad con
VIDEO_OUTSTREAM
de las siguientes enumeraciones:
v18 (16/10/2024)
En la versión 18, se agregaron las siguientes funciones y actualizaciones nuevas.
Administración de cuentas
- (Solo para cuentas incluidas en la lista de entidades permitidas) Se agregó
DataLinkService.CreateDataLink
, que permite vincular una cuenta de Google Ads a los videos de creadores alojados en el canal de YouTube del creador. La vinculación de videos permite que la cuenta de Google Ads publique anuncios en plataformas asociadas con videos de creadores.
Grupos de anuncios
- Se agregó
AdGroup.exclude_demographic_expansion
, que te permite excluir la expansión de los datos demográficos cuandooptimized_targeting_enabled
estrue
, una función que antes solo se admitía para las campañas de generación de demanda.
Anuncios
- Se agregó
AdGroupAd.ad_group_ad_asset_automation_settings
, que permite habilitar o inhabilitar la generación automática de recursos en los anuncios. - Se agregaron los siguientes valores a
AssetAutomationType
:GENERATE_VERTICAL_YOUTUBE_VIDEOS
GENERATE_SHORTER_YOUTUBE_VIDEOS
- Se agregó
AdNetworkType.GOOGLE_OWNED_CHANNELS
, que utilizan los anuncios que se publican en los canales propiedad de Google, como YouTube, Gmail y el feed de Descubre.
Recursos
- Se cambió el nombre de
AssetType.DISCOVERY_CAROUSEL_CARD
aAssetType.DEMAND_GEN_CAROUSEL_CARD
.
Campañas
- Se agregó
metrics.store_visits_last_click_model_attributed_conversions
, que devuelve la cantidad de visitas a tienda atribuidas por el modelo de último clic de una campaña. - Se agregaron las siguientes métricas relacionadas con las vistas de video para una campaña:
- Se agregó
metrics.results_conversions_purchase
, que devuelve las compras por conversión para los resultados de los objetivos unificados de una campaña. - Se cambió el valor predeterminado de
DemandGenCampaignSettings.upgraded_targeting
defalse
atrue
.
Criterio
- Se agregó
content_criterion_view
, que devuelve métricas de rendimiento del contenido segmentado, como palabras clave, posiciones y temas, para las campañas de Display, de generación de demanda y de video.
Hotel y viajes
- Compatibilidad con los feeds de viajes en los anuncios de búsqueda
- Se agregó
ClickType.TRAVEL_ASSETS
para permitir la segmentación de las métricas de los feeds de viajes en anuncios de búsqueda. - Se agregó
AssetSetType.TRAVEL_FEED
, que se puede usar para habilitar o inhabilitar el uso de Feeds de viajes en anuncios de búsqueda.
- Se agregó
- (Solo para cuentas incluidas en la lista de entidades permitidas) Se agregó el itinerario de viaje como una nueva regla de valor de conversión con los siguientes campos y valores nuevos:
ConversionValueRule.itinerary_condition
conValueRuleItineraryCondition
, que permite especificar un período de reserva anticipada, una duración del itinerario y días de la semana de inicio del viajeConversionValueRulePrimaryDimensionEnum.ITINERARY
ValueRuleSetDimension.ITINERARY
- Se agregaron los siguientes segmentos a los informes de
campaign
yad_group
para permitir la segmentación de los datos de rendimiento según destinos específicos (ciudades, países y regiones) para las campañas de hoteles y de Búsqueda:
Servicios locales
PhoneCallDetails.call_recording_url
estará vacío en lugar de proporcionar una URL no válida si no existe la grabación de la llamada para la conversación de clientes potenciales de Servicios Locales determinada.- Se agregó
CategoryBid.target_cpa_bid_micro
, que permite establecer el CPA objetivo para una categoría a través deCampaign.local_services_campaign_settings
.
Máximo rendimiento
- Compatibilidad con los lineamientos de la marca
- Se agregó
Campaign.brand_guidelines_enabled
, que muestra si los lineamientos de la marca están habilitados para una campaña de máximo rendimiento determinada. Si está habilitado, los recursos confield_type
establecido enBUSINESS_NAME
,LOGO
oLANDSCAPE_LOGO
deben vincularse como recursosCampaignAsset
en lugar de recursosAssetGroupAsset
. - Se agregaron los errores
CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED
yCampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED
, que indican que las campañas de máximo rendimiento con lineamientos de desarrollo de la marca habilitados no tienen los recursosCampaignAsset
necesarios vinculados a la campaña. - Cuando se habilitan los lineamientos de desarrollo de la marca, se debe vincular a la campaña al menos un recurso con
field_type
establecido enBUSINESS_NAME
y al menos uno conLOGO
como recursosCampaignAsset
. Las campañas de máximo rendimiento para ventas en línea con un feed de productos solo deben cumplir con este requisito cuando haya recursos vinculados a los grupos de recursos de la campaña. - Se agregaron los siguientes valores a
AssetLinkError
: BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL
, que se arroja cuando se intenta vincular recursos de marca a campañas como recursos deCampaignAsset
en lugar de recursos deAssetGroupAsset
en campañas de máximo rendimiento con lineamientos de desarrollo de la marca no habilitados.BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL
error, que se arroja cuando se intenta vincular recursos de marca a campañas como recursosAssetGroupAsset
en lugar de recursosCampaignAsset
en campañas de máximo rendimiento con los lineamientos de la marca habilitados.
- Se agregó
- Se agregó
performance_max_placement_view
, que devuelve las impresiones de las posiciones en las que se publicaron los anuncios de las campañas de máximo rendimiento. - Se agregó
AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION
Planificación
- (Solo para cuentas incluidas en la lista de entidades permitidas) Se agregó un nuevo servicio con el método
ContentCreatorInsightsService.GenerateCreatorInsights
, que permite a los usuarios explorar estadísticas sobre los principales creadores de YouTube. Esto permite a los clientes buscar creadores según una combinación de segmentación por público y segmentación por contenido, o bien estadísticas de creadores según una lista de IDs de canales de YouTube. - Actualizaciones a
AudienceInsightsService.GenerateSuggestedTargetingInsights
:- Se movieron
audience
,baseline_audience
ydata_month
aaudience_definition
. - Se agregó
audience_description
para generar sugerencias de segmentación a partir de una descripción de texto de formato libre con IA generativa.
- Se movieron
- Se agregó
AudienceInsightsService.GenerateTargetingSuggestionMetrics
, que devuelve métricas de alcance potencial para combinaciones de segmentación por público determinadas.
Recomendaciones
RecommendationService.GenerateRecommendations
Ahora se puede usar para generar recomendaciones sobre sugerencias de presupuestos optimizados durante la creación de la campaña, ya que incluye el tipo de recomendaciónCAMPAIGN_BUDGET
enGenerateRecommendationsRequest.recommendation_types[]
. Esto funciona para las campañas de máximo rendimiento y de Búsqueda.
Informes
- Se reemplazaron los campos
summary_row_setting
yreturn_total_results_count
deSearchGoogleAdsRequest
por el camposearch_settings
, cuyo tipo esSearchSettings
con los siguientes campos:omit_results
return_summary_row
return_total_results_count
- Se agregaron las siguientes métricas nuevas sobre los clics no válidos generales, como los que generan los bots o los rastreadores, y los que tienen patrones irregulares. Se pueden consultar con el informe
campaign
. - Se agregaron los siguientes valores a
QuotaError
:EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
Notas de la versión archivadas
Consulta las versiones descontinuadas para ver las notas de la versión archivadas.