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 con la API de Search Ads 360 Reporting.

Buscar servicios

Puedes usar el lenguaje de consulta de Search Ads 360 para hacer búsquedas en la API con las siguientes opciones:

SearchAds360Service

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

Las consultas 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 solicita segmentos, se incluirán filas adicionales para cada uno segmento-recurso.

Consulta Cómo crear informes de búsquedas para 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 devuelve una lista de SearchAds360Field. instancias:

  • 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 para 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 (incluidos los campos de resource_name).
  • La consulta ordena por ID de campaña.

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

Consulta métricas

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

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 la métricas seleccionadas.
  • La consulta ordena por ID de campaña.

Consulta metrics para obtener más información disponibles para usar en tus consultas.

Consulta de segmentos

Esta es una búsqueda básica para segmentos relacionados con atributos de campaign recurso:

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 fechas.
  • La consulta ordena por ID de campaña.

Consulta segments para ver un una lista de segmentos que puedes utilizar en tus búsquedas y la opción Segmentación para obtener más información. información sobre cómo segmentar sus informes.

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

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • La consulta selecciona 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 la estrategia de ofertas seleccionada , bidding_strategy.name.

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

Consulta metadatos de campos

Puedes usar SearchAds360FieldService para recuperar metadatos de campos.

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 con un recurso (como, customer o campaign) o un campo (como campaign.id, metrics.impressions o ad_group.id).

Consulta Recupera metadatos de recursos para obtener más información sobre la recuperación de campos. metadatos.

Más información

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