Google Analytics Data API 설정하기 - 프로그래밍으로 GA 데이터 조회

{
  "type": "service_account",
  "project_id": "blog-analytics-123456",
  "private_key_id": "abc123...",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...",
  "client_email": "blog-analytics-reader@blog-analytics-123456.iam.gserviceaccount.com",
  "client_id": "123456789...",
  ...
}

npm install @google-analytics/data

const { BetaAnalyticsDataClient } = require('@google-analytics/data');

const analyticsDataClient = new BetaAnalyticsDataClient({
  keyFilename: './your-service-account-key.json',
});

const propertyId = 'YOUR_PROPERTY_ID'; // 6단계에서 확인한 ID

async function runReport() {
  try {
    const [response] = await analyticsDataClient.runReport({
      property: `properties/${propertyId}`,
      dateRanges: [
        {
          startDate: '7daysAgo',
          endDate: 'today',
        },
      ],
      dimensions: [
        {
          name: 'pagePath',
        },
      ],
      metrics: [
        {
          name: 'screenPageViews',
        },
      ],
      limit: 10,
    });

    console.log('지난 7일간 페이지뷰 Top 10:');
    console.log('');
    response.rows.forEach((row) => {
      const pagePath = row.dimensionValues[0].value;
      const pageViews = row.metricValues[0].value;
      console.log(`${pagePath}: ${pageViews}회`);
    });
  } catch (error) {
    console.error('에러 발생:', error.message);
  }
}

runReport();

node test-ga.js

지난 7일간 페이지뷰 Top 10:

/: 1523회
/posts/nextjs-guide: 342회
/posts/react-hooks: 287회
/about: 156회
...

async function getRealtimeUsers() {
  const [response] = await analyticsDataClient.runRealtimeReport({
    property: `properties/${propertyId}`,
    metrics: [
      {
        name: 'activeUsers',
      },
    ],
  });

  const activeUsers = response.rows?.[0]?.metricValues?.[0]?.value || 0;
  console.log(`현재 실시간 방문자: ${activeUsers}명`);
}

async function getTopPosts() {
  const [response] = await analyticsDataClient.runReport({
    property: `properties/${propertyId}`,
    dateRanges: [{ startDate: '30daysAgo', endDate: 'today' }],
    dimensions: [{ name: 'pagePath' }, { name: 'pageTitle' }],
    metrics: [{ name: 'screenPageViews' }],
    orderBys: [{ metric: { metricName: 'screenPageViews' }, desc: true }],
    limit: 5,
  });

  console.log('최근 30일 인기 포스트 Top 5:');
  response.rows.forEach((row, index) => {
    const title = row.dimensionValues[1].value;
    const views = row.metricValues[0].value;
    console.log(`${index + 1}. ${title}: ${views}회`);
  });
}

async function getTrafficSources() {
  const [response] = await analyticsDataClient.runReport({
    property: `properties/${propertyId}`,
    dateRanges: [{ startDate: '7daysAgo', endDate: 'today' }],
    dimensions: [{ name: 'sessionSource' }],
    metrics: [{ name: 'sessions' }],
    orderBys: [{ metric: { metricName: 'sessions' }, desc: true }],
  });

  console.log('지난 7일 트래픽 소스:');
  response.rows.forEach((row) => {
    const source = row.dimensionValues[0].value;
    const sessions = row.metricValues[0].value;
    console.log(`${source}: ${sessions}세션`);
  });
}

# Google Cloud Service Account
*-service-account-key.json

const analyticsDataClient = new BetaAnalyticsDataClient({
  credentials: {
    client_email: process.env.GA_CLIENT_EMAIL,
    private_key: process.env.GA_PRIVATE_KEY.replace(/\\n/g, '\n'),
  },
});

property: `properties/123456789` // 올바름
property: `123456789` // 틀림