Bu kılavuzda, Google Ads kullanıcı arayüzündeki raporlarla ilgili kavramlar ve adlandırma kuralları, Google Ads sorgu dili (GAQL) ve Google Ads API'yi kullanarak oluşturabileceğiniz raporlarla eşleştirilir.
Sık kullanılan kullanıcı arayüzü terimleri
Aşağıdaki tabloda, kullanıcı arayüzünde kullanılan yaygın terimlerden bazıları ve bu terimlerin Google Ads Sorgu Dili (GAQL) ile eşlemeleri özetlenmiştir.
| Kullanıcı Arayüzü | GAQL |
|---|---|
| Sütunlar | GAQL sorgusunun SELECT yan tümcesinde yer alan tüm kaynaklar, segment alanları veya metrikler. |
| Tarih Aralığı | Tarih aralıkları, segments.date üzerinde filtreleme yapan bir WHERE yan tümcesine 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 | Sayfalama, 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 ile filtreleyerek GAQL'de de aynı denetime sahip olursunuz.
Filtreler
Kullanıcı arayüzündeki filtreler, GAQL'nin WHERE yan tümcesinde yer alan bir veya daha fazla koşula eşdeğerdir.
Segmentasyon
Daha ayrıntılı istatistikler için verileri segmentlere ayırabilirsiniz. Örneğin, Google Arama Ağı'na özgü 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ırabilirsiniz. SELECT ifadesine segment alanlarının nasıl dahil edileceği hakkında bilgi edinmek için Segmentasyon başlıklı makaleyi inceleyin.
Sayfalara ayırma
Her veri tablosunun alt kısmındaki kontrolleri kullanarak kullanıcı arayüzündeki raporlarınızda gezinebilirsiniz. Bu kontroller, sayfalar arasında geçiş yapmanıza ve tanımlanmış bir boyut grubundan gösterilecek sonuç sayısını seçmenize olanak tanır.
next_page_token aracılığıyla GoogleAdsService.Search ile rapor alırken sonuçlara göz atabilirsiniz. Sayfalandırma olmadan sonuç kümesinin tamamını almak için GoogleAdsService.SearchStream değerini kullanın.
Sıralama 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ğinden bazı son işlemler yapmanız gerekir. CSV biçimlendirmesinin istemciye nasıl uygulanacağını gösteren bir kod örneğine göz atın.
Raporları planlama ve e-postayla gönderme
Rapor planlama ve e-postayla gönderme özelliği 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ış raporların listesini oluşturabilirsiniz.
Temel önceden tanımlanmış raporların ve eşleşen GAQL Kaynak Adlarının listesi aşağıda verilmiştir.
| Temel Önceden Tanımlanmış Raporlar | GAQL Kaynak Adı (FROM yan tümcesinde belirtin) |
|---|---|
| Hesap | customer |
| Kampanya, Kampanya ayrıntıları |
campaign |
| 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 tabloda verilen örnekte olduğu gibi, 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
Sık karşılaşılan farklılıklar
Kullanıcı arayüzü raporları API raporlarıyla karşılaştırıldığında en yaygın farklardan biri, kullanıcı arayüzünün kaldırılan öğeleri dolaylı olarak filtrelemesi, API'nin ise bunu yapmamasıdır.
Varsayılan kullanıcı arayüzü görünümünü kopyalamak için, genellikle status alanı kullanarak kaldırılan satırları hariç tutmak üzere bir filtre eklemeniz gerekir. Örneğin:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"