Google Ads Query Validator

Lo strumento di convalida delle 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. Consente di inserire una stringa di query GAQL e ricevere un feedback immediato sulla sua validità, contribuendo a rilevare errori di sintassi, incompatibilità dei campi e altri problemi nelle prime fasi del processo di sviluppo.

Vantaggi

  • Prevenzione degli errori: rileva le query non valide in anticipo, 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 rapidamente delle istruzioni GAQL senza l'overhead dei cicli completi di richiesta e risposta dell'API.
  • Comprendere i vincoli di GAQL:aiuta gli sviluppatori a conoscere le regole complesse relative alla compatibilità dei campi 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

Query Validator analizza la tua query GAQL in base allo schema dell'API Google Ads e alle regole definite nel linguaggio di query Google Ads. 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 delle clausole come SELECT, FROM, WHERE, ORDER BY e LIMIT.
  2. Validità dei campi:verifica che tutti i campi specificati (risorse, segmenti, metriche) esistano e siano 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 le regole, ad esempio il requisito che alcuni campi utilizzati nelle clausole WHERE o ORDER BY siano presenti anche nella clausola SELECT.
  6. Utilizzo degli operatori: verifica il corretto utilizzo degli operatori all'interno delle condizioni della clausola WHERE.

Se la query è valida, lo strumento lo conferma. Se vengono rilevati problemi, vengono visualizzati 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 delle query.
  2. Inserisci la query GAQL.
  3. Fai clic sul pulsante Convalida query.
  4. Esamina il messaggio di convalida visualizzato sotto il widget di convalida delle 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 per correggere la query. Ad esempio, un errore di incompatibilità dei campi potrebbe elencare risorse alternative compatibili con la metrica o il segmento per cui stai tentando di eseguire una query.

Per spiegazioni più approfondite dei concetti e della convalida di GAQL, puoi anche consultare le guide video su GAQL.