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
ySearchStream
.Las consultas
SearchAds360Service
muestran una lista de instancias deSearchAds360Row
:- 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 deSearchAds360Field
. 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 objetocampaign
. - 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 campometrics
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.
Consulta los atributos de un recurso relacionado
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 objetocampaign
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
ocampaign
) o un campo (comocampaign.id
,metrics.impressions
oad_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: