Google Ads Sorgu Oluşturucu

Google Ads Sorgu Oluşturucu, Google Ads Sorgu Dili'ni (GAQL) kullanarak sorgu oluşturmanıza ve doğrulamanıza yardımcı olmak için tasarlanmış etkileşimli bir araçtır. GAQL'de yeni veya deneyimli bir kullanıcı olmanız fark etmeksizin Sorgu Oluşturucu, Google Ads API'den tam olarak ihtiyacınız olan verileri alma 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.
  • Keşfedilebilirlik: 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 ve oluşturulan sorgunun geçerli olmasını sağlar.
  • 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 yan tümcesine yerleştirilir. Kaynaklar, Google Ads'deki campaign, ad_group veya keyword_view gibi varlıkları temsil eder. Oluşturucu, mevcut tüm kaynakları listeler.
  2. Alanları seçme: Bir kaynak seçildikten sonra araç, ilgili kaynak ve ilişkilendirilen (dolaylı 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 yan tümce koşulları ekleyin. Oluşturucu, alanları, operatörleri ve değerleri seçmenize yardımcı olarak doğru söz dizimini sağlar.
  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 olduğunuzda, test edilmiş ve 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 iki şekilde erişebilirsiniz: Raporlama referans belgelerindeki belirli bir sayfaya giderek veya Sorgu Oluşturucu'ya genel bakış sayfasından keşfederek.

Raporlama referans belgelerinden

  1. Raporlama referans belgeleriyle başlayın ve tüm kaynaklar listesinden başlamak için 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 ilgili kaynağın Sorgu Oluşturucusu'na 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 deneyin'i 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. Sorgu Oluşturucu ile oluşturulan tüm sorgular 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 yöntem sunar. Bu araç hakkında daha fazla bilgi için Sorgu Doğrulayıcı'ya bakın.