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 de la siguiente manera:

SearchAds360Service

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

Las consultas de SearchAds360Service muestran una lista de SearchAds360Row instancias:

  • Cada fila representa un recurso.
  • Si se solicitan, las filas incluyen atributos y campos de métricas.
  • Si solicitas segmentos, se incluyen filas adicionales para cada tupla de segmento y 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 SearchAds360Field instancias:

  • 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 crear tus propias consultas.

Consulta 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 ordena por ID de campaña.

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

Consulta las 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 las 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 ordena por ID de campaña.

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

Consulta los segmentos

Esta es una consulta básica para los segmentos relacionados con los 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 las 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 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 sobre 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 campaña seleccionados, así como el atributo de estrategia de ofertas seleccionado, bidding_strategy.name.

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

Consulta los metadatos de los campos

Puedes usar SearchAds360FieldService para recuperar los metadatos de los campos.

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

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Reemplaza RESOURCE OR FIELD 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 los metadatos de los campos.

Más información

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