Google Ads Sorgu Oluşturucu

Google Ads Query Builder, 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 olmanıza gerek kalmadan 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ütmeden ö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 oluşturmak için kullanıcı dostu bir arayüz sunar. 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. SELECT yan tümcenize alan eklemek için onay kutularını işaretleyebilirsiniz. Siz seçim yaptıkça araç, ilgili 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 ölçütlerini 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ı konusunda size yol gösterir ve sorgunuzu hesap verilerinizle 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, Google Ads API'nin temel meta verilerine referans vererek seçilen alanların, segmentlerin ve metriklerin uyumlu olmasını ve 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.

Raporlama referans belgelerinden

  1. Raporlama referans belgeleri ile başlayın ve tüm kaynaklar listesinden başlamak istediğiniz kaynağı 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 ilgili kaynak için Sorgu Oluşturucu'ya yönlendirir.

Sorgu Oluşturucu'ya genel bakış sayfasından

Raporlama referans belgelerinin Sorgu Oluşturucu bölümüne gidin ve 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 Gezgini'nde 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övdesinde otomatik olarak doldurulur. Ardından, sorgunuzu hesap verilerinizde ç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 aracılığıyla oluşturulan tüm sorgular zaten doğru söz dizimine sahiptir. Ancak sorguladığınız kaynağı biliyorsanız 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ı'ya bakın.