Google Ads Query Builder è 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.
- Riduzione degli errori:fornendo un'interfaccia strutturata e menu a discesa di opzioni valide, aiuta a evitare errori di sintassi e di battitura, garantendo la validità della query generata.
- 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 di 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
su cui vuoi eseguire la query. 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 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. - 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 all'Explorer API in modo che tu possa testare la query rispetto ai dati del tuo account. Esiste anche un convalidatore di query separato in cui puoi incollare e controllare le query GAQL scritte manualmente.
- 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 una singola 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 del Query Builder.
Dai documenti di riferimento per la generazione di 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 porta 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 del toolkit per sviluppatori dell'API Google Ads. Puoi prendere una query creata in Query Builder e testarla in API Explorer 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 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 che stai interrogando, 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.