Notas de la versión

v0 (2025-11-10)

Nuevos campos de URL

Agregaremos

• ad.final_mobile_urls,
• ad.tracking_url_template,
• ad.final_url_suffix,
• ad_group.tracking_url_template,
• ad_group.final_url_suffix,
• ad_group_criterion.final_mobile_urls
• ad_group_criterion.url_custom_parameters
• asset.final_mobile_urls
• asset.url_custom_parameters
• asset.final_url_suffix

Nuevas métricas para UserLocationView

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

• all_conversions_by_conversion_date
• all_conversions_value_by_conversion_date
• conversions_by_conversion_date
• conversions_value_by_conversion_date
• cross_device_conversions_by_conversion_date
• cross_device_conversions_value_by_conversion_date
• value_per_all_conversions_by_conversion_date
• value_per_conversions_by_conversion_date

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 del cliente propietario de la etiqueta:

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

Ejemplo: El patrón de CampaignEffectiveLabel cambió de customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} a customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (12/6/2025)

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

Campos nuevos

Agregaremos

• customer.manager_id,
• customer.manager_descriptive_name,
• customer.sub_manager_id,
• customer.sub_manager_descriptive_name,
• customer.associate_manager_id,
• customer.associate_manager_descriptive_name y
• customer.account_level

para ayudar a recorrer la jerarquía de la cuenta de Search Ads 360

v0 (2025-01-21)

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

Expansión de MCC

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

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

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

Agregaremos ad_group_ad.effective_labels y ad_group_criterion.effective_labels.

Las etiquetas eficaces son las que se heredan o se asignan directamente.

Nuevos recursos

Vista de la ubicación del usuario

Si lo 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 objeto ad_group_ad (ad_group_ad_effective_label) o ad_group_criterion (ad_group_criterion_effective_label).

v0 (2024-10-07)

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

Se agregaron métricas

• cross_device_conversions_by_conversion_date: Es la cantidad de conversiones en dispositivos múltiples por fecha de conversión.
• cross_device_conversions_value_by_conversion_date: Es la suma del valor de las conversiones en dispositivos múltiples por fecha de conversión.
• general_invalid_click_rate: Es el porcentaje de clics que se filtraron de la cantidad total de clics (clics filtrados y no filtrados) por ser clics no válidos generales.
• general_invalid_clicks: Es la cantidad de clics no válidos generales.

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 y 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

• Cuenta
• Anuncio
• AdGroup
• AdGroupTarget
• Anunciante
• BidStrategy
• Campaña
• Palabra clave
• ProductAdvertised

Campos nuevos

Agregaremos campaign.effective_labels y ad_group.effective_labels.

Las etiquetas eficaces son las que se heredan o se asignan directamente.

Nuevos recursos

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

v0 (2024-08-23)

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

Consulta los detalles de 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.

Se agregó start_time al recurso customer_manager_link

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 las métricas

v0 (18/4/2024)

Esta actualización incluye el recurso Accessible Bidding Strategy.

Estrategia de ofertas accesible

Representa una vista de los objetos BiddingStrategies que son propiedad del cliente y se comparten con él. A diferencia de BiddingStrategy, este recurso incluye las estrategias que son propiedad de los administradores del cliente y que se comparten con este cliente, 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 conversión personalizadas y las columnas de fórmula personalizadas en una consulta. Obtén más detalles en la documentación de las columnas personalizadas.

Variables personalizadas de Floodlight

Ahora se pueden especificar variables personalizadas de Floodlight en una consulta para las estadísticas posteriores al 30/01/2024. Consulta más detalles en la documentación sobre 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, así como 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 recursos

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.

Indicador del grupo de recursos

Consulta los detalles del recurso asset_group_signal.

Vista de la combinación principal del grupo de recursos

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 del 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 nuevo parámetro 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, así como 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 recursos

Consulta los detalles del recurso asset_set.

Recurso del conjunto de recursos

Consulta los detalles del recurso asset_set_asset.

Recurso de campaña

Consulta los detalles del recurso campaign_asset.

Conjunto de recursos de la campaña

Consulta los detalles del recurso campaign_asset_set.

Activo del cliente

Consulta los detalles del recurso customer_asset.

Conjunto de recursos del cliente

Consulta los detalles del recurso customer_asset_set.

Conversión de monedas

Es posible especificar la moneda para el cálculo de las 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 del público del grupo de anuncios

Consulta los detalles del recurso ad_group_audience_view.

Etiqueta del 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 edad

Consulta los detalles del recurso age_range_view.

Campaign Criterion

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

• SearchAds360FieldService proporciona un catálogo de todos los campos que se pueden consultar. Los metadatos de estos campos incluyen descripciones, tipos y compatibilidad con otros campos. Obtén más información.

SearchAds360Service

• SearchAds360Service se usa para recuperar varios recursos en una sola consulta. Los recursos que se pueden consultar incluyen los siguientes:

  • AdGroup
  • BiddingStrategy
  • Campaign
  • ConversionAction
  • Customer
  • Keyword
  • ProductGroup

• También se pueden recuperar métricas, como las impresiones y los clics, con SearchAds360Service para los siguientes recursos:

  • AdGroup
  • BiddingStrategy
  • Campaign
  • ConversionAction
  • Customer
  • Keyword
  • ProductGroup

• SearchAds360Service permite la segmentación por campos, como los campos de fecha. Obtén más información.