Google Ads Query Builder, Google Ads Sorgu Dili'ni (GAQL) kullanarak sorguları etkileşimli bir şekilde 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 alma sürecini basitleştirebilir.
Avantajları
- Kullanım kolaylığı: Belirli söz dizimi ve kullanılabilir alanlar hakkında bilgi sahibi olmayı gerektirmeden GAQL sorgularını 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 bir araya getirmek için kullanıcı dostu bir arayüz sağlar. Temel iş akışı şöyledir:
- Kaynak seçme: Sorgulamak istediğiniz sürüm için Referans sekmesinden birincil kaynağı seçerek işe başlarsınız. Bu kaynak,
FROMmaddesinde yer alacak. Kaynaklar, Google Ads'dekicampaign,ad_groupveyakeyword_viewgibi öğeleri temsil eder. Oluşturucu, mevcut tüm kaynakları listeler. - 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ı
SELECTmaddenize dahil etmek için kutuları işaretleyebilirsiniz. Seçimlerinizi yaparken araç, ilgili GAQL sorgu dizesini dinamik olarak oluşturur, hataları gösterir ve uyumsuz alan kombinasyonlarını filtreler. - Filtre uygulama: Sonuçları filtrelemek için
WHEREkoşulları ekleyebilirsiniz. Oluşturucu, doğru söz dizimi sağlamak için alanları, operatörleri ve değerleri seçmenize yardımcı olur. - Sonuçları sıralama:
ORDER BYifadesini kullanarak sıralama düzenlerini belirtin. - Sınır belirleme: Döndürülen sonuç sayısını kontrol etmek için
LIMITifadesini ekleyin. - Doğrulama: Araç, geçerli alan kombinasyonlarına yönlendirmenize yardımcı olur. Ayrıca, 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ı](link to page) da vardır.
- Dışa aktarma: Sorgunuzdan memnun olduğunuzda, test edilmiş ve söz dizimi açısından doğru olan GAQL dizenizi kopyalayıp
GoogleAdsService.SearchveyaSearchStreamistemci 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 iki şekilde gidebilirsiniz. Bir seçenek, raporlama referans dokümanlarındaki belirli bir sayfayı incelemek, diğer seçenek ise Sorgu Oluşturucu'ya genel bakış sayfasından keşfetmektir.
Bildirme referans dokümanlarından
- 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.
- 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 dokümanlarının 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ö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. Sorgu Oluşturucu ile tamamen oluşturulan sorgular zaten doğru söz dizimine sahip olur. Ancak sorguladığınız kaynağı biliyorsanız Sorgu Doğrulayıcı, sorgu girmenin ve geçerliliğini kontrol etmenin hızlı bir yolunu sunar. Bu araç hakkında daha fazla bilgi için Sorgu Doğrulayıcı başlıklı makaleyi inceleyin.