Google Ads Sorgu Doğrulayıcı

Google Ads Query Validator, geliştiricilerin Google Ads Query Language (GAQL) sorgularını oluşturup doğrulayarak uygulamalara entegre etmelerine yardımcı olmak için tasarlanmış etkileşimli bir araçtır. GAQL sorgu dizesi girmenize ve geçerliliği hakkında anında geri bildirim almanıza olanak tanır. Bu sayede, geliştirme sürecinin erken aşamalarında söz dizimi hatalarını, alan uyumsuzluklarını ve diğer sorunları yakalayabilirsiniz.

Avantajları

  • Hata önleme: Geçersiz sorguları uygulamalara entegre edilmeden önce yakalayarak ç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ülerinin 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 birbiriyle nasıl ilişkili olduğuyla ilgili karmaşık kuralları öğrenmesine yardımcı olur.
  • Sorgularda hata ayıklama: Bir sorgu geçersiz olduğunda genellikle genel bir API hatasından daha ayrıntılı olan ve bazen geçerli alternatifler öneren belirli hata mesajları sağlar.
  • Kaynak verimliliği: Başarısız olmaya mahkum sorgularla gereksiz API çağrılarını önler.

İşleyiş şekli

Sorgu Doğrulayıcı, GAQL sorgunuzu Google Ads API'nin şemasına ve Google Ads Sorgu Dilinde tanımlanan kurallara göre ayrıştırır. Aşağıdakiler dahil olmak üzere kontroller yapmak için meta verileri kullanır. Bu meta verilerin çoğu GoogleAdsFieldService üzerinden erişilebilir:

  1. Söz dizimi ve yapı: Sorgunun doğru GAQL dilbilgisine uygun olmasını sağlar. Buna SELECT, FROM, WHERE, ORDER BY ve LIMIT gibi ifadelerin doğru kullanımı ve sırası dahildir.
  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 ifadesinde seçilen alanların, FROM ifadesinde 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 ifadesindeki kaynakla uyumlu olmasını sağlar.
  5. Madde koşulları: WHERE veya ORDER BY maddelerinde kullanılan belirli alanların SELECT maddesinde de bulunması koşulu gibi kuralları doğrular.
  6. Operatör kullanımı: WHERE koşulundaki operatörlerin doğru şekilde kullanılıp kullanılmadığını kontrol eder.

Sorgu geçerliyse araç bunu onaylar. Sorun bulunursa sorunu belirlemeye yardımcı olmak için tasarlanmış hata mesajları gösterir. Bazen de 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. 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. Başarı mesajı, sorgunun geçerli olduğunu gösterir. Aksi takdirde, sorunu açıklayan bir hata mesajı gösterilir. Hata mesajları, sorguyu düzeltmenize yardımcı olur. Örneğin, bir alan uyumsuzluğu hatasında, sorgulamaya çalıştığınız metrik veya segmentle uyumlu *olan* alternatif kaynaklar listelenebilir.

GAQL kavramları ve doğrulama hakkında daha ayrıntılı açıklamalar için GAQL video rehberlerine de başvurabilirsiniz.