Performans verileriniz alınıyor

Bir günlük veriler için günlük sorgu çalıştırarak performans verilerinizi kotanızı aşmadan hızlıca sorgulayabilirsiniz.

Verilerinizde yer almasını istediğiniz bilgileri seçmeniz gerekir: arama türleri (web, resim, video vb.) ve boyutların (sayfa, sorgu, ülke veya cihaz) yanı sıra sonuçları sayfaya ya da mülke göre gruplandırıp gruplandırmayacağınız. Sayfa ve/veya sorgu dizesi sorgulanırken bazı veriler çıkarılabilir (nedenini buradan öğrenebilirsiniz).

Genel bakış

  1. Aşağıda açıklanan sorgu stillerinden birini kullanarak bir günlük veriler için her gün sorgu çalıştırmanızı öneririz. Bir günlük veriler için günlük sorgu çalıştırmak günlük kotanızı aşmamalıdır. Veriler genellikle 2-3 gün sonra kullanılabilir olur. En son hangi verilerin kullanılabilir olduğunu, son 10 gün içinde tarihe göre gruplandırılmış basit bir sorgu çalıştırarak öğrenebilirsiniz. Sorgunuzu yazarken:
    • Sonuçların sayfaya mı yoksa mülke göre mi gruplanacağını seçin.
    • Sorgunuzda daha çok tam sayı 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 son sayfaya (0 satır içeren bir yanıt) ulaşıncaya kadar istekteki startRow değerini 25.000 artırarak sonuçları sayfa genelinde görüntüleyin.
  3. İsterseniz 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

Arama API'si yöntemi, API kullanım kotasının yanı sıra her arama türü (web, resim vb. tıklamalara göre sıralı şekilde) için günde en fazla 50 bin satırlık veri gösterir.

Sorgu ayrıntıları

Verileri sayfaya veya mülke göre gruplandırılmış olarak sorgulayabilirsiniz.

Sayfaya göre gruplandırıldı

Doğru sayılar için sayfa ve sorgu boyutlarını şu şekilde çı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 aralığı seçin.
  • dimensions: İsteğe bağlı olarak country ve/veya device ekleyin.
  • type: Ayrı bir sorguda her type değerini istediğiniz gibi numaralandırın.
  • aggregationType: byPage olmalıdır.

Bazı verileri kaybetme pahasına sayfa ve/veya sorgu bilgileri de dahil olmak üzere daha ayrıntılı bilgi edinmek 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 aralığı seçin.
  • dimensions: page dahil. İsteğe bağlı olarak query, country veya device herhangi bir kombinasyonunu ekleyin.
  • type: Ayrı bir sorguda her type değerini istediğiniz gibi numaralandırın.

Mülke göre gruplandırılmış

Doğru sayılar için sayfa ve sorgu boyutlarını şu şekilde çı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 aralığı seçin.
  • dimensions: İsteğe bağlı olarak country ve/veya device ekleyin.
  • type: İsteğe bağlı olarak, her type değerini ayrı bir sorguda istediğiniz şekilde numaralandırın.

Sorgu, ülke ve/veya cihaz bilgileri de dahil olmak üzere daha ayrıntılı bilgi edinmek için bazı verileri kaybetme pahasına şu gibi 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 aralığı seçin.
  • dimensions: İsteğe bağlı olarak query, country veya device herhangi bir kombinasyonunu ekleyin.
  • type: Ayrı bir sorguda her type değerini istediğiniz gibi numaralandırın.

Sonuçları sayfaya veya mülke göre gruplandırma

Sonuçlar; mülke göre değil sayfaya göre gruplandırılırken gösterim sayısı, tıklama sayısı, konum ve tıklama oranı farklı şekilde hesaplanır. Daha fazla bilgi edinin.

Daha fazla ayrıntı isterken neden veri kaybediyorum?

Sayfaya ve/veya sorguya göre gruplandırma yaptığınızda sistemimiz, sonuçları makul bir miktarda hesaplama kaynağı kullanarak makul bir zamanda hesaplayabilmek için bazı verileri bırakabilir.

Arama görünümü verileri alınıyor

Arama görünümü, diğer boyutlarla birlikte bir sütun olarak kullanılamaz. Bu nedenle, sitenizin arama görünümü bilgilerini görmek istiyorsanız şu süreci izlemeniz gerekir:

  1. Tek boyut olarak searchAppearance değerini belirtin. Bu boyut, tüm verileri başka bir boyut olmadan arama görünümü türüne göre gruplandırır.
  2. İsteğe bağlı olarak, 1. adımda listelenen arama görünümü türlerinden birine göre filtreleyerek ikinci bir sorgu çalıştırın ve sorguya istediğiniz boyutları (sayfa, ülke, sorgu vb.) ekleyin.

Birden çok arama görünümü türüyle ilgili verileri almak için, 1. adımda listelenen arama görünümü türü başına ikinci adımı çalıştırmanız gerekir.

İlk sorgu:

Sitenizde arama görünümü türlerinin listesini görün.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

Sonuçlar:

Sitenizin türü INSTANT_APP, AMP_BLUE_LINK vb.

 "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 bulduğunuz arama görünümü türlerinden biriyle ve istediğiniz boyutlarla (sayfa, cihaz vb.) göre filtreleyin. Burada AMP_BLUE_LINK filtresini uyguluyoruz.

{
  "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:

Cihaz türlerine göre AMP_BLUE_LINK 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
  },
...