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
eSearchStream
.Le query
SearchAds360Service
restituiscono un elenco di istanzeSearchAds360Row
:- 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 istanzeSearchAds360Field
:- 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 oggettocampaign
. - 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 campometrics
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.
Query sugli attributi di una risorsa correlata
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 oggettocampaign
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
ocampaign
) o con un campo (ad es.campaign.id
,metrics.impressions
oad_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: