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. Ti consente di inserire una stringa di query GAQL e ricevere un feedback immediato sulla sua validità, aiutandoti a individuare 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 il sovraccarico dei cicli completi di richiesta API e risposta.
  • Comprensione dei vincoli GAQL: aiuta gli sviluppatori a conoscere le regole complesse relative alla compatibilità dei campi e alla relazione tra le risorse.
  • Debug delle query: 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 delle query analizza la query GAQL rispetto allo schema dell'API Google Ads e alle regole definite in Google Ads Query Language. Utilizza i metadati, la maggior parte dei quali è accessibile da GoogleAdsFieldService, per eseguire i 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 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 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 l'uso 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 delle 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 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 nella correzione della query. Ad esempio, un errore di incompatibilità dei campi potrebbe elencare risorse alternative *compatibili* con la metrica o il segmento che stai tentando di interrogare.

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