Query Builder di Google Ads è uno strumento interattivo progettato per aiutarti a creare e convalidare in modo interattivo le query utilizzando Google Ads Query Language (GAQL). Che tu sia un utente alle prime armi o esperto di GAQL, Query Builder può semplificare il processo di recupero dei dati esatti di cui hai bisogno dall'API Google Ads.
Vantaggi
- Facilità d'uso:semplifica il processo di scrittura delle query GAQL, senza richiedere familiarità con la sintassi specifica e i campi disponibili.
- Rilevabilità:consente di esplorare e trovare risorse, campi, segmenti e metriche disponibili all'interno del modello di dati dell'API Google Ads.
- Errori ridotti:fornendo un'interfaccia strutturata e menu a discesa di opzioni valide, aiuta a evitare errori di sintassi e di battitura, garantendo che la query generata sia valida.
- Creazione più rapida delle query:accelera il processo di sviluppo automatizzando la generazione di stringhe di query.
- Convalida:lo strumento è collegato a Explorer API e Query Validator per controllare le query in base alle regole dell'API prima dell'esecuzione.
Come funziona
Lo strumento di creazione delle query Google Ads fornisce un'interfaccia intuitiva per assemblare visivamente le query GAQL. Ecco il flusso di lavoro di base:
- Seleziona una risorsa:inizia scegliendo la risorsa principale dalla scheda
Riferimento per la versione
che vuoi interrogare. Questa risorsa si troverà nella clausola
FROM. Le risorse rappresentano entità all'interno di Google Ads, ad esempiocampaign,ad_groupokeyword_view. Il builder elenca tutte le risorse disponibili. - Scegli campi:una volta selezionata una risorsa, lo strumento mostra tutti i campi selezionabili, inclusi attributi, segmenti e metriche correlati a quella risorsa e alle risorse a cui è attribuita (unibili implicitamente). Puoi
selezionare le caselle di controllo per includere i campi nella clausola
SELECT. Man mano che effettui le selezioni, lo strumento genera dinamicamente la stringa di query GAQL corrispondente, mostra eventuali errori e filtra le combinazioni di campi incompatibili. - Applica filtri:puoi aggiungere condizioni di clausola
WHEREper filtrare i risultati. Il generatore ti aiuta a scegliere campi, operatori e valori, garantendo una sintassi corretta. - Order results (Ordina risultati): specifica gli ordini di ordinamento utilizzando la clausola
ORDER BY. - Imposta limiti:aggiungi una clausola
LIMITper controllare il numero di risultati restituiti. - Convalida:lo strumento ti guida intrinsecamente verso combinazioni di campi valide, ma fornisce anche un link a Explorer API in modo che tu possa testare la query rispetto ai dati dell'account. Esiste anche uno [strumento di convalida delle query](link alla pagina) separato in cui puoi incollare e controllare manualmente le query GAQL scritte.
- Esporta:una volta soddisfatto della query, copia e incolla la stringa GAQL testata e sintatticamente corretta nelle richieste client
GoogleAdsService.SearchoSearchStream.
Il generatore garantisce che i campi, i segmenti e le metriche selezionati siano compatibili e possano essere utilizzati insieme in un'unica query, facendo riferimento ai metadati sottostanti dell'API Google Ads.
Inizia
Esistono due modi per accedere a Query Builder. Un'opzione è consultare una pagina specifica nella documentazione di riferimento sui report, mentre l'altra è esplorare dalla pagina di panoramica dello Strumento di creazione delle query.
Dalla documentazione di riferimento per i report
- Inizia con i documenti di riferimento per i report e scegli una risorsa specifica da cui iniziare nell'elenco di tutte le risorse. In alternativa, vai direttamente alla risorsa dal riquadro di navigazione a sinistra.
- Fai clic su Aiutami a creare una query, che ti indirizza a Query Builder per quella risorsa specifica.
Dalla pagina di panoramica di Query Builder
Vai alla sezione Query Builder della documentazione di riferimento per i report e seleziona la risorsa che vuoi esplorare.
Integrazione con altri strumenti
Query Builder è integrato con altri strumenti nel toolkit per sviluppatori dell'API Google Ads. Puoi prendere una query creata in Query Builder e testarla in Explorer API o convalidarla con Query Validator.
API Explorer
Dopo aver creato la query, fai clic su Prova in Explorer API per aprirla in Explorer API. La query verrà compilata automaticamente nel corpo della richiesta e potrai testarla eseguendola sui dati del tuo account. Per saperne di più su questo strumento, consulta la pagina Explorer API.
Query Validator
Quando fai clic su Inserisci o modifica una query, si apre il validatore di query. Utilizza lo strumento di convalida delle query per convalidare la sintassi della query. Qualsiasi query creata interamente tramite Query Builder avrà già la sintassi corretta, ma se hai familiarità con la risorsa su cui stai eseguendo la query, Query Validator ti fornirà un modo rapido per inserire una query e verificarne la validità. Per saperne di più su questo strumento, consulta Query Validator.