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 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 attributi e campi delle metriche.
  • Se richiedi segmenti, vengono incluse righe aggiuntive per ogni tupla risorsa-segmento.

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 dettagli sulla loro compatibilità e sul loro tipo.

SearchAds360FieldService restituisce un elenco di istanze SearchAds360Field:

  • Ogni campo contiene i dettagli del campo richiesto.

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

Esempi di query di base

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

Eseguire query per gli attributi di una risorsa

Si tratta di 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 il resource_name della campagna specificata).

  • La query ordina per ID campagna.

Consulta campaign per altri campi disponibili che puoi utilizzare nelle tue query.

Eseguire query per le metriche

Si tratta di 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 ordina per ID campagna.

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

Eseguire query per i segmenti

Si tratta di una query di base per i segmenti correlati 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.

  • A seguito della segmentazione, ogni SearchAds360Row rappresenta una tupla di una campagna e del segmento di date.

  • La query ordina per ID campagna.

Consulta segments per un elenco dei segmenti che puoi utilizzare nelle query e Segmentazione per saperne di più sulla segmentazione dei report.

Si tratta di una query di base sulla risorsa campaign che unisce gli attributi della risorsa bidding_strategy, se disponibili. Questo tipo di risorsa correlata è noto 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 compilato con gli attributi della campagna selezionati, nonché con l'attributo della strategia di offerta selezionata, bidding_strategy.name.

Consulta 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 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: