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ştirilmektedir.
Sık kullanılan kullanıcı arayüzü terimleri
Aşağıdaki tabloda, kullanıcı arayüzünde kullanılan bazı yaygın terimler ve bunların Google Ads Sorgu Dili (GAQL) ile eşleştirilmesi özetlenmiştir.
| kullanıcı arayüzü | GAQL (GAQL) |
|---|---|
| Sütunlar | Bir GAQL sorgusunun SELECT yan tümcesindeki herhangi bir kaynak, segment alanı veya metrik. |
| Tarih Aralığı | Tarih aralıkları, segments.date filtresinde WHERE ifadesi ile 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 | Arama, sorgunun sonuç grubunu birden fazla sayfaya böler. |
Sütunlar
Kullanıcı arayüzündeki sütunlar, GAQL'deki Kaynak alanları, Segment alanları ve Metrikler'e 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 etmenizi sağlayan bir açılır menü bulunur.
GAQL sorgusunun WHERE yan tümcesinde segments.date üzerinden filtreleme yaparak GAQL'de aynı kontrole sahip olursunuz.
Filtreler
Kullanıcı arayüzündeki filtreler, GAQL'nin WHERE tümcesindeki 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 ö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 ifadesine segment alanlarının nasıl dahil edileceği hakkında bilgi edinmek için Segmentasyon bölümüne bakın.
Sayfalara ayırma
Sayfaları değiştirmenize olanak tanıyan ve her bir veri tablosunun alt kısmında bulunan kontrolleri kullanarak kullanıcı arayüzünde raporlarınız arasında gezinebilir ve tanımlı bir boyut grubundan görüntülenecek sonuç sayısını seçebilirsiniz.
GoogleAdsService.Search ile next_page_token arasındaki raporları alırken sonuçlara göz atabilirsiniz. Sonuç kümesinin tamamını herhangi bir sayfalara ayırmadan getirmek için GoogleAdsService.SearchStream işlevini 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 desteklemez. Bu nedenle, bazı işleme sonrası işlemleri 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
Rapor planlama ve e-postayla gönderme 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.
Önceden tanımlanmış temel raporların listesini ve bunlarla eşleşen GAQL Kaynak Adlarını burada bulabilirsiniz.
| Temel Önceden Tanımlanmış Raporlar | GAQL Kaynak Adı (FROM yan tü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 bir ö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
Genel farklılıklar
Kullanıcı arayüzü raporları ile API raporları karşılaştırılırken en yaygın farklardan biri, kullanıcı arayüzünün kaldırılan varlıkları dolaylı olarak filtrelemesi, API'nin ise filtrelememesidir.
Varsayılan bir kullanıcı arayüzü görünümünü çoğaltmak için genellikle status alanı kullanarak kaldırılan satırları hariç tutmak için bir filtre eklemeniz gerekir. Örneğin:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"