Google Ads Sorgu Doğrulayıcı

Google Ads Query Validator, geliştiricilerin Google Ads Sorgu Dili (GAQL) sorgularını uygulamalara entegre etmeden önce oluşturup doğrulamalarına yardımcı olmak için tasarlanmış etkileşimli bir araçtır. Bu araç, bir GAQL sorgu dizesi girmenize ve geçerliliği hakkında anında geri bildirim almanıza olanak tanır. Böylece, geliştirme sürecinin başlarında söz dizimi hatalarını, alan uyumsuzluklarını ve diğer sorunları tespit edebilirsiniz.

Avantajları

  • Hata önleme: Geçersiz sorguları uygulamalara entegre edilmeden önce tespit ederek çalışma zamanı hatalarını ve API çağrısı hatalarını azaltır.
  • Daha hızlı geliştirme: Tam API isteği ve yanıt döngüleri ek yükü olmadan GAQL ifadelerinin hızlı bir şekilde test edilmesini ve hatalarının ayıklanmasını sağlar.
  • GAQL kısıtlamalarını anlama: Geliştiricilerin, hangi alanların uyumlu olduğu ve kaynakların birbirleriyle nasıl ilişkili olduğu hakkındaki karmaşık kuralları öğrenmesine yardımcı olur.
  • Sorgularda hata ayıklama: Bir sorgu geçersiz olduğunda belirli hata mesajları sağlar. Bu mesajlar genellikle genel bir API hatasından daha ayrıntılıdır ve bazen geçerli alternatifler önerir.
  • Kaynak verimliliği: Başarısız olacağı kesin olan sorgularla gereksiz API çağrıları yapılmasını önler.

İşleyiş şekli

Sorgu Doğrulayıcı, GAQL sorgunuzu Google Ads API'nin şemasına ve Google Ads Sorgu Dili'nde tanımlanan kurallara göre ayrıştırır. Kontrolleri gerçekleştirmek için meta verileri kullanır. Bu verilerin çoğuna GoogleAdsFieldService üzerinden erişilebilir. Bu kontrollerden bazıları şunlardır:

  1. Söz dizimi ve yapı: Sorgunun, SELECT, FROM, WHERE, ORDER BY, LIMIT ve PARAMETERS gibi yan tümcelerin doğru kullanımı ve sırası dahil olmak üzere doğru GAQL dil bilgisi kurallarına uymasını sağlar.
  2. Alan geçerliliği: Belirtilen tüm alanların (kaynaklar, segmentler, metrikler) mevcut olup olmadığını ve doğru yazılıp yazılmadığını kontrol eder.
  3. Kaynak uyumluluğu: SELECT yan tümcesinde seçilen alanların, FROM yan tümcesinde belirtilen birincil kaynakla uyumlu olduğunu doğrular.
  4. Segment ve metrik uyumluluğu: Aynı sorguda birlikte kullanılan segmentlerin ve metriklerin birbirleriyle ve FROM yan tümcesindeki kaynakla uyumlu olmasını sağlar.
  5. Yan tümce koşulları: ORDER BY yan tümcelerinde kullanılan alanların ve WHERE yan tümcelerinde kullanılan belirli alanların (ör. segmentler) SELECT yan tümcesinde de bulunması koşulu gibi kuralları doğrular.
  6. Operatör kullanımı: WHERE yan tümce koşullarında operatörlerin doğru kullanılıp kullanılmadığını kontrol eder.

Sorgu geçerliyse araç bunu onaylar. Sorun bulunursa sorunun tam olarak nerede olduğunu belirlemeye yardımcı olmak için tasarlanmış hata mesajları sağlar ve bazen belirli bir metrik için uyumlu kaynaklar gibi düzeltme önerileri sunar.

Başlayın

Google Ads Sorgu Doğrulayıcı'yı kullanmak için:

  1. Sorgu Doğrulayıcı'ya gidin.
  2. GAQL sorgunuzu girin.
  3. Validate Query (Sorguyu Doğrula) düğmesini tıklayın.
  4. Sorgu Doğrulayıcı widget'ının altında görünen doğrulama mesajını inceleyin. Sorgunun geçerli olduğunu belirten bir başarı mesajı gösterilir. Aksi takdirde, sorunu açıklayan bir hata mesajı gösterilir. Hata mesajları, sorguyu düzeltmeniz için size yol gösterir. Örneğin, alan uyumsuzluğu hatası, sorgulamaya çalıştığınız metrik veya segmentle uyumlu olan alternatif kaynakları listeleyebilir.

GAQL kavramları ve söz dizimi hakkında daha ayrıntılı açıklamalar için Google Ads Sorgu Dili kılavuzunu inceleyin. GAQL sorgularını etkileşimli olarak oluşturup test etmek için Sorgu Oluşturucu ve API Gezgini'ni de kullanabilirsiniz.