Linguaggio di query Search Ads 360

Il linguaggio di query di Search Ads 360 consente di creare query di ricerca per recuperare e metadati delle risorse dei report utilizzando l'API Search Ads 360 Reporting.

Cerca servizi

Puoi utilizzare il linguaggio di query di Search Ads 360 per eseguire query sull'API utilizzando:

SearchAds360Service

Usa questo servizio per eseguire query sulle risorse e sui relativi attributi, segmenti e metriche. Esistono due metodi, Search e SearchStream.

Le query SearchAds360Service restituiscono un elenco di istanze SearchAds360Row:

  • Ogni riga rappresenta una risorsa.
  • Se richiesto, le righe includono attributi e campi delle metriche.
  • Se richiedi segmenti, vengono incluse righe aggiuntive per ogni tupla segmentata-risorsa.

Consulta Creare report di ricerca per ulteriori informazioni.

SearchAds360FieldService

Utilizza questo servizio per eseguire query sui metadati sui campi e sulle risorse disponibili. Il servizio fornisce un catalogo di campi interrogabili con le specifiche compatibilità e tipo.

SearchAds360FieldService restituisce un elenco di SearchAds360Field di Compute Engine:

  • Ogni campo contiene dettagli sul campo richiesto.

Per saperne di più, consulta Recuperare i metadati delle risorse.

Esempi di query di base

Le seguenti sezioni forniscono esempi di query di base che puoi adattare per creare le tue query.

Query sugli attributi di una risorsa

Questa è una query di base per gli attributi della risorsa campaign che restituisce l'ID, il nome e lo stato della campagna:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Ciascun oggetto SearchAds360Row restituito rappresenta un oggetto campaign.
  • Le righe vengono compilate con i campi selezionati (inclusi i campi della resource_name).
  • Gli ordini di query per ID campagna.

Vedi campaign per altri campi disponibili che puoi utilizzare nelle query.

Query sulle metriche

Questa è una query di base per le metriche relative agli attributi dell'campaign risorsa:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • La query restituisce le campagne con lo stato PAUSED e maggiore di 1000 impressioni.
  • Ogni SearchAds360Row restituito ha un campo metrics compilato con metriche selezionate.
  • Gli ordini di query per ID campagna.

Vedi metrics per altre e le metriche disponibili che puoi usare nelle tue query.

Query per i segmenti

Questa è una query di base per i segmenti correlati agli attributi dell'campaign risorsa:

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 query restituisce le campagne con lo stato PAUSED e maggiore di 1000 impressioni.
  • Segmentazione dei dati in base alla data.
  • Come risultato della segmentazione, ogni SearchAds360Row rappresenta una tupla di una campagna e il segmento di data.
  • Gli ordini di query per ID campagna.

Visita segments per un elenco di segmenti che puoi utilizzare nelle query e la segmentazione per ulteriori informazioni sulla segmentazione dei report.

Questa è una query di base sulla risorsa campaign che unisce gli attributi della bidding_strategy risorsa, se disponibile. Questo tipo di risorsa correlata è nota come risorsa attribuita.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • La query seleziona gli attributi della campagna e i relativi attributi da ogni campagna selezionata.
  • Ciascun oggetto SearchAds360Row restituito rappresenta un oggetto campaign compilato con gli attributi della campagna selezionati e la strategia di offerta selezionata bidding_strategy.name.

Vedi campaign per scoprire quali risorse attribuite sono disponibili per le query delle campagne.

Query per i metadati dei campi

Puoi utilizzare SearchAds360FieldService per recuperare i metadati dei campi.

Questa è una query di base per i metadati dei campi:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Sostituisci RESOURCE OR FIELD con una risorsa (ad esempio, customer o campaign) o un campo (ad es. campaign.id, metrics.impressions o ad_group.id).
di Gemini Advanced.

Consulta Recuperare i metadati delle risorse per saperne di più sul recupero dei campi. metadati.

Scopri di più

Scopri di più su come creare query nell'API Search Ads 360 Reporting: