Lenguaje de consulta de Search Ads 360

El lenguaje de consultas de Search Ads 360 te permite crear consultas de búsqueda para recuperar datos de informes y metadatos de recursos con la API de Search Ads 360 Reporting.

Servicios de búsqueda

Puedes usar el lenguaje de consultas de Search Ads 360 para consultar la API con lo siguiente:

SearchAds360Service

Usa este servicio para consultar recursos y sus atributos, segmentos y métricas relacionados. Existen dos métodos: Search y SearchStream.

Las consultas de SearchAds360Service muestran una lista de instancias de SearchAds360Row:

  • Cada fila representa un recurso.
  • Si se solicita, las filas incluyen atributos y campos de métricas.
  • Si solicitas segmentos, se incluyen filas adicionales para cada tupla de segmento-recurso.

Consulta Cómo crear informes de búsqueda para obtener más información.

SearchAds360FieldService

Usa este servicio para consultar metadatos sobre los campos y recursos disponibles. El servicio proporciona un catálogo de campos consultables con detalles sobre su compatibilidad y tipo.

SearchAds360FieldService muestra una lista de instancias de SearchAds360Field:

  • Cada campo contiene detalles sobre el campo solicitado.

Consulta Cómo recuperar metadatos de recursos para obtener más información.

Ejemplos de consultas básicas

En las siguientes secciones, se proporcionan ejemplos de consultas básicas que puedes adaptar para compilar tus propias consultas.

Cómo consultar los atributos de un recurso

Esta es una consulta básica para los atributos del recurso campaign que muestra el ID, el nombre y el estado de la campaña:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Cada SearchAds360Row que se muestra representa un objeto campaign.
  • Las filas se propagan con los campos seleccionados (incluido el resource_name de la campaña determinada).
  • La consulta se ordena por ID de campaña.

Consulta campaign para ver otros campos disponibles que puedes usar en tus consultas.

Cómo consultar métricas

Esta es una consulta básica para las métricas relacionadas con los atributos del recurso campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • La consulta muestra campañas con el estado PAUSED y más de 1,000 impresiones.
  • Cada SearchAds360Row que se muestra tiene un campo metrics propagado con las métricas seleccionadas.
  • La consulta se ordena por ID de campaña.

Consulta metrics para ver otras métricas disponibles que puedes usar en tus consultas.

Cómo consultar segmentos

Esta es una consulta básica para segmentos relacionados con atributos del recurso campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • La consulta muestra campañas con el estado PAUSED y más de 1,000 impresiones.
  • Segmenta los datos por fecha.
  • Como resultado de la segmentación, cada SearchAds360Row representa una tupla de una campaña y el segmento de fecha.
  • La consulta se ordena por ID de campaña.

Consulta segments para obtener una lista de los segmentos que puedes usar en tus consultas y Segmentación para obtener más información sobre cómo segmentar tus informes.

Esta es una consulta básica en el recurso campaign que une los atributos del recurso bidding_strategy, si está disponible. Este tipo de recurso relacionado se conoce como recurso atribuido.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • La consulta selecciona los atributos de la campaña y los atributos relacionados de cada campaña seleccionada.
  • Cada SearchAds360Row que se muestra representa un objeto campaign propagado con los atributos de la campaña seleccionados, así como el atributo de la estrategia de ofertas seleccionado, bidding_strategy.name.

Consulta campaign para descubrir qué recursos atribuidos están disponibles para las consultas de campañas.

Cómo consultar metadatos de campos

Puedes usar SearchAds360FieldService para recuperar los metadatos de los campos.

Esta es una consulta básica para los metadatos de campo:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Reemplaza RECURSO O CAMPO por un recurso (como customer o campaign) o un campo (como campaign.id, metrics.impressions o ad_group.id).

Consulta Cómo recuperar metadatos de recursos para obtener más información sobre cómo recuperar metadatos de campo.

Más información

Obtén más información para crear consultas en la API de Search Ads 360 Reporting: