Bir günlük veri için günlük sorgu çalıştırarak performans verilerinizi hızlı bir şekilde ve kotanızı aşmadan sorgulayabilirsiniz.
Verilerinizde hangi bilgileri görmek istediğinizi seçmeniz gerekir: hangi arama türleri (web, görsel, video vb.)? ve hangi boyutlara (sayfa, sorgu, ülke veya cihaz) göre sonuçları sayfaya göre gruplandır hakkında daha fazla bilgi edinin. Sayfa ve/veya sorgu dizesi için sorgu yapılırken bazı veriler atlanabilir (nedenini buradan öğrenebilirsiniz).
Genel Bakış
- sorgudan birini kullanarak bir günlük veri için her gün bir sorgu çalıştırmanızı öneririz
stil özelliklerini ayarlama başlıklı makaleyi inceleyin. Bir günlük veriler için günlük sorgu çalıştırdığınızda
günlük kota. Veriler genellikle 2-3 gün sonra kullanılabilir hale gelir; son 10 gün için tarihe göre gruplandırılmış basit bir sorgu çalıştırarak en güncel verilerin neler olduğunu öğrenebilirsiniz. Sorgunuzu yazılı olarak:
- Sonuçların sayfaya mı yoksa mülke göre mi gruplandırılacağını seçin.
- Sorgunuzda daha kapsamlı sayımlar mı yoksa daha fazla boyut mu istediğinizi seçin. Not: Arama görünümü verileri (AMP, mavi bağlantı, zengin sonuç vb.) iki adımlı bir işlem kullanılarak sorgulanmalıdır.
- Aynı sorguyu yeniden çalıştırarak ve son sayfaya (0 satırlı bir yanıt) ulaşana kadar istekte
startRowdeğerini 25.000 artırarak sonuçlar arasında gezinin. - İsteğe bağlı olarak aynı sorguyu başka bir
typeparametresiyle çalıştırın.
Aşağıda, tek bir sorgu için sözde kod örneği verilmiştir. Bu işlemi, veri almak istediğiniz
her type değeri için günde bir kez çalıştırabilirsiniz.
int maxRows = 25000; // Current max response size int i = 0; do { response = Request(startDate = 3_days_ago, endDate = 3_days_ago, ... add dimensions, type ... rowLimit = maxRows, startRow = i * maxRows); i++; … // Do something with the response data. } while (response.rows.count() != 0); // Page through all result rows
Veri limitleri
API kullanım kotasına ek olarak, Her arama türü (web, resim vb. sıralı) başına günde maksimum 50 bin veri satırı gösterir tıklama sayısı).
Sorgu ayrıntıları
Sayfa veya mülk bazında gruplandırılmış verileri sorgulayabilirsiniz.
Sayfaya göre gruplandırılmış
Doğru sayımlar için sayfa ve sorgu boyutlarını aşağıdaki gibi çıkarmanız gerekir:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web", "aggregationType": "byPage"
startDate/endDate: Aynı tarihi seçerek bir günlük bir zaman aralığı belirleyin.dimensions: İsteğe bağlı olarakcountryve/veyadeviceekleyin.type: Ayrı bir sorguda hertypedeğerini istediğiniz gibi listeleyin.aggregationType:byPageolmalıdır.
Bazı verileri kaybetme pahasına sayfa ve/veya sorgu bilgileri dahil daha fazla ayrıntı için aşağıdaki gibi bir sorgu çalıştırın:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["page", "query", "country", "device"], "type": "web"
startDate/endDate: Aynı tarihi seçerek bir günlük bir zaman aralığı belirleyin.dimensions:pagedahil edilir. İsteğe bağlı olarak herhangi birquery,countryveyadevicekombinasyonunu ekleyin.type: Ayrı bir sorguda hertypedeğerini istediğiniz gibi listeleyin.
Mülke göre gruplandırılmış
Doğru sayımlar için sayfa ve sorgu boyutlarını aşağıdaki gibi çıkarmanız gerekir:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web"
startDate/endDate: Aynı tarihi seçerek bir günlük bir zaman aralığı belirleyin.dimensions: İsteğe bağlı olarakcountryve/veyadeviceekleyin.type: İsteğe bağlı olarak üzerinde numaralandırın hertypedeğerini ayrı bir sorguda istenen şekilde sunun.
Sorgu, ülke ve/veya cihaz bilgileri dahil daha ayrıntılı bilgiler için, verilerin bir kısmını kaybetme pahasına şu şekilde bir sorgu çalıştırın:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["query", "country", "device"], "type": "web"
startDate/endDate: Aynı tarihi seçerek bir günlük bir zaman aralığı belirleyin.dimensions: İsteğe bağlı olarakquery,countryveyadevice'in herhangi bir kombinasyonunu ekleyin.type: üzerinde numaralandırma hertypedeğerini ayrı bir sorguda istenen şekilde sunun.
Sonuçları sayfaya veya mülke göre gruplandırma
Sonuçlar mülke göre değil sayfaya göre gruplanırken gösterim, tıklama, konum ve tıklama oranı farklı şekilde hesaplanır. Daha fazla bilgi edinin.
Why do I lose data when asking for more detail?
Sayfaya ve/veya sorguya göre gruplandırdığınızda sistemimiz, makul miktarda bilgi işlem kaynağı kullanarak sonuçları makul bir sürede hesaplayabilmek için bazı verileri çıkarabilir.
Arama görünümü verileri alınıyor
Arama görünümü, diğer boyutlarla birlikte sütun olarak kullanılamaz. Bu nedenle, sitenizin arama görünümü bilgilerini görmek istiyorsanız aşağıdaki işlemi uygulamanız gerekir:
- Tek boyut olarak
searchAppearance'ü belirtirseniz tüm veriler, başka boyut olmadan arama görünümü türüne göre gruplandırılır. - İsteğe bağlı olarak, 1. adımda listelenen arama görünümü türlerinden birine göre filtre uygulayıp istediğiniz boyutları sorguya (sayfa, ülke, sorgu vb.) ekleyerek ikinci bir sorgu çalıştırın.
Birden çok arama görünümü türüyle ilgili verileri almak için 1. adım listelenen her arama görünümü türü için ikinci adımı bir kez çalıştırmanız gerekir.
İlk sorgu:
Sitenizdeki arama görünümü türlerinin listesini alın.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "searchAppearance" ] }
Sonuçlar:
Sitenizde INSTANT_APP, AMP_BLUE_LINK vb. türleri var.
"rows": [
{
"keys": [
"INSTANT_APP"
],
"clicks": 443024.0,
"impressions": 4109826.0,
"ctr": 0.10779629113251997,
"position": 1.088168452873674
},
{
"keys": [
"AMP_BLUE_LINK"
],
"clicks": 429887.0,
"impressions": 1.7090884E7,
"ctr": 0.025152999692701676,
"position": 7.313451603790653
},...İkinci sorgu:
1. adımda bulunan arama görünümü türlerinden birine ve istediğiniz boyutlara (sayfa, cihaz vb.) göre filtre uygulayın. Burada AMP_BLUE_LINK değerine göre filtreleme yapıyoruz.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "device" // and/or page, country, ... ], "dimensionFilterGroups": [ { "filters": [ { "dimension": "searchAppearance", "operator": "equals", "expression": "AMP_BLUE_LINK" } ] } ] }
Sonuçlar:
AMP_BLUE_LINK metriğinin cihaz türlerine göre dökümü.
"rows": [
{
"keys": [
"MOBILE"
],
"clicks": 429887.0,
"impressions": 1.7090783E7,
"ctr": 0.025153148337323107,
"position": 7.31339517914422
},
{
"keys": [
"DESKTOP"
],
"clicks": 0.0,
"impressions": 66.0,
"ctr": 0.0,
"position": 12.257575757575758
},
...