Anuncio de la versión 24 de la API de Google Ads

Miércoles, 22 de abril de 2026

Hoy anunciamos el lanzamiento de la versión 24 de la API de Google Ads. Para usar las nuevas funciones de la versión 24, debes actualizar tus bibliotecas cliente y el código de cliente. Se publicaron todas las bibliotecas cliente y los ejemplos de código actualizados.

Únete a nosotros para ver un recorrido en vivo de esta versión en nuestro evento "Google Ads API Release Highlights" en Discord, nuestro Ads Developers YouTube Live o nuestro evento de LinkedIn Live mañana (23 de abril a las 10:00 a.m., hora del este). También se grabará y se publicará en YouTube para quienes no puedan asistir a los eventos en vivo. Si tienes alguna pregunta o quieres debatir sobre esta publicación, comunícate con nosotros en el canal #ads-api de Discord.

Nuevas funciones

Compatibilidad con las conversiones con datos del carrito: Las conversiones con datos del carrito son una extensión del seguimiento de conversiones en tu sitio web o app. Si las utilizas, puedes proporcionar los detalles de los productos vendidos en cada transacción, lo que te ayuda a acceder a ventas avanzadas, informes de ganancias y estadísticas para tus campañas y tu cuenta de Google Ads, como la cantidad de pedidos, el tamaño promedio del carrito, los ingresos y la ganancia bruta.

La versión 24 de la API de Google Ads agrega compatibilidad con esta función de la siguiente manera:

  • Se agregó un recurso nuevo CartDataSalesView que permite segmentar las métricas de conversión no solo por el producto en el que se hizo clic, sino también por el producto vendido, con segmentos como product_sold_brand. Estas permiten que los anunciantes vean estadísticas sobre los productos que los clientes realmente compraron después de hacer clic en los anuncios, incluso si el anuncio era para un producto diferente.
  • Se agregaron varias métricas "totales" no aptas para ofertas, que son métricas que también incluyen las conversiones para las que tus campañas no se optimizan activamente, por ejemplo, all_cost_of_goods_sold_micros. Las métricas nuevas se agregan a todos los recursos que admiten las métricas aptas para ofertas correspondientes.
  • Se agregó el segmento conversion_attribution_event_type al recurso ShoppingPerformanceView, lo que permite seleccionarlo con los datos del carrito y otras métricas de conversión. Este segmento indica si la conversión se atribuye a un clic o a una vista, y es necesario para reconocer las estadísticas de datos del carrito que producen las conversiones posimpresión.

Características actualizadas

La versión v24 incluye actualizaciones de las funciones existentes que requieren cambios en el código cuando se actualiza. Aquí abordamos los más importantes. Consulta las notas de la versión para ver la lista completa de cambios.

Configuración de exclusión de contenido de video en las campañas: Simplificamos la capacidad de establecer la configuración de exclusión de contenido de video en campañas individuales. Este parámetro de configuración está disponible a nivel del cliente y se aplica a todas las campañas. Estas opciones de configuración de exclusión de contenido están diseñadas para ofrecerte un mayor control y ayudarte a excluir los tipos de contenido que, si bien cumplen nuestras políticas, quizás no sean adecuados para tu marca o empresa. Consulta https://support.google.com/google-ads/answer/7515513 para obtener más información sobre la configuración de exclusión de contenido de video.

Cambios en AudienceInsightsService: Como parte de una refactorización de código, movimos el campo de solicitud InsightsAudience.topic_audience_combinations al espacio de nombres common. Es posible que debas actualizar tus directivas de importación en algunos lenguajes de programación.

Cambios en ReachPlanService: Como parte de una refactorización de código, movimos el campo youtube_select_lineups del servicio ReachPlanService.ListPlannableProducts. Las selecciones de contenido ya están disponibles en el campo youtube_select_lineup_targeting. Las selecciones de contenido de YouTube Select son productos de reservación que permiten a los clientes que reúnen los requisitos segmentar sus anuncios para los públicos más apasionados del 1% de los canales más populares en YouTube en un mercado determinado. Obtén más información.

Cambios en ContentCreatorInsightsService: Como parte de una refactorización de código, quitamos el campo is_brand_connect_creator de los servicios ContentCreatorInsightsService.GenerateCreatorInsights y ContentCreatorInsightsService.GenerateTrendingInsights.
En su lugar, los usuarios deben buscar un creador que tenga disponible la opción CREATOR_PARTNERSHIPS en partnership_opportunities. La herramienta Asociaciones con creadores de YouTube en Google Ads es el espacio en el que puedes encontrar creadores de YouTube con quienes asociarte para crear contenido patrocinado y administrar de manera eficiente tus asociaciones con creadores. Obtén más información.

Cambios en KeywordPlanIdeaService: Para brindar una experiencia más optimizada y confiable, unificamos nuestra infraestructura de previsión. La versión 24 de la API de Google Ads presenta un método GenerateKeywordForecastMetrics actualizado que simplifica el proceso de planificación, ya que se enfoca en las métricas que tienen un impacto más directo en tu rendimiento. En los próximos días, publicaremos una entrada de blog con más detalles sobre este cambio.

Cambios en el recurso campaign_budget: Quitamos el segmento ad_sub_network_type del recurso campaign_budget porque no es compatible con esta vista.

Cambios en las vistas de recursos: Quitamos el segmento click_type de las vistas ad_group_asset, campaign_asset y customer_asset. Este cambio se alinea con una modificación reciente del producto que quitó este segmento de Google Ads para evitar la tergiversación de los datos. Puedes usar la segmentación click_type del recurso ad_group_ad para obtener detalles sobre el rendimiento del anuncio y el recurso con el que se publicó.

Cambios en el anuncio responsivo de video: VideoResponsiveAdInfo ahora es mutable. Como parte de este cambio, marcamos videos, business_name y logo_images como campos obligatorios en los objetos DemandGenVideoResponsiveAdInfo y VideoResponsiveAdInfo.

Cambios en ShareablePreviewService: Se actualizó ShareablePreviewService.GenerateShareablePreviews para que ya no use el error parcial. Las solicitudes arrojarán un error si fallan para cualquier ID. Obtén más información.

Los siguientes recursos pueden ayudarte a comenzar:

Si tienes problemas de asistencia técnica, comunícate con https://support.google.com/google-ads/contact/google_ads_api.

Retrato del autor - , equipo de la API de Google Ads

Etiquetas: google-ads-api, release