Google Ads Sorgu Doğrulayıcı

Google Ads Sorgu Doğrulayıcı, 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. GAQL sorgu dizesi girmenize ve geçerliliği hakkında anında geri bildirim almanıza olanak tanır. Böylece, söz dizimi hatalarını, alan uyumsuzluklarını ve diğer sorunları geliştirme sürecinin erken aşamalarında yakalamanıza yardımcı olur.

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. Bu özellik, meta verileri (çoğu GoogleAdsFieldService üzerinden erişilebilir) kullanarak aşağıdaki kontrolleri gerçekleştirir:

  1. Söz dizimi ve yapı: Sorgunun doğru GAQL dil bilgisine uygun olmasını sağlar. Bu kapsamda, SELECT, FROM, WHERE, ORDER BY, LIMIT ve PARAMETERS gibi ifadelerin doğru şekilde ve doğru sırada kullanılması da yer alır.
  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ı: ORDER BY maddelerinde kullanılan alanların ve WHERE maddelerinde kullanılan belirli alanların (ör. segmentler) 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 kılavuzlarına da başvurabilir veya Sorgu Oluşturucu ile API Gezgini'ni kullanabilirsiniz.