Google Ads Sorgu Oluşturucu

Google Ads Sorgu Oluşturucu, Google Ads Sorgu Dili'ni (GAQL) kullanarak sorgular oluşturmanıza ve doğrulamanıza yardımcı olmak için tasarlanmış etkileşimli bir araçtır. GAQL'de yeni olsanız da deneyimli bir kullanıcı olsanız da sorgu oluşturucu, Google Ads API'den ihtiyacınız olan verileri tam olarak getirme sürecini basitleştirebilir.

Avantajları

  • Kullanım kolaylığı: Belirli söz dizimi ve kullanılabilir alanlar hakkında bilgi sahibi olmayı gerektirmeden GAQL sorguları yazma sürecini basitleştirir.
  • Bulunabilirlik: Google Ads API veri modelindeki mevcut kaynakları, alanları, segmentleri ve metrikleri keşfetmeye ve bulmaya yardımcı olur.
  • Daha az hata: Yapılandırılmış bir arayüz ve geçerli seçeneklerin yer aldığı açılır menüler sunarak söz dizimi hatalarını ve yazım hatalarını önlemeye yardımcı olur. Böylece oluşturulan sorgunun geçerli olması sağlanır.
  • Daha hızlı sorgu oluşturma: Sorgu dizelerinin oluşturulmasını otomatikleştirerek geliştirme sürecini hızlandırır.
  • Doğrulama: Araç, sorguları yürütülmeden önce API kurallarına göre kontrol etmek için API Gezgini ve Sorgu Doğrulayıcı'ya bağlıdır.

İşleyiş şekli

Google Ads Sorgu Oluşturucu, GAQL sorgularını görsel olarak birleştirmek için kullanıcı dostu bir arayüz sağlar. Temel iş akışı şu şekildedir:

  1. Kaynak seçme: Sorgulamak istediğiniz sürüm için Referans sekmesinden birincil kaynağı seçerek başlayın. Bu kaynak, FROM maddesine yerleştirilir. Kaynaklar, Google Ads'deki campaign, ad_group veya keyword_view gibi öğeleri temsil eder. Oluşturucu, mevcut tüm kaynakları listeler.
  2. Alanları seçin: Bir kaynak seçildikten sonra araç, bu kaynak ve ilişkilendirilmiş (örtülü olarak birleştirilebilir) kaynaklarıyla ilgili özellikler, segmentler ve metrikler dahil olmak üzere seçilebilir tüm alanları gösterir. Alanları SELECT maddenize dahil etmek için kutuları işaretleyebilirsiniz. Seçimlerinizi yaparken araç, karşılık gelen GAQL sorgu dizesini dinamik olarak oluşturur, hataları gösterir ve uyumsuz alan kombinasyonlarını filtreler.
  3. Filtre uygulama: Sonuçları filtrelemek için WHERE koşulları ekleyin. Oluşturucu, doğru söz dizimi sağlamak için alanları, operatörleri ve değerleri seçmenize yardımcı olur.
  4. Sonuçları sıralama: ORDER BY ifadesini kullanarak sıralama düzenlerini belirtin.
  5. Sınır belirleme: Döndürülen sonuç sayısını kontrol etmek için LIMIT ifadesini ekleyin.
  6. Doğrulama: Araç, geçerli alan kombinasyonlarına yönlendirir ve sorgunuzu hesap verilerinizle karşılaştırarak test edebilmeniz için API Gezgini'ne bağlantı verir. Ayrıca, manuel olarak yazılmış GAQL sorgularını yapıştırıp kontrol edebileceğiniz ayrı bir Sorgu Doğrulayıcı da vardır.
  7. Dışa aktarma: Sorgunuzdan memnun kaldığınızda test edilmiş, söz dizimi açısından doğru GAQL dizenizi kopyalayıp GoogleAdsService.Search veya SearchStream istemci isteklerinize yapıştırın.

Oluşturucu, seçilen alanların, segmentlerin ve metriklerin uyumlu olmasını ve Google Ads API'nin temel meta verilerine referans vererek tek bir sorguda birlikte kullanılabilmesini sağlar.

Başlayın

Sorgu Oluşturucu'ya ulaşmanın iki yolu vardır: Raporlama referans dokümanlarındaki belirli bir sayfayı inceleyebilir veya Sorgu Oluşturucu'ya genel bakış sayfasından keşfe çıkabilirsiniz.

Bildirim referans dokümanlarından

  1. Raporlama referans dokümanlarıyla başlayın ve tüm kaynakların listesinde belirli bir kaynak seçin. Alternatif olarak, soldaki gezinme bölmesinden doğrudan kaynağa gidebilirsiniz.
  2. Sorgu oluşturmama yardım et'i tıklayın. Bu işlem sizi söz konusu kaynak için Sorgu Oluşturucu'ya yönlendirir.

Sorgu oluşturucuya genel bakış sayfasından

Raporlama referans dokümanlarının Sorgu Oluşturucu bölümüne gidip keşfetmek istediğiniz kaynağı seçin.

Diğer araçlarla entegrasyon

Sorgu Oluşturucu, Google Ads API Geliştirici Araç Seti'ndeki diğer araçlarla entegre edilmiştir. Sorgu Oluşturucu'da oluşturulan bir sorguyu alıp API Explorer'da test edebilir veya Sorgu Doğrulayıcı ile doğrulayabilirsiniz.

API Explorer

Sorgunuzu oluşturduktan sonra API Gezgini'nde dene'yi tıklayarak sorgunuzu API Gezgini'nde açın. Sorgunuz istek gövdesine otomatik olarak doldurulur. Ardından, sorgunuzu hesap verilerinizle çalıştırarak test edebilirsiniz. Bu araç hakkında daha fazla bilgi için API Gezgini'ne bakın.

Sorgu Doğrulayıcı

Sorgu girin veya düzenleyin'i tıkladığınızda Sorgu Doğrulayıcı açılır. Sorgunuzun söz dizimini doğrulamak için sorgu doğrulayıcıyı kullanın. Tamamen Sorgu Oluşturucu ile oluşturulan sorgular zaten doğru söz dizimine sahiptir. Ancak sorguladığınız kaynak hakkında bilginiz varsa Sorgu Doğrulayıcı, sorgu girmek ve geçerliliğini kontrol etmek için hızlı bir yol sunar. Bu araç hakkında daha fazla bilgi için Sorgu Doğrulayıcı başlıklı makaleyi inceleyin.