Notas de la versión

v0 (2026-08-01)

Campos nuevos

Agregamos synthetic_content_info a los recursos ad y asset, junto con el mensaje SyntheticContentInfo, SyntheticContentAttestationStatus y las enumeraciones SyntheticContentSource de respaldo.

v0 (2026-03-10)

Nuevos segmentos

Agregamos los siguientes segmentos:

v0 (2025-12-05)

Métricas nuevas

Las siguientes métricas ahora están disponibles cuando se consulta el campaign recurso:

Agregamos las siguientes métricas de conversiones con datos del carrito (CwCD):

Nuevos segmentos

Ahora se puede especificar la segmentación por código postal en una consulta. Consulta más detalles en segments.geo_target_postal_code.

v0 (2025-11-10)

Nuevos campos de URL

Agregamos

Nuevas métricas para UserLocationView

Las siguientes métricas ahora están disponibles cuando se consulta el user_location_view recurso:

Corrección del nombre del recurso

Se corrigió el patrón de nombres de recursos para los siguientes recursos de etiquetas efectivas para usar owner_customer_id y garantizar que contenga el ID de cliente que posee la etiqueta:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (en AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

Ejemplo: El diseño de CampaignEffectiveLabel cambió de customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} a customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (2025-06-12)

Esta actualización incluye campos nuevos para el recurso del cliente. Asegúrate de actualizar la biblioteca cliente para aprovechar todos estos cambios.

Campos nuevos

Agregamos

para ayudar a recorrer la jerarquía de cuentas de Search Ads 360.

v0 (2025-01-21)

Esta actualización incluye un parámetro nuevo para configurar la expansión de MCC.

Expansión de MCC

Cuando consultas una bidding_strategy, ahora puedes establecer un valor booleano (enable_mcc_expansion) en la sección PARAMETERS.

Cuando este parámetro está habilitado, los datos de todas las cuentas de la jerarquía de cuentas con raíz en customer_id se muestran en la respuesta.

v0 (2024-11-08)

Esta actualización incluye campos y recursos nuevos. Asegúrate de actualizar la biblioteca cliente para aprovechar todos estos cambios.

Campos nuevos

Agregamos ad_group_ad.effective_labels y ad_group_criterion.effective_labels.

Las etiquetas efectivas son etiquetas heredadas o asignadas directamente.

Nuevos recursos

Vista de ubicación del usuario

Si la usas con segmentos geográficos, puedes obtener métricas relacionadas con la región, el área metropolitana y la ciudad.

Consulta los detalles del recurso user_location_view.

En relación con los nuevos campos effective_labels, hay 2 recursos nuevos que conservan los metadatos de la asociación entre las etiquetas efectivas y el ad_group_ad (ad_group_ad_effective_label) o el ad_group_criterion (ad_group_criterion_effective_label).

v0 (2024-10-07)

Esta actualización incluye métricas, recursos y campos nuevos, además de algunas definiciones de asignación nuevas. Asegúrate de actualizar la biblioteca cliente para aprovechar todos estos cambios.

Métricas agregadas

cross_device_conversions_by_conversion_date y cross_device_conversions_value_by_conversion_date son compatibles con los siguientes recursos: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view y shopping_performance_view.

Se redefinieron las asignaciones de campos

Las asignaciones de campos para dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv cambiaron para algunos informes heredados.

Campo Anteriormente Nueva definición
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

Lista de informes heredados que cambiaron la asignación de campos

Campos nuevos

Agregamos campaign.effective_labels y ad_group.effective_labels.

Las etiquetas efectivas son etiquetas heredadas o asignadas directamente.

Nuevos recursos

En relación con los nuevos campos effective_labels, los nuevos recursos conservan los metadatos de la asociación entre las etiquetas efectivas y la campaña (campaign_effective_label) o el ad_group (ad_group_effective_label).

v0 (2024-08-23)

En esta actualización, los metadatos de las columnas personalizadas agregan el campo renderType .

Consulta los CustomColumnRenderType.

Se agregó un nuevo campo owner_customer_id a los recursos campaign_label, ad_group_label, ad_group_ad_label y ad_group_criterion_label.

Asegúrate de actualizar la biblioteca cliente para aprovechar estos campos nuevos.

v0 (2024-08-01)

Esta actualización incluye la segmentación por hora y varios campos nuevos.

Segmentación por hora

Ahora se puede especificar la segmentación por hora en una consulta. Consulta más detalles en segments.hour.

Consulta más detalles en customer_manager_link.start_time.

Se agregó MULTIMEDIA_AD a ad_group_ad.ad.type

Ahora se pueden seleccionar métricas y segmentos con el tipo MULTIMEDIA_AD. En esta versión, no se admite la consulta de atributos específicos de contenido multimedia.

Se agregó el tipo de campaña SOCIAL a campaign.advertising_channel_type y el subtipo SOCIAL_FACEBOOK_TRACKING_ONLY a campaign.advertising_channel_sub_type

Ahora se pueden seleccionar métricas y segmentos con el tipo de campaña SOCIAL y el subtipo SOCIAL_FACEBOOK_TRACKING_ONLY. En esta versión, no se admite la consulta de atributos específicos de SOCIAL o SOCIAL_FACEBOOK_TRACKING_ONLY.

Se agregó compatibilidad con average_quality_score

Consulta más detalles en métricas.

v0 (2024-04-18)

Esta actualización incluye el recurso Accessible Bidding Strategy.

Accessible Bidding Strategy

Representa una vista de las BiddingStrategies que son propiedad del cliente y que se comparten con él. A diferencia de BiddingStrategy, este recurso incluye estrategias que son propiedad de los administradores del cliente y que se comparten con él, además de las estrategias que son propiedad de este cliente. Este recurso no proporciona métricas y solo expone un subconjunto limitado de los atributos de BiddingStrategy.

Consulta los detalles del recurso accessible_bidding_strategy.

v0 (2024-02-12)

Esta actualización incluye acceso a las columnas personalizadas y a las variables personalizadas de Floodlight.

Columnas personalizadas

Ahora se pueden especificar las columnas de conversiones personalizadas y las columnas de fórmulas personalizadas en una consulta. Consulta más detalles en la documentación de las columnas personalizadas.

Variables personalizadas de Floodlight

Ahora se pueden especificar las variables personalizadas de Floodlight en una consulta para obtener estadísticas posteriores al 30/01/2024. Consulta más detalles en la documentación de las variables personalizadas de Floodlight.

v0 (2023-11-09)

Esta actualización incluye los siguientes recursos. Visita los vínculos para ver los campos que se pueden consultar para estos recursos, y las métricas y segmentaciones que se pueden usar con ellos.

Grupo de elementos

Consulta los detalles del recurso asset_group.

Recurso del grupo de elementos

Consulta los detalles del recurso asset_group_asset.

Filtro de grupo de fichas y elementos

Consulta los detalles del recurso asset_group_listing_group_filter.

Señal del grupo de elementos

Consulta los detalles del recurso asset_group_signal.

Vista de las principales combinaciones del grupo de elementos

Consulta los detalles del recurso asset_group_top_combination_view.

Vista de ventas de datos del carrito

Consulta los detalles del recurso cart_data_sales_view.

Conversión

Consulta los detalles del recurso conversion.

Vista de rendimiento de Shopping

Consulta los detalles del recurso shopping_performance_view.

Visitar

Consulta los detalles del recurso visit.

v0 (2023-08-15)

Esta actualización incluye los siguientes recursos y un parámetro nuevo para configurar la conversión de moneda para las métricas.

Visita los vínculos para ver los campos que se pueden consultar para estos recursos, y las métricas y segmentaciones que se pueden usar con ellos.

Recurso del grupo de anuncios

Consulta los detalles del recurso ad_group_asset.

Conjunto de recursos del grupo de anuncios

Consulta los detalles del recurso ad_group_asset_set.

Recurso

Consulta los detalles del recurso asset.

Conjunto de elementos

Consulta los detalles del recurso asset_set.

Conjunto de elementos

Consulta los detalles del recurso asset_set_asset.

Lista de verificación

Consulta los detalles del recurso campaign_asset.

Conjunto de recursos de campaña

Consulta los detalles del recurso campaign_asset_set.

Elemento del cliente

Consulta los detalles del recurso customer_asset.

Conjunto de elementos del cliente

Consulta los detalles del recurso customer_asset_set.

Conversión de Moneda

Es posible especificar la moneda para el cálculo de métricas con metrics_currency en la sección PARAMETERS.

Cómo obtener una lista de clientes a los que puedes acceder

Enumera todas las cuentas accesibles con el método ListAccessibleCustomers.

v0 (2023-05-15)

Esta actualización incluye el siguiente recurso. Visita los vínculos para ver los campos que se pueden consultar para este recurso, y las métricas y segmentaciones que se pueden usar con él.

Anuncio del grupo de anuncios

Consulta los detalles del recurso ad_group_ad.

v0 (2023-04-06)

Esta actualización incluye los siguientes recursos. Visita los vínculos para ver los campos que se pueden consultar para cada recurso, y las métricas y segmentaciones que se pueden usar con ese recurso.

Vista de público del grupo de anuncios

Consulta los detalles del recurso ad_group_audience_view.

Etiqueta de criterio del grupo de anuncios

Consulta los detalles del recurso ad_group_criterion_label.

Etiqueta del grupo de anuncios

Consulta los detalles del recurso ad_group_label.

Vista de rango de edades

Consulta los detalles del recurso age_range_view.

Criterio de campaña

Consulta los detalles del recurso campaign_criterion.

Etiqueta de la campaña

Consulta los detalles del recurso campaign_label.

Vista de términos de búsqueda de los anuncios dinámicos de búsqueda

Consulta los detalles del recurso dynamic_search_ads_search_term_view.

Vista de página web

Consulta los detalles del recurso webpage_view.

Etiqueta

Consulta los detalles del recurso label.

v0 (2022-12-05)

La versión v0 incluye los siguientes recursos y servicios. Visita los vínculos para ver los campos que se pueden consultar para cada recurso, y las métricas y segmentaciones que se pueden usar con ese recurso.

Grupo de anuncios

Consulta los detalles del recurso ad_group.

Ofertas

Consulta los detalles del recurso bidding_strategy.

Campañas

Consulta los detalles del recurso campaign.

Acción de conversión

Consulta los detalles del recurso conversion_action.

Cliente

Consulta los detalles del recurso customer.

Palabra clave

Consulta los detalles del recurso keyword_view.

Grupo de productos

Consulta los detalles del recurso product_group_view.

SearchAds360FieldService

SearchAds360Service