Linguaggio di query Search Ads 360

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

Cerca nei servizi

Puoi utilizzare il Linguaggio di query di Search Ads 360 per eseguire query sull'API con:

SearchAds360Service

Utilizza 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 richieste, le righe includono campi di attributi e metriche.
  • Se richiedi segmenti, sono incluse righe aggiuntive per ogni tupla segmento-risorsa.

Per ulteriori informazioni, consulta Creare report di ricerca.

SearchAds360FieldService

Utilizza questo servizio per eseguire query sui metadati relativi ai campi e alle risorse disponibili. Il servizio fornisce un catalogo di campi interrogabili con specifiche relative alla compatibilità e al tipo.

SearchAds360FieldService restituisce un elenco di istanze SearchAds360Field:

  • 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
  • Ogni elemento SearchAds360Row restituito rappresenta un oggetto campaign.
  • Le righe vengono compilate con i campi selezionati (incluso il valore resource_name della campagna specificata).
  • Gli ordini delle query per ID campagna.

Consulta la sezione campaign per scoprire altri campi disponibili che puoi utilizzare nelle query.

Query sulle metriche

Questa è una query di base per le metriche relative agli attributi della risorsa 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 query restituisce campagne con lo stato PAUSED e più di 1000 impressioni.
  • Ogni elemento SearchAds360Row restituito ha un campo metrics completato con le metriche selezionate.
  • Gli ordini delle query per ID campagna.

Consulta metrics per altre metriche disponibili che puoi utilizzare nelle query.

Query sui segmenti

Questa è una query di base per i segmenti relativi agli attributi della risorsa 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 query restituisce campagne con lo stato PAUSED e più di 1000 impressioni.
  • Segmenta i dati per data.
  • A seguito della segmentazione, ogni SearchAds360Row rappresenta una tupla di una campagna e il segmento di date.
  • Gli ordini delle query per ID campagna.

Consulta segments per un elenco dei segmenti da utilizzare nelle query e Segmentazione per ulteriori informazioni sulla segmentazione dei report.

Questa è una query di base sulla risorsa campaign che unisce gli attributi della risorsa bidding_strategy, 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 gli attributi correlati da ogni campagna selezionata.
  • Ogni SearchAds360Row restituito rappresenta un oggetto campaign completato con gli attributi della campagna selezionati e l'attributo della strategia di offerta selezionato, bidding_strategy.name.

Consulta campaign per scoprire quali risorse attribuite sono disponibili per le query della campagna.

Query sui 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 RISORSE O CAMPO con una risorsa (ad es. customer o campaign) o con un campo (ad es. campaign.id, metrics.impressions o ad_group.id).

Per ulteriori informazioni sul recupero dei metadati dei campi, consulta Recupero dei metadati delle risorse.

Scopri di più

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