Search Analytics API artık saatlik verileri destekliyor

9 Nisan 2025, Çarşamba

Birkaç ay önce, Search Console'da son performans verilerini görüntüleyebileceğiniz daha gelişmiş bir yöntemin duyurusunu yapmıştık. "24 saatlik" görünüm, son 24 saate ait verileri içerir ve bu veriler yalnızca birkaç saatlik gecikmeyle gösterilir. Bu görünüm, sayfaların ve sorguların ilgili zaman dilimindeki performansını ve yakın zamanda yayınladığınız içeriğin durumu hakkında bilgi edinmenize yardımcı olabilir.

Bugün, Search Analytics API'ye saatlik veri desteği ekliyoruz. Ekosistemin bu verilere daha kolay erişme taleplerini dikkate aldık. Bu nedenle, ürün arayüzüne kıyasla daha geniş kapsamlı saatlik verileri API'ye ekliyoruz: Ürün yalnızca son 24 saate ait saatlik verileri gösterirken API, son 10 güne kadar olan verileri saatlik dökümle birlikte döndürecek. Bu sayede geliştiriciler hem son güne ait saatlik verileri gösteren hem de son günü, önceki haftanın aynı günüyle karşılaştırabilecek çözümler üretebilir. Bu da haftanın günleriyle ilgili davranışları analiz ederken faydalı olabilir.

Search Analytics API'den saatlik verileri alma

Search Analytics API'de saatlik verileri kullanabilmek için API istek içeriğinde iki değişiklik yapıyoruz:

  • Yanıtı saate göre gruplandırmanız için HOUR adlı yeni ApiDimension.
  • HOUR bazında gruplandırma yaparken kullanılması gereken HOURLY_ALL adlı yeni dataState değeri. Bu, saatlik verilerin kısmi veriler olabileceğini gösterir.

Aşağıdaki bölümde, referans olarak bir örnek API isteği ve örnek yanıt verilmiştir.

Örnek API isteği

{
  "startDate": "2025-04-07",
  "endDate": "2025-04-07",
  "dataState": "HOURLY_ALL",
  "dimensions": [
    "HOUR"
  ]
}

Örnek API yanıtı

{
  "rows": [
    {
      "keys": [
        "2025-04-07T00:00:00-07:00"
      ],
      "clicks": 17610,
      "impressions": 1571473,
      "ctr": 0.011206046810858348,
      "position": 10.073871456906991
    },
    {
      "keys": [
        "2025-04-07T01:00:00-07:00"
      ],
      "clicks": 18289,
      "impressions": 1662252,
      "ctr": 0.011002543537321658,
      "position": 9.5440029550272758
    },
    {
      "keys": [
        "2025-04-07T02:00:00-07:00"
      ],
      "clicks": 18548,
      "impressions": 1652038,
      "ctr": 0.011227344649457216,
      "position": 9.81503633693656
    },
    {
      "keys": [
        "2025-04-07T03:00:00-07:00"
      ],
      "clicks": 18931,
      "impressions": 1592716,
      "ctr": 0.01188598595104212,
      "position": 9.4956935197486558
    },
    {
      "keys": [
        "2025-04-07T04:00:00-07:00"
      ],
      "clicks": 20519,
      "impressions": 1595636,
      "ctr": 0.012859449147549943,
      "position": 9.4670100198290843
    },
    …
  ],
  "responseAggregationType": "byProperty"
}

Bu yeni verilerin, yakın zamanda yayınlanan içeriğinizi daha etkili bir şekilde izlemenizi sağlayarak zamanında işlem yapmanıza yardımcı olacağını umuyoruz. Yeni görünüm hakkında ne düşündüğünüzü ve nasıl daha fazla iyileştirilebileceğiyle ilgili önerilerinizi öğrenmekten mutluluk duyarız. Geri bildirim, soru veya yorumlarınız varsa bizi LinkedIn'de bulabilir ya da Google Arama Merkezi Topluluğu'nda yayın paylaşabilirsiniz.

Yayınlayanlar: Tali Pruss, Software Engineer ve Daniel Waisberg, Search Advocate