Notas de la versión

v0 (2025-01-21)

Esta actualización incluye un nuevo parámetro para configurar la expansión de 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 con raíz en customer_id.

v0 (8/11/2024)

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 etiquetas heredadas o asignadas directamente.

Recursos nuevos

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 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 métricas, recursos, campos y algunas definiciones de asignación nuevos. Asegúrate de actualizar la biblioteca cliente para aprovechar todos estos cambios.

Métricas agregadas

• cross_device_conversions_by_conversion_date: Representación de 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, por ser clics no válidos generales, no se incluyeron en la cantidad total de clics (clics filtrados y no filtrados).
• 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 estos recursos: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view y shopping_performance_view.

Se volvieron a definir las asignaciones de campos

Los 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 etiquetas heredadas o asignadas directamente.

Recursos nuevos

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. Obtén 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. No se admiten consultas de atributos específicos de multimedia en esta versión.

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 admiten consultas 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 de estrategia de ofertas accesible

Estrategia de ofertas accesible

Representa una vista de BiddingStrategies que pertenece al cliente y que este comparte con otros. A diferencia de BiddingStrategy, este recurso incluye estrategias que pertenecen a los administradores del cliente y que se comparten con él, además de las estrategias que pertenecen al 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 (12/02/2024)

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

Columnas personalizadas

Las columnas de conversión personalizadas y las columnas de fórmulas personalizadas ahora se pueden especificar en una consulta. Obtén más detalles en la documentación de 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 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 recursos

Consulta los detalles del recurso asset_group_asset.

Filtro de grupo de fichas y elementos del grupo de recursos

Consulta los detalles del recurso asset_group_listing_group_filter.

Indicador de grupo de recursos

Consulta los detalles del recurso asset_group_signal.

Vista de las combinaciones principales del grupo de recursos

Consulta los detalles del recurso asset_group_top_combination_view.

Vista de ventas de los datos del carrito

Consulta los detalles del recurso cart_data_sales_view.

Conversión

Consulta los detalles del recurso de conversión.

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 activo.

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 campaña

Consulta los detalles del recurso campaign_asset_set.

Elemento 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.

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 de etiqueta.

v0 (2022-12-05)

La versión 0 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 de los recursos de la campaña.

Acción de conversión

Consulta los detalles del recurso conversion_action.

Cliente

Consulta los detalles de los recursos del cliente.

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 consultables. Los metadatos de estos campos incluyen descripciones, tipos y compatibilidad con otros campos. Obtén más información.

SearchAds360Service

• SearchAds360Service se diseñó para recuperar varios recursos en una sola consulta. Entre los recursos que se pueden consultar, se incluyen los siguientes:

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

• Las métricas, como las impresiones y los clics, también se pueden recuperar con SearchAds360Service para estos 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.