Linguaggio di query Search Ads 360

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

Servizi di ricerca

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

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

Per ulteriori informazioni, consulta Creare report sulla rete di ricerca.

SearchAds360FieldService

Utilizza questo servizio per eseguire query sui metadati sui campi e sulle risorse disponibili. Il servizio fornisce un catalogo di campi interrogabili con informazioni dettagliate sulla loro compatibilità e sul loro tipo.

SearchAds360FieldService restituisce un elenco di SearchAds360Field istanze:

  • Ogni campo contiene i dettagli del campo richiesto.

Per saperne di più, consulta Recupero dei 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.

Esegui una query per gli 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 SearchAds360Row restituito rappresenta un oggetto campaign.
  • Le righe vengono compilate con i campi selezionati (incluso resource_name della campagna specificata).
  • La query viene ordinata in base all'ID campagna.

Per altri campi disponibili che puoi utilizzare nelle query, consulta campaign.

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 le campagne con lo stato PAUSED e più di 1000 impressioni.
  • Ogni SearchAds360Row restituito ha un campo metrics compilato con le metriche selezionate.
  • La query viene ordinata in base all'ID campagna.

Per altre metriche disponibili che puoi utilizzare nelle query, consulta metrics.

Esegui 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 le campagne con lo stato PAUSED e più di 1000 impressioni.
  • Segmenta i dati in base alla data.
  • In seguito alla segmentazione, ogni SearchAds360Row rappresenta una tupla di una campagna e del segmento di date.
  • La query viene ordinata in base all'ID campagna.

Consulta segments per un elenco di segmenti che puoi 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 disponibili. 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 di ogni campagna selezionata.
  • Ogni elemento SearchAds360Row restituito rappresenta un oggetto campaign completato con gli attributi della campagna selezionati e l'attributo della strategia di offerta selezionata, bidding_strategy.name.

Consulta campaign per scoprire quali risorse attribuite sono disponibili per le query sulle campagne.

Esegui una 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 RISORSA O CAMPO con una risorsa (ad esempio customer o campaign) o un campo (ad esempio campaign.id,metrics.impressions o ad_group.id).

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

Scopri di più

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