Google Ads Query Validator

Lo strumento di convalida query Google Ads è uno strumento interattivo progettato per aiutare gli sviluppatori a creare e verificare le query Google Ads Query Language (GAQL) prima di integrarle nelle applicazioni. Ti consente di inserire una stringa di query GAQL e di ricevere un feedback immediato sulla sua validità, aiutandoti a rilevare errori di sintassi, incompatibilità dei campi e altri problemi nelle prime fasi del processo di sviluppo.

Vantaggi

  • Prevenzione degli errori: rileva tempestivamente le query non valide, prima che vengano integrate nelle applicazioni, riducendo gli errori di runtime e gli errori delle chiamate API.
  • Sviluppo più rapido: consente di testare ed eseguire il debug delle istruzioni GAQL in modo rapido senza l'overhead dei cicli completi di richiesta API e risposta.
  • Comprensione dei vincoli GAQL: aiuta gli sviluppatori a comprendere le regole complesse relative ai campi compatibili e alla relazione tra le risorse.
  • Query di debug: fornisce messaggi di errore specifici quando una query non è valida, spesso più dettagliati di un errore API generico, e a volte suggerisce alternative valide.
  • Efficienza delle risorse: evita chiamate API non necessarie con query destinate a non riuscire.

Come funziona

Lo strumento di convalida query analizza la query GAQL in base allo schema dell'API Google Ads e alle regole definite in Google Ads Query Language. Utilizza i metadati, molti dei quali sono accessibili da GoogleAdsFieldService, per eseguire controlli, tra cui:

  1. Sintassi e struttura: garantisce che la query segua la grammatica GAQL corretta, incluso l'uso e l'ordine corretti di clausole come SELECT, FROM, WHERE, ORDER BY, LIMIT e PARAMETERS.
  2. Validità dei campi: verifica se tutti i campi specificati (risorse, segmenti, metriche) esistono e sono scritti correttamente.
  3. Compatibilità delle risorse: verifica che i campi selezionati nella clausola SELECT siano compatibili con la risorsa principale specificata nella clausola FROM.
  4. Compatibilità di segmenti e metriche: garantisce che i segmenti e le metriche utilizzati insieme nella stessa query siano compatibili tra loro e con la risorsa nella clausola FROM.
  5. Requisiti delle clausole: convalida regole come il requisito per cui i campi utilizzati nelle clausole ORDER BY e alcuni campi utilizzati nelle clausole WHERE (come i segmenti) devono essere presenti anche nella clausola SELECT.
  6. Utilizzo degli operatori: verifica l'utilizzo corretto degli operatori all'interno delle condizioni della clausola WHERE.

Se la query è valida, lo strumento lo conferma. Se vengono rilevati problemi, fornisce messaggi di errore progettati per aiutare a individuare il problema, a volte offrendo suggerimenti per le correzioni, ad esempio risorse compatibili per una determinata metrica.

Inizia

Per utilizzare lo strumento di convalida delle query Google Ads:

  1. Vai allo strumento di convalida query.
  2. Inserisci la query GAQL.
  3. Fai clic sul pulsante Convalida query.
  4. Esamina il messaggio di convalida visualizzato sotto il widget dello strumento di convalida query. Un messaggio di operazione riuscita indica che la query è valida. In caso contrario, viene visualizzato un messaggio di errore che descrive il problema. I messaggi di errore ti guidano nella correzione della query. Ad esempio, un errore di incompatibilità dei campi potrebbe elencare risorse alternative compatibili con la metrica o il segmento su cui stai tentando di eseguire una query.

Per spiegazioni più approfondite dei concetti e della sintassi di GAQL, consulta la guida a Google Ads Query Language. Per creare e testare in modo interattivo le query GAQL, puoi anche utilizzare Query Builder ed Explorer API.