개요

---

게시글이 중심인 사이트를 보면, 대부분 조회수에 기반한 인기 게시글을 보여주는 기능을 제공해준다. 각 게시글마다 조회수를 저장하고, 이를 통해 가장 많은 조회수 혹은 이에 기반한 특정 조건을 만족하는 게시글을 보여주는 방식이다.

하지만, 내 블로그. 조회수 저장같은 건 없다. Serverless 방식이기 때문. GitHub를 통해 정적 호스팅만을 수행할 뿐, 서버에 그 이상의 어떤 연산도 기대할 수 없는 구조다. 때문에 능동적인 방문자수 계산은 불가능한 상황이다.

이 때문에 언제나 고민만 하고 있었는데, 어느날 평소처럼 Google Analytics 페이지를 보면서 방문자수 추이를 살펴보다 "생각해보니 내가 필요한 데이터가 이미 여기 있는데?"란 생각이 들었다. 아마 Google Analytics 정도 되는 서비스라면 API도 있을거라 판단. 이를 잘만 활용한다면 내가 원하는 인기 게시글 목록을 구현하기에 충분할 것이다.

인기 게시글 구현하기

---

GA 데이터를 통해 인기 게시글을 구현해보자.

1. GA 호출용 Google OAuth 인증키 발급하기

---

우리가 호출하려는 데이터는 사용자 기반 데이터다. 즉, 단순히 URL을 호출한다고 아무렇게나 주는 데이터가 아니란 뜻이다. 따라서 API를 호출하기 위해 인증 객체가 필요할 것이다.

Google은 OAuth 2.0 기반의 인증 체계를 구축하고 있으므로, 이를 위해 인증키를 발급받아야 한다. Google 인증키는 🔗 Google Cloud Platform에서 발급받을 수 있다.

1-1 프로젝트 생성하기

---

만약, 아예 처음이라 아무런 절차도 진행하지 않았다면 [새 프로젝트]를 하나 생성하자. 프로젝트는 GCP의 작업 단위다.

1-2 GA Data API 라이브러리 활성화하기

---

프로젝트 생성이 완료됐다면, 이제 해당 프로젝트에서 필요한 작업들을 진행할 수 있다. GA를 바로 사용할 수 있는 건 아니고, 생성한 프로젝트에서 GA 라이브러리를 활성화해야한다.

상단의 [+ API 및 서비스 사용 설정]을 클릭하자

[Google Analytics Data API]를 활성화한다. 해당 행을 클릭해서 사용하면 된다.

1-3 OAuth 동의 화면 설정하기

---

OAuth 키를 발급받기 위해선 OAuth 동의 화면을 먼저 설정해야한다. [OAuth 동의 화면] 메뉴에서 설정할 수 있다.

유저 타입은 [내부]로 설정하자. 어디 외부에서 사용할 서비스는 아니기 때문이다.

이후 필요한 정보를 기입한다. Google에 제출해서 심사하고 그럴 필요는 없으므로 그냥 적당히 적으면 된다.

단, 승인된 도메인은 블로그의 루트 도메인을 입력한다. 예를 들어, 현재 이 블로그의 도메인은 blog.itcode.dev이므로, 이 도메인의 루트 도메인인 itcode.dev를 입력하면 된다. https://와 같은 프로토콜은 생략하고 오로지 루트 도메인만 입력한다.

다음으로 OAuth에서 활용할 데이터의 범위를 선택하는데, 필요한 범위는 아래와 같다.

• /auth/userinfo.email: 계정 이메일 주소 확인
• /auth/userinfo.profile: 개인정보
• /auth/analytics.readonly: GA 데이터 (읽기 전용)

GA 데이터를 가져오기만 하면 되므로, readonly로 지정했다.

1-4 테스트 사용자 설정하기

---

테스트 사용자로 내 계정을 추가한다. 해당 리스트에 등록된 계정만 API키 사용이 가능하다.

모든 절차가 완료됐다면, OAuth 클라이언트 ID를 생성할 수 있다.

1-5 OAuth 클라이언트 ID 생성하기

---

OAuth 서비스를 사용하기 위한 클라이언트 ID를 생성한다.

필요한 정보를 입력한다. [승인된 리디렉션 URI]는 블로그 URL을 입력한다. 예시로 이 블로그의 경우 https://blog.itcode.dev와 같이 입력한다.

OAuth 서비스 활용 시 요청 URL을 확인하므로, 등록된 URL에서 온 요청이 아닐 경우 응답을 거부하므로 주의할 것.

키가 생성되면 클라이언트 ID와 클라이언트 보안 비밀키를 확인할 수 있으며, 이로써 OAuth 클라이언트 ID 발급이 끝난다.

1-6 프로덕션 활성화하기

---

기본적으로 프로젝트를 생성하면 테스트 모드로 생성된다. 테스트 모드는 별다른 심사를 거치지 않지만, 대신 API키를 사용하는 데 있어 여러 부분에 제약이 생긴다. 이를테면 사전에 등록된 테스트 계정만 API키를 사용할 수 있는 식.

문제는 테스트 모드일 경우, 발급받는 Refresh Token의 만료시간이 일주일로 제한된다. 이는 🔗 해당 링크에서 확인할 수 있다.

A Google Cloud Platform project with an OAuth consent screen configured for an external user type and a publishing status of "Testing" is issued a refresh token expiring in 7 days.

Google은 위와 같이 테스트 모드일 경우, Refresh Token의 만료시간이 7일로 제한된다고 안내하고 있다.

그 말인 즉슨, 테스트 모드의 Refresh Token을 사용할 경우 일주일마다 해당 토큰을 교체해줘야 한다는 문제점이 생긴다. 필자는 이 차이를 몰라서 한 동안 토큰이 만료되어 인기 게시글을 보여주지 못 했다.

[OAuth 동의 화면] 메뉴에서 [앱 개시] 버튼을 클릭해 게시 상태를 변경한다.

정상적인 사용을 위해선 앱 심사를 거쳐야한다. 하지만 우리가 사용하는 Scope인 /auth/analytics.readonly는 Google의 Scope 중 민감한 범위에 해당하므로, API의 활용 시연을 YouTube에 올려야한다...

프로덕션 프로젝트가 심사를 아직 받지 않았을 경우, 위와 같이 경고 페이지가 뜨며, 직접 링크를 눌러 넘어갈 수 있다.

어차피 불특정 다수에게 공개할 것도 아니고, 자신이 직접 Refresh Token을 딱 한 번 발급받아 사용할 예정이므로 심사없이 사용해도 큰 문제는 없다.

2. 클라이언트 ID를 통해 Refresh Token 발급하기

---

OAuth의 인증 객체는 보통 Access Token과 Refresh Token으로 나뉜다.

• Access Token - 실질적인 인증 정보가 담긴 토큰. 만료시간이 짧다.
• Refresh Token - Access Token을 재발급받기 위한 토큰. 만료시간이 길거나, 없다.

정상적이라면 클라이언트 ID를 통해 Access Token을 발급받아 사용할 것이다. 하지만, 해당 키는 내 블로그에서만 하드코딩하여 사용할 예정이므로, 그냥 Refresh Token을 미리 발급받아 사용하는 것이 편하다.

생성한 클라이언트 ID를 통해 Refresh Token을 발급받아보자.

🔗 Google OAuth Playground는 Google API를 테스트할 수 있는 사이트다.

직접 로그인하거나, 기존에 보유하고 있는 클라이언트 ID를 활용해서 API를 테스트할 수 있다. 이 사이트에서 우리가 발급받은 클라이언트 ID를 통해 Refresh Token을 발급받을 수 있을 것이다.

상단 우측 톱니바퀴 버튼을 통해 보유한 클라이언트 ID를 임의로 지정할 수 있다.

[Use your own OAuth credentials]를 체크하면 입력 폼이 나온다. 여기에 이전 절차에서 발급받은 클라이언트 ID, 비밀키를 입력한다.

이후 우측 목록에서 [Google Analytics API v3]를 클릭하고, 하위 목록 중 아래의 URL을 선택한다.

• https://www.googleapis.com/auth/analytics.readonly

이후 [Authorize APIs]를 클릭하면 Authorization code를 발급받을 수 있다. 이 과정에서 Google 로그인을 수행하는데, 테스트 서비스이므로, 안전하지 않은 환경이라는 경고가 뜬다. [계속] 버튼을 클릭하면 사용이 가능하다.

URI가 허용되지 않았거나, 테스트 대상 계정으로 로그인하지 않았을 경우 관련 오류가 뜨므로 주의할 것.

3. Refresh Token으로 Access Token 발급받기

---

이제 Refresh Token을 발급받았으니, 실제 인증 정보가 담겨있는 Access Token을 발급받을 수 있다.

TXT
1
2
3
4
5
POST https://oauth2.googleapis.com/token?
grant_type=refresh_token
&client_id={:client_id}
&client_secret={:client_secret}
&refresh_token={:refresh_token}

일반적인 인증 API에 grant_type과 refresh_token이 추가된 것을 확인할 수 있다. 이를 통해 별도의 로그인 없이도 API를 요청할 수 있다.

블로그 게시물 중 OAuth에 대해 다룬 글인 🔗 [OAuth2.0] ScribeJAVA로 OAuth2.0 인증서버 구축하기 - 5. Google OAuth 서비스 신청 및 모듈 구현하기에서 API에 대한 자세한 내용을 참고할 수 있다.

JSON
1
2
3
4
5
6
{
    "access_token": "1/fFAGRNJru1FTz70BzhT3Zg",
    "expires_in": 3920,
    "scope": "https://www.googleapis.com/auth/drive.metadata.readonly",
    "token_type": "Bearer"
}

응답은 위와 같은 형식으로 제공된다. 이 중 우리가 필요한 것은 당연히 access_token이다.

4. Google Analytics 인기 조회수 데이터 호출하기

---

Access Token이 준비됐으니, 이제 Google Analytics 데이터를 호출해보자. 우리가 필요한 데이터는 게시글 별 조회수 데이터다. 이를 호출하는 API는 아래와 같다.

TXT
1
2
POST https://content-analyticsdata.googleapis.com/v1beta/properties/{:project_id}:runReport?alt=json
Authorization: {:access_token}

JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
	"dateRanges": [
		{
			"endDate": "today",
			"startDate": "30daysAgo"
		}
	],
	"dimensionFilter": {
		"filter": {
			"fieldName": "pagePath",
			"stringFilter": {
				"matchType": "BEGINS_WITH",
				"value": "/posts/2"
			}
		}
	},
	"dimensions": [
		{ "name": "pagePath" }
	],
	"limit": "10",
	"metrics": [
		{ "name": "active28DayUsers" }
	]
}

• dateRanges: 데이터의 날짜 구간
• dimensionFilter: 데이터의 필터링. 필터에 해당하는 데이터만 호출이 가능하다.
• dimensions: 데이터의 요소. 여기서는 pagePath라는 페이지의 URL 데이터를 호출한다.
• limit: 데이터의 갯수
• metricAggregations: metric 집계 방식. 여기서는 TOTAL이라는 metric의 전체값을 추가로 호출한다.
• metrics: 보고서의 측정값 배열. 여기서는 active28DayUsers라는 28일 동안의 고유 활성 유저 수를 호출한다. 최대 10개의 metric을 지원한다.

위와 같이 원하는 요청값을 지정하여 데이터 쿼리를 수행할 수 있다.

위 요청을 정리하면 아래와 같다.

• 오늘 부터 30일 이전(30daysAgo) 사이의 데이터 기준
• 페이지 경로가 /posts/2로 시작되는 데이터
  • 이 블로그의 게시글 URL은 /posts/2023/10/05/xxxx 형식으로, 블로그 게시글만을 필터링하기 위함
• 데이터의 요소로 페이지 경로 추가
• 데이터 제한은 10개
• 보고서 측정값으로 28일 간의 고유 활성 유저 수를 포함

5. Google Analytics 데이터 활용

---

요청이 정상적으로 날아갔다면, 아래와 같은 형태의 응답을 받을 수 있다.

JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{
  "dimensionHeaders": [
    {
      "name": "pagePath"
    }
  ],
  "metricHeaders": [
    {
      "name": "active28DayUsers",
      "type": "TYPE_INTEGER"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "/posts/2021/08/19/lets-encrypt"
        }
      ],
      "metricValues": [
        {
          "value": "790"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "/posts/2021/05/22/tomcat-encoding-euckr"
        }
      ],
      "metricValues": [
        {
          "value": "767"
        }
      ]
    },
    // ... rows
  ],
  "totals": [
    {
      "dimensionValues": [
        {
          "value": "RESERVED_TOTAL"
        }
      ],
      "metricValues": [
        {
          "value": "9701"
        }
      ]
    }
  ],
  "rowCount": 149,
  "metadata": {
    "currencyCode": "KRW",
    "timeZone": "Asia/Seoul"
  },
  "kind": "analyticsData#runReport"
}

메타 정보와 함께 요청한 데이터가 오는데, rows를 보면 된다. 10개를 요청했으므로, row에는 최대 10개의 데이터가 담겨온다.

metricValues를 통해 각 페이지의 조회수를 얻을 수 있다. 이를 적절히 활용하면 블로그의 인기 게시글을 표현해줄 수 있을 것이다.

5-1. GA4 Query Explorer로 간편하게 API 사용해보기

---

🔗 GA4 Query Explorer를 활용하면 쿼리를 쉽게 구성할 수 있다.

위와 같은 방식으로 요청을 설계할 수 있다. select 컴포넌트를 기반으로 자동완성이 되므로, 원하는 값을 쉽게 찾을 수 있음은 물론, 얘가 대충 뭘 하겠구나..라는 감이 온다.

하단에서 선택한 요청의 JSON 구문을 보여준다. 이를 토대로 API 요청에 사용할 수 있다.

응답 결과 또한 한 눈에 확인할 수 있다.

여담

---

인기 게시글을 서버 없이 어떻게 만드는 게 좋을까 궁리하다가 발견한 방법. 사실 DB에 조회수 저장해놓는 편이 깔끔하다.

작년에 쓰다가 알 수 없는 이유로 중단했던 게시글. 이후 블로그 운영이 뜸해지며, 파일 자체를 지웠었다.

우연한 계기로 관련 내용이 필요한데 마침 생각나서 커밋 기록 뒤져서 찾았다. 새삼 Git의 위대함을 느낀다.

근데 필요한 건 둘 째치고, 글이 거의 80% 완성되어 있었는데, 왜 쓰다 말았는지 모르겠다.