Google ha lanzado la versión 23 de la API de Google Ads, esta es una versión importante con docenas de actualizaciones. Las actualizaciones incluyen datos de informes Máximo rendimiento con desglose del tipo de red publicitaria, más incentivos, informes y controles de conversión, y mucho más.
Google escribió: «Hoy anunciamos el lanzamiento v23 de la API de Google Ads. Esto marca el primer lanzamiento de 2026 y el comienzo de nuestro avance hacia una cadencia de lanzamiento más rápida».
Antes de esta versión, era la versión 22 el 15 de octubre de 2025, luego la versión 21 el 6 de agosto de 2025, luego la 20 el 5 de junio de 2025, la 19.1 en abril de 2025, luego la 19 en febrero de 2025, luego la versión 18 en octubre de 2024. Antes de eso era 17.1 en agosto de 2024 y luego antes de eso era la versión 17.0 en Junio de 2024 y luego antes fue la versión 16.1 y luego la versión 16 en febrero de 2024. Antes de eso, fue la versión 15 en octubre de 2023. Luego, antes de eso, fue la versión 14.1 que se lanzó en agosto. La versión 13.1 precedió a esta nueva versión, que se lanzó en abril de 2023. La versión 12.0 se lanzó en octubre de 2022, la versión 11.0 de la API de Google Ads se lanzó en junio y la versión 11.1 en agosto. Además, la versión 10.1 se lanzó el 27 de abril de 2022 y la versión 10.0 se lanzó el 9 de febrero de 2022. Y Google suspendió la API de AdWords el 27 de abril, que dejará de funcionar por completo a finales de julio.
Aquí están las notas de la versión:
Anuncios:
- Se agregó AD_SHARING_NOT_ALLOWED a AdGroupAdErrorEnum. Este error se devuelve al intentar compartir un anuncio entre varios grupos de anuncios, lo cual ya no está permitido.
- Se agregaron nuevos tipos de formato a AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
- Se eliminó la compatibilidad con CallAd y CallAdInfo en v23. Consulte para obtener más información.
Activos:
- Se agregaron métricas adicionales al informe de grupo de activos: metrics.engagements, metrics.engagement_rate, metrics.average_cpe
- Se agregaron métricas adicionales al informe active_group_asset: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, metrics.interaction_event_types
- Se agregó orientación de campo de solo lectura a los recursos de imagen y video en Activo.
- Se agregó soporte para recuperar CampaignAsset con field_type TÍTULO y DESCRIPCIÓN.
- Se agregaron HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE y DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO a ServedAssetFieldType para recursos servidos como vínculos a sitios.
- Activos de mensajes comerciales actualizados
Facturación:
- InvoiceService.ListInvoices ahora puede devolver detalles más granulares en Invoice, incluido el desglose de costos a nivel de campaña, costos regulatorios detallados e información de ajuste, configurando include_granular_level_invoice_details en ListInvoicesRequest.
- Se agregaron RegulatoryFeeTypeEnum y UnitOfMeasureEnum.
Campañas:
- Se agregaron los códigos de error CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET y CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
- Se agregaron Campaign.start_date_time y Campaign.end_date_time para reemplazar Campaign.start_date y Campaign.end_date, lo que permite especificar componentes de tiempo para ciertos tipos de campaña.
Conversiones:
- Se agregó YOUTUBE_FOLLOW_ON_VIEWS a ConversionActionCategory para permitir el seguimiento de los usuarios que ven un anuncio y luego ven un video del mismo canal.
Generación de demanda:
- Se agregó el campo DemandGenVideoResponsiveAdInfo.companion_banner.
- Se eliminó el campo lead_form_only de DemandGenMultiAssetAdInfo.
Incentivos:
- Se agregó soporte para incentivos Choose Your Own (CYO), lo que permite a los socios buscar y aplicar mediante programación incentivos de Google Ads para sus clientes:
- El método FetchIncentive permite obtener incentivos disponibles para un usuario, según el país, el idioma y, opcionalmente, el correo electrónico del usuario. Esto puede devolver opciones de incentivos personalizados «Elige el tuyo» (CYO).
- El método ApplyIncentive permite aplicar un incentivo seleccionado por el usuario a una cuenta de cliente específica de Google Ads.
- Se agregó el recurso de solo lectura AppliedIncentive, consultable a través de GoogleAdsService.Search y GoogleAdsService.SearchStream. Proporciona detalles sobre los incentivos canjeados, incluido su estado, progreso de cumplimiento, montos de recompensa y fechas relevantes.
- Se agregaron nuevos códigos de error en IncentiveErrorEnum para manejar problemas relacionados con la obtención o aplicación de incentivos.
- Se agregó INVALID_EMAIL_ADDRESS a AuthenticationErrorEnum.
- Para facilitar un manejo programático más detallado de las fallas, agregaremos códigos de error adicionales a IncentivesService en versiones futuras. Le recomendamos que supervise los próximos anuncios y notas de la versión para detectar estos nuevos códigos de error y asegurarse de que sus aplicaciones puedan gestionar estos nuevos modos de error.
Planificación:
- Se agregó LIFE_EVENT_USER_INTEREST a AudienceInsightsDimension. Esta nueva dimensión permite a los usuarios crear audiencias utilizando Life Events para los siguientes métodos:
- La respuesta ReachPlanService.GenerateConversionRates ahora incluye superficies, lo que permite diferentes sugerencias de tasas de conversión basadas en controles de superficie (por ejemplo, Gmail, Shorts). Esto solo se admite para campañas de generación de demanda.
- Se agregó LanguageDistribution a YouTubeChannelInsights, lo que brinda distribución de idiomas en el contenido del canal de YouTube.
- Se agregó BenchmarksService para comparar los datos de anuncios de YouTube con los puntos de referencia de la industria.
- Se agregó AudienceInsightsService.GenerateAudienceDefinition para traducir una descripción de texto libre de una audiencia objetivo en atributos de audiencia coincidentes mediante IA generativa.
- Se agregó YouTubeChannelInsights.relevance_score, que evalúa qué tan relevante es un creador para un tema ponderado por vistas.
- Se agregó TrendInsightMetrics.trend_change_percent, que representa el cambio porcentual en el valor de una tendencia durante el período de comparación.
Recomendaciones:
- Se agregó el campo is_new_customer a GenerateRecommendationsRequest. Cuando se establece en verdadero para recomendaciones de tipo CAMPAIGN_BUDGET, genera recomendaciones utilizando un modelo para nuevos clientes. Esto solo se recomienda para clientes sin campañas.
Informes:
- Métricas y segmentación: AdGroupAdAssetView y AdGroupAdAssetCombinationView ahora admiten métricas de impresiones, rendimiento y conversión para RESPONSIVE_DISPLAY_AD.
- Métricas y segmentación: se agregó el segmento ad_sub_network_type para un desglose más granular del rendimiento dentro de una red publicitaria. Inicialmente, esto está disponible para campañas DemandGen en YouTube (In-stream, In-feed, Shorts). Este segmento debe seleccionarse junto con ad_network_type.
- Métricas y segmentación: desglose del tipo de red publicitaria habilitado para campañas Máximo rendimiento.
- Métricas y segmentación: UserLocationView y GeographicView ahora admiten métricas segmentadas por fecha de conversión:
- Nuevos segmentos para anuncios verticales
- Nuevas vistas: se agregó PerStoreView para consultar los detalles de la ubicación de la tienda. Se agregó MatchedLocationInterestView para campañas AI Max, que proporciona métricas de rendimiento desglosadas por ubicaciones geográficas en las que los usuarios mostraron interés.
- Máximo rendimiento: desglose del tipo de red publicitaria habilitado para campañas Máximo rendimiento.
- Eliminaciones: se eliminaron las métricas agregadas de la etiqueta de rendimiento de los activos. La enumeración de la etiqueta de rendimiento ya no se devuelve para Búsqueda y Display.
Compras:
- ShoppingPerformanceView ahora admite las siguientes métricas segmentadas por fecha de conversión: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
- ShoppingPerformanceView ahora admite las siguientes métricas competitivas: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
- Se agregó product_image_uri a ShoppingProduct.
Anuncios verticales:
- Se agregó vertical_ads_format_setting al grupo de anuncios para campañas de búsqueda que utilizan feeds de viajes, lo que permite controlar qué formatos de anuncios se pueden publicar.
- Se agregó el tipo de criterio vertical_ads_item_group_rule_list a AdGroupCriterion. Se agregó vertical_ads_item_group_rule a SharedCriterion. Estos criterios permiten segmentar grupos de artículos en campañas de búsqueda con feeds de viajes.
- Ahora puede conectar un feed de datos de anuncios verticales a una campaña de búsqueda que ejecute AI Max para que muestre anuncios de viajes con enlaces de reserva y promoción de propiedades junto con sus anuncios de texto. A nivel de grupo de anuncios, puede controlar qué formatos mostrar con vertical_ads_format_setting y definir un conjunto de reglas de grupo de elementos para orientar sus anuncios a un subconjunto de sus entidades desde la fuente de datos de anuncios verticales. Además, los informes ahora se pueden segmentar tanto por AdFormatType como por dimensiones del feed de datos de anuncios verticales.
Video:
- Se agregó el campo AdVideoAssetInfo.ad_video_asset_feature_control.
- Se agregó el código de error CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.
- Se agregaron métricas de audibilidad para anuncios de audio en YouTube, que informan si un anuncio era audible y cuántas impresiones se podía medir la audibilidad.
Foro de discusión en LinkedIn.
