Google Ads Query Builder è uno strumento interattivo progettato per aiutarti a creare e convalidare le query utilizzando Google Ads Query Language (GAQL). Che tu sia un utente esperto o alle prime armi con 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à: aiuta a esplorare e trovare risorse, campi, segmenti e metriche disponibili nel modello di dati dell'API Google Ads.
- Riduzione degli errori: fornendo un'interfaccia strutturata e menu a discesa di opzioni valide, aiuta a prevenire errori di sintassi e di battitura, garantendo che la query generata sia valida.
- Creazione più rapida delle query: velocizza il processo di sviluppo automatizzando la generazione di stringhe di query.
- Convalida: lo strumento è collegato a Explorer API e allo strumento di convalida delle query per controllare le query rispetto alle regole dell'API prima dell'esecuzione.
Come funziona
Query Builder di 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 viene inserita nella clausola
FROM. Le risorse rappresentano entità all'interno di Google Ads, comecampaign,ad_groupokeyword_view. Lo strumento di creazione elenca tutte le risorse disponibili. - Scegli i campi: una volta selezionata una risorsa, lo strumento visualizza tutti i campi selezionabili, inclusi attributi, segmenti e metriche correlati alla risorsa e alle relative risorse attribuite (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, visualizza eventuali errori e filtra le combinazioni di campi incompatibili. - Applica filtri: aggiungi condizioni della clausola
WHEREper filtrare i risultati. Lo strumento di creazione ti aiuta a scegliere campi, operatori e valori, garantendo una sintassi corretta. - Ordina i 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 e si collega anche a Explorer API in modo che tu possa testare la query rispetto ai dati dell'account. È disponibile anche uno strumento di convalida 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.
Lo strumento di creazione 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: tramite una pagina specifica nella documentazione di riferimento per i report o esplorando dalla pagina Panoramica di Query Builder.
Dalla documentazione di riferimento per i report
- Inizia con la documentazione 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 per accedere a Query Builder per la risorsa specifica.
Dalla pagina 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 lo strumento di convalida query.
Explorer API
Dopo aver creato la query, fai clic su Prova in Explorer API per aprirla in Explorer API. La query viene inserita automaticamente nel corpo della richiesta e puoi quindi testarla eseguendola sui dati dell'account. Per ulteriori informazioni su quello strumento, consulta Explorer API.
Strumento di convalida delle query
Quando fai clic su Inserisci o modifica una query, si apre lo strumento di convalida query. Utilizza lo strumento di convalida query per convalidare la sintassi della query. Qualsiasi query creata interamente tramite Query Builder ha già la sintassi corretta, ma se hai familiarità con la risorsa su cui stai eseguendo la query, lo strumento di convalida query fornisce un modo rapido per inserire una query e verificarne la validità. Per ulteriori informazioni su questo strumento, consulta Strumento di convalida query.