이제 Search Analytics API에서 시간별 데이터를 지원합니다

2025년 4월 9일 수요일

몇 개월 전 Google에서는 Search Console에서 최근 실적 데이터를 확인하기 위한 한층 개선된 방법을 발표한 바 있습니다. '24시간' 뷰에는 최근 24시간 동안의 데이터가 포함되며, 몇 시간 정도 지연된 후에 표시됩니다. 이 뷰에서 최근 기간 동안 우수한 실적을 거둔 페이지와 쿼리, 최근에 게시한 콘텐츠의 인기 상승 정도에 관한 정보를 확인할 수 있습니다.

오늘 Search Analytics API에 시간별 데이터 지원이 추가됩니다. 이 데이터에 더 쉽게 액세스할 수 있도록 해 달라는 요청이 있었습니다. 이에 따라 API에 제품 인터페이스에서보다 더 광범위한 범위의 시간별 데이터를 추가하고 있습니다. 제품에는 지난 24시간 동안의 시간별 데이터만 표시되지만 API는 시간별 분류와 함께 최대 10일 동안의 데이터를 반환합니다. 이를 통해 개발자는 최신 날짜의 시간별 데이터뿐만 아니라 최신 날짜를 지난주의 동일한 요일과 비교하는 솔루션을 만들 수 있으며, 이는 요일별 패턴을 분석할 때 유용할 수 있습니다.

Search Analytics API에서 시간별 데이터를 가져오는 방법

Search Analytics API에서 시간별 데이터를 사용할 수 있도록 API 요청 본문에 다음과 같은 두 가지 변경사항이 도입됩니다.

  • 응답을 시간별로 그룹화할 수 있는 HOUR라는 새 ApiDimension이 생성됩니다.
  • HOURLY_ALL이라는 새 dataState 값을 HOUR로 그룹화할 때 사용해야 합니다. 이는 시간당 데이터가 불완전할 수 있음을 나타냅니다.

다음 섹션에서는 참고를 위한 샘플 API 요청 및 샘플 응답을 제공합니다.

샘플 API 요청

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

샘플 API 응답

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

이 새로운 데이터가 최근에 게시된 콘텐츠를 더 효과적으로 모니터링하고 적시에 조치를 취하는 데 도움이 되기를 바랍니다. 새로운 뷰가 어떻게 도움이 되는지, 더 나은 뷰를 만들려면 어떤 점이 개선되어야 하는지 여러분의 의견을 보내주세요. 의견이나 궁금한 점이 있으면 LinkedIn에서 문의하거나 Google 검색 센터 커뮤니티를 확인해 보세요.

게시자: 탈리 프루스(소프트웨어 엔지니어), 다니엘 웨이스버그(Google 검색 애드보킷)