[운영] GA4 Data API로 주간 서비스 운영 보고서 자동 생성하기

한 줄 요약: 매일/매주 GA4 콘솔에 수동으로 로그인하여 데이터를 추출하는 번거로움을 없애기 위해, AWS Lambda 및 @google-analytics/data SDK를 활용하여 주요 전환 지표 및 트래픽 유입 경로를 자동 조회하고 S3에 지표 보고서 JSON/HTML로 저장하는 파이프라인을 연동했습니다.

이 과정을 자동화하여 매일 아침 전날 데이터를 자동 수집하고, 주간 전환 리포트를 한눈에 파악할 수 있는 자동화 보고서 파이프라인을 만들고자 했습니다.

infra/report-api/index.mjs에서 GA4 Data API를 통해 자동으로 조회하는 5대 지표군:

4. 핵심 커스텀 이벤트: analysis_start, analysis_complete, share_click, coupang_copy

5. 인기 페이지 Top 10: pagePath별 세션 수 및 체류 시간

구글 서비스 계정(Service Account) 전용 IAM 인증 키를 AWS Secrets Manager에 보관하고 사용하므로, 데이터 탈취 위험 없이 100% 실시간 GA4 서버 데이터와 정확히 일치합니다.

`infra/report-api/index.mjs` (GA4 Data API 호출 및 보고서 산출 Lambda)

import { BetaAnalyticsDataClient } from "@google-analytics/data";
import { GetSecretValueCommand, SecretsManagerClient } from "@aws-sdk/client-secrets-manager";
import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";

const secretsClient = new SecretsManagerClient({});
const s3Client = new S3Client({});

// 1. Secrets Manager에서 GA4 비공개 인증서 동적 인출
async function getCredentials() {
  const command = new GetSecretValueCommand({ SecretId: "goodfruit/ga4-credentials" });
  const response = await secretsClient.send(command);
  return JSON.parse(response.SecretString);
}

// 2. GA4 Data API 리포트 실행
export async function handler(event) {
  const creds = await getCredentials();
  const analyticsClient = new BetaAnalyticsDataClient({
    credentials: {
      client_email: creds.clientEmail,
      private_key: creds.privateKey.replace(/\\n/g, "\n"),
    },
  });

  const property = `properties/${creds.propertyId}`;

  // 전날(yesterday) 메트릭 자동 조회
  const [overviewRes] = await analyticsClient.runReport({
    property,
    dateRanges: [{ startDate: "yesterday", endDate: "yesterday" }],
    metrics: [
      { name: "sessions" },
      { name: "activeUsers" },
      { name: "screenPageViews" },
    ],
  });

  const reportData = {
    date: new Date().toISOString().slice(0, 10),
    sessions: overviewRes.rows[0]?.metricValues[0]?.value || 0,
    activeUsers: overviewRes.rows[0]?.metricValues[1]?.value || 0,
    pageViews: overviewRes.rows[0]?.metricValues[2]?.value || 0,
  };

  // S3 버킷에 일별 지표 JSON 저장
  await s3Client.send(new PutObjectCommand({
    Bucket: "fruit.nxnl.app",
    Key: `reports/${reportData.date}.json`,
    Body: JSON.stringify(reportData, null, 2),
    ContentType: "application/json",
  }));

  return { statusCode: 200, body: JSON.stringify(reportData) };
}

GA4 Data API와 AWS Lambda를 결합하면 매번 애널리틱스 화면을 열어보지 않고도 서비스의 핵심 성장 수치를 100% 자동화하여 수집하고 정량적 의사결정을 내릴 수 있습니다.

실제 적용 서비스