Performans verileriniz alınıyor

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ış

  1. 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.
  2. Aynı sorguyu yeniden çalıştırarak ve son sayfaya (0 satırlı bir yanıt) ulaşana kadar istekte startRow değerini 25.000 artırarak sonuçlar arasında gezinin.
  3. İsteğe bağlı olarak aynı sorguyu başka bir type parametresiyle ç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ı olarak country ve/veya device ekleyin.
  • type: Ayrı bir sorguda her type değerini istediğiniz gibi listeleyin.
  • aggregationType: byPage olmalı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: page dahil edilir. İsteğe bağlı olarak herhangi bir query, country veya device kombinasyonunu ekleyin.
  • type: Ayrı bir sorguda her type değ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ı olarak country ve/veya device ekleyin.
  • type: İsteğe bağlı olarak üzerinde numaralandırın her type değ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ı olarak query, country veya device'in herhangi bir kombinasyonunu ekleyin.
  • type: üzerinde numaralandırma her type değ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:

  1. 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.
  2. İ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
  },
...