Bu kılavuzda, Google Ads kullanıcı arayüzündeki raporlara ilişkin kavramlar ve adlandırma kuralları eşlenir. Google Ads Sorgu Dili (GAQL) ve Display & Video 360'ı kullanarak oluşturabileceğiniz Google Ads API'si.
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 eşlemeleri Google Ads Sorgu Dili (GAQL) ile aynıdır.
| 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ı WHERE anahtar kelimeleriyle eşlenir
ifadesi için segments.date filtrelenir. |
| Filtreler | WHERE yan tümcesinde bir veya daha fazla koşul. |
| Segment alanları | Segment alanlarını ekleyerek segmentasyon uygulayın kullanabilirsiniz. |
| Sayfaları numaralandırma | Sayfalama, sorguyu birden çok sayfaya |
Sütunlar
Kullanıcı arayüzündeki sütunlar Kaynak" ile eşdeğerdir. alanları, Segment alanları ve GAQL'deki metrikler.
Filtreleme
Tarih aralıkları
Google Ads kullanıcı arayüzünde hesap istatistiklerini gösteren bir tablo ve bu istatistiklerin tarih aralığını kontrol edebilir.
GAQL'de, GAQL'de aynı kontrole sahip olmak için
GAQL'nin WHERE yan tümcesinde segments.date
emin olun.
Filtreler
Kullanıcı arayüzündeki filtreler, WHERE içindeki bir veya daha fazla koşula eşdeğerdir madde'si olarak nitelendirilir.
Segmentasyon
Daha ayrıntılı istatistikler için verileri segmentlere ayırabilirsiniz. Örneğin, spesifik gösterimlerin sayısını görmek isteyebilirsiniz. Google Arama Ağı'ndan ayrı olarak ele alacağız. Böyle durumlarda raporunuzu ağa göre segmentlere ayırırsınız. Görüntüleyin Segment alanlarının nasıl ekleneceğinde segmentasyon kullanabilirsiniz.
Sayfalara ayırma
sayfaları değiştirmenize olanak tanıyan her bir veri tablosunun alt kısmında sonuç belirli bir boyut kümesinden görüntülenebilir.
GoogleAdsService.Search -
next_page_token. Sonuç kümesinin tamamını getirmek için
sayfaları sayfalandırmadan
GoogleAdsService.SearchStream.
Sipariş sonuçları
Kullanıcı arayüzünde, bir sütun seçerek sonuçları sıralayabilirsiniz.
GAQL'de, ORDER BY madde ve LIMIT ifade kullanabilirsiniz.
İndirme biçimleri
Kullanıcı arayüzünde, raporlar CSV, TSV veya XML.
API, çıkışında farklı biçimleri doğrudan desteklemez. Bu nedenle, bazı son işleme işlemleri yapılması gerekiyor. Şunlara göz atın: CSV biçimlendirmesinin nasıl uygulanacağını gösteren kod örneği: gerekir.
Raporları planlama ve e-postayla gönderme
Kullanıcı arayüzünden rapor planlama ve e-postayla gönderme özelliği kullanılabilir, ancak API.
Önceden Tanımlanmış Raporlar
Google Ads kullanıcı arayüzünde, önceden tanımlanmış raporların listesini oluşturabilirsiniz.
Aşağıda, önceden tanımlanmış temel raporların ve bunlarla eşleşen GAQL Kaynağının listesi verilmiştir. Ad.
| 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, aşağıdaki GAQL'yi kullanarak Hesap raporu:
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 kullanıcı arayüzü, kaldırılmış varlıkları dolaylı olarak filtrelerken API bunları filtrelemez.
Varsayılan bir kullanıcı arayüzü görünümünü kopyalamak için genellikle bir filtre eklemeniz gerekir.
kaldırılan satırları hariç tutmak için bir status alanı kullanın. Örneğin:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"