Lenguaje de consulta de Search Ads 360

El lenguaje de consulta de Search Ads 360 te permite crear búsquedas para recuperar datos de informes y metadatos de recursos mediante la API de informes de Search Ads 360.

Buscar servicios

Puedes usar Search Ads 360 Query Language para consultar la API mediante lo siguiente:

SearchAds360Service

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

Las consultas SearchAds360Service muestran una lista de instancias SearchAds360Row:

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

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 que se pueden consultar con detalles específicos sobre su compatibilidad y tipo.

SearchAds360FieldService muestra una lista de instancias de SearchAds360Field:

  • Cada campo contiene detalles sobre el campo solicitado.

Consulta Recupera 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.

Consulta los atributos de un recurso

Esta es una consulta básica sobre 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 realiza un orden 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 métricas relacionadas con 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 realiza un orden por ID de campaña.

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

Cómo realizar consultas de 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 realiza un orden por ID de campaña.

Consulta segments para obtener una lista de los segmentos que puedes utilizar 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 campaña seleccionados, así como el atributo de estrategia de oferta seleccionado, bidding_strategy.name.

Consulta campaign para descubrir qué recursos atribuidos están disponibles para las búsquedas de la campaña.

Consulta metadatos de campos

Puedes usar SearchAds360FieldService para recuperar metadatos de campo.

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

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 la sección sobre cómo recuperar metadatos de recursos para obtener más información sobre la recuperación de metadatos de campos.

Más información

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