Bu kılavuzda, Google Ads kullanıcı arayüzündeki raporlara ilişkin kavramlar ve adlandırma kuralları, Google Ads Sorgu Dili (GAQL) ve Google Ads API'yi kullanarak oluşturabileceğiniz raporlarla eşleştirilmektedir.
Sık kullanılan kullanıcı arayüzü terimleri
Aşağıdaki tabloda, kullanıcı arayüzünde yaygın olarak kullanılan bazı terimler ve bunların Google Ads Sorgu Dili (GAQL) ile olan eşleşmeleri özetlenmiştir.
| kullanıcı arayüzü | GAQL |
|---|---|
| Sütunlar | GAQL sorgusunun SELECT yan tümcesindeki herhangi bir kaynak, segment alanı veya metrik. |
| Tarih Aralığı | Tarih aralıkları, segments.date üzerinde bir WHERE yan tümcesi filtrelemesiyle eşlenir. |
| Filtreler | WHERE yan tümcesinde bir veya daha fazla koşul. |
| Segment alanları | GAQL sorgunuza segment alanları ekleyerek segmentasyon uygulayın. |
| Sayfaları numaralandırma | Çağrı işlevi, sorgunun sonuç kümesini birden fazla sayfaya böler. |
Sütunlar
Kullanıcı arayüzündeki sütunlar GAQL'deki Kaynak alanları, Segment alanları ve Metrikler ile eşdeğerdir.
Filtreleme
Tarih aralıkları
Google Ads kullanıcı arayüzünde, hesap istatistiklerini gösteren bir tablo ve bu istatistiklerin tarih aralığını kontrol etmek için bir açılır menü bulunur.
GAQL sorgusunun WHERE yan tümcesinde segments.date filtreleme yaparak GAQL'de de aynı kontrole sahip olursunuz.
Filtreler
Kullanıcı arayüzündeki filtreler, GAQL'nin WHERE yan tümcesinde bulunan bir veya daha fazla koşula eşdeğerdir.
Segmentasyon
Daha ayrıntılı istatistikler için verileri segmentlere bölebilirsiniz. Örneğin, Google Arama Ağı'na özel gösterimlerin sayısını, Google Görüntülü Reklam Ağı'ndan ayrı olarak görmek isteyebilirsiniz. Bu durumda, raporunuzu ağa göre segmentlere ayırırsınız. SELECT ibaresine segment alanlarının nasıl dahil edileceği hakkında Segmentasyon konusuna bakın.
Sayfalara ayırma
Kullanıcı arayüzünde, sayfalar arasında geçiş yapmanıza ve tanımlanmış bir boyut kümesinden görüntülenecek sonuç sayısını seçmenize olanak tanıyan, her veri tablosunun altında bulunan denetimleri kullanarak raporlarınızda gezinirsiniz.
GoogleAdsService.Search ile next_page_token arasındaki raporlar alınırken sonuçlara göz atılabilir. Sonuç kümesinin tamamını sayfalara ayırmadan getirmek için GoogleAdsService.SearchStream kullanın.
Sipariş sonuçları
Kullanıcı arayüzünde, bir sütun seçerek sonuçları sıralayabilirsiniz.
GAQL'de sorgu sonucunuzu sıralamak için ORDER BY yan tümcesini ve LIMIT yan tümcesini kullanabilirsiniz.
İndirme biçimleri
Kullanıcı arayüzünde raporlar CSV, TSV veya XML gibi çeşitli biçimlerde indirilebilir.
API, çıkışında farklı biçimleri doğrudan desteklemediği için bazı son işlemler yapmanız gerekir. Bir istemcide CSV biçimlendirmesinin nasıl uygulanacağını gösteren kod örneğine bakın.
Raporları planlama ve e-postayla gönderme
Raporun planlanması ve e-posta ile gönderilmesi, kullanıcı arayüzünde kullanılabilir ancak API'de desteklenmez.
Önceden Tanımlanmış Raporlar
Google Ads kullanıcı arayüzünde, önceden tanımlanmış raporlardan oluşan bir liste oluşturabilirsiniz.
Önceden tanımlanmış temel raporların ve eşleşen GAQL Kaynak Adlarının listesi aşağıda verilmiştir.
| Önceden Tanımlanmış Temel Raporlar | GAQL Kaynak Adı (FROM yantümcesinde belirtin) |
|---|---|
| Hesap | müşteri |
| Kampanya, Kampanya ayrıntıları |
kampanya |
| Reklam grubu, Reklam grubu ayrıntıları |
ad_group |
|
Reklam, Nihai URL |
ad_group_ad |
| Arama anahtar kelimesi | keyword_view |
| Arama terimleri | search_term_view |
| Ücretli ve organik | paid_organic_search_term_view |
| Açılış sayfası | landing_page_view |
| Genişletilmiş açılış sayfası | expanded_landing_page_view |
Yukarıdaki tablodan örnek olarak, Hesap raporunu oluşturmak için aşağıdaki GAQL'yi kullanabilirsiniz:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
Yaygın farklılıklar
Kullanıcı arayüzü raporları API raporlarıyla karşılaştırılırken en yaygın farklardan biri, kullanıcı arayüzünün kaldırılan varlıkları dolaylı olarak filtrelerken API'nin bunu yapmamasıdır.
Varsayılan bir kullanıcı arayüzü görünümünü kopyalamak için bir filtre (genellikle bir status alanı kullanarak) ekleyerek kaldırılan satırları hariç tutmanız gerekir. Örneğin:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"