Google Ads kullanıcı arayüzü, raporlama özellikleri sunar. Rapor oluşturmak için Google Ads hesabınızda oturum açın, sol gezinme menüsünde Kampanyalar'ı ve ardından Analizler ve raporlar'ı tıklayın. Sıfırdan rapor oluşturmak için Rapor düzenleyici'yi tıklayın.
Bu kılavuzda, Google Ads kullanıcı arayüzündeki yaygın raporlama kavramları ve adlandırma kuralları, Google Ads Sorgu Dili (GAQL) ve Google Ads API'yi kullanarak oluşturabileceğiniz raporlarla eşleştirilmektedir. İhtiyaçlarınıza en uygun raporu oluşturmak için kullanıcı arayüzündeki talimatları da uygulayabilirsiniz.
Araçlar ve kaynaklar
Kullanıcı arayüzü ekranlarını API ile eşleme konusunda daha ayrıntılı örnekler ve otomatik yardım için aşağıdaki kaynaklara bakın:
- Sorgu Yemek Kitabı: Birçok yaygın Google Ads kullanıcı arayüzü ekranında bulunan verileri kopyalayan GAQL sorgularından oluşan bir koleksiyon.
- Google Ads API Raporlama Uzantısı: API kaynağı ve alan adlarını doğrudan Google Ads kullanıcı arayüzünde tanımlamanıza yardımcı olan bir Chrome uzantısıdır.
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şlemeleri özetlenmiştir.
| UI | GAQL |
|---|---|
| Sütunlar | GAQL sorgusunun SELECT yan tümcesindeki herhangi bir kaynak, segment alanı veya metrik. |
| Tarih Aralığı | Tarih aralıkları, segments.date üzerinde filtreleme yapan bir WHERE ifadesiyle 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'de kaynak alanları, segment alanları veya metrikler için SELECT ifadesini kullanmaya eşdeğerdir.
Daha fazla bilgi için İstatistik tablonuzdaki sütunlar hakkında başlıklı makaleyi inceleyin.
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 için filtreleme yaparak GAQL'de aynı kontrolü elde edebilirsiniz.
Filtreler
Kullanıcı arayüzündeki filtreler, GAQL'nin WHERE ifadesindeki bir veya daha fazla koşula eşdeğerdir.
Daha fazla bilgi için Performans verilerinizin görünümünü filtreleme başlıklı makaleyi inceleyin.
Segmentasyon
Daha ayrıntılı istatistikler için verileri segmentlere ayırın. Örneğin, Google Arama Ağı'na özgü gösterim sayısını Google Görüntülü Reklam Ağı'ndan ayrı olarak görmek istediğinizi varsayalım. Bu durumda, raporunuzu ağa göre segmentlere ayırın. Segment alanlarını SELECT ifadesine nasıl dahil edeceğinizi öğrenmek için Segmentasyon bölümüne bakın.
Sayfalara ayırma
Kullanıcı arayüzündeki raporlarınızda gezinmek için her veri tablosunun alt kısmında bulunan kontrolleri kullanabilirsiniz. Bu kontroller, sayfalar arasında geçiş yapmanıza ve tanımlı bir boyut grubundan görüntülenecek sonuç sayısını seçmenize olanak tanır.
Raporları alırken sonuçlar arasında gezinmek için next_page_token ile GoogleAdsService.Search kullanın. Tüm sonuç grubunu sayfalara ayrılmadan getirmek için GoogleAdsService.SearchStream kullanın.
Sonuçları sıralama
Kullanıcı arayüzünde, bir sütun seçerek sonuçları sıralayabilirsiniz.
GAQL'de, sorgu sonuçlarınızı sıralamak ve sınırlamak 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, çıktıyı doğrudan CSV gibi dosyalara biçimlendirmez. Bu nedenle, istemci uygulamanızın yanıtı biçimlendirmesi gerekir. İstemcide CSV biçimlendirmesinin nasıl uygulanacağını öğrenmek için CSV kod örneğine kampanya raporu bölümüne bakın.
Raporları planlama ve e-postayla gönderme
Kullanıcı arayüzünden rapor planlayıp e-postayla gönderebilirsiniz ancak bu özellikler API'de desteklenmez.
Kullanıcı arayüzü görünümlerini API kaynaklarıyla eşleme
Aşağıda, yaygın kullanıcı arayüzü görünümlerinin ve bunlarla eşleşen GAQL kaynak adlarının listesi verilmiştir.
| Kullanıcı arayüzü görüntülemeleri | GAQL kaynak adı (FROM ifadesinde 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 (Görünürlük rekabeti şablonu)* |
paid_organic_search_term_view |
| Açılış sayfası | landing_page_view |
| Genişletilmiş açılış sayfası | expanded_landing_page_view |
| İçerik > Yerleşimler | managed_placement_view |
| İçerik > Reklamların gösterildiği yerler | group_placement_view |
| İçerik > Reklamların gösterildiği yerler > Ayrıntıları görüntüle | detail_placement_view |
| Kitleler > Demografi > Yaş | age_range_view |
| Kitleler > Demografi > Cinsiyet | gender_view |
| Konumlar | location_view |
| İçerik > Konular | topic_view |
| Konumlar > Coğrafi rapor | geographic_view |
* Ücretli ve organik raporunu oluşturmak için bir Google Search Console hesabını müşteri düzeyinde Google Ads hesabınıza bağlamanız gerekir.
Önceki tablodaki bir örnek olarak, son 7 gün için toplu bir hesap raporu oluşturmak üzere aşağıdaki GAQL sorgusunu kullanabilirsiniz (metriklerin güne göre dökümünü almak istiyorsanız SELECT ifadesine segments.date ekleyin):
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ı ile API raporları karşılaştırılırken en sık görülen farklardan biri, kullanıcı arayüzünün kaldırılan öğeleri dolaylı olarak filtrelemesi, API'nin ise filtrelememesidir.
Varsayılan bir kullanıcı arayüzü görünümünü kopyalamak için kaldırılan satırları hariç tutmak üzere status alanını kullanan bir filtre ekleyin (veya ENABLED ve PAUSED varlıklarını açıkça dahil edin). Örneğin:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'