GA4 Data APIとは
Google Analytics 4（GA4）のData APIは、GA4のアクセス解析データをプログラムから取得するためのAPIです。Google Analyticsのダッシュボードで閲覧できるPV数・セッション・コンバージョン・ユーザー属性などのデータをAPIで取得し、独自のレポートやダッシュボードに活用できます。
認証の設定（サービスアカウント）
- Google Cloud ConsoleでGA4 Data APIを有効化
- サービスアカウントを作成してJSONキーをダウンロード
- GA4管理画面でサービスアカウントのメールアドレスに閲覧者権限を付与
基本的なレポートの取得
import { BetaAnalyticsDataClient } from '@google-analytics/data';
const analyticsDataClient = new BetaAnalyticsDataClient({
keyFilename: './service-account.json'
});
const [response] = await analyticsDataClient.runReport({
property: `properties/${GA4_PROPERTY_ID}`,
dateRanges: [{ startDate: '30daysAgo', endDate: 'today' }],
dimensions: [
{ name: 'pagePath' },
{ name: 'pageTitle' }
],
metrics: [
{ name: 'screenPageViews' }, // ページビュー数
{ name: 'sessions' }, // セッション数
{ name: 'bounceRate' }, // 直帰率
{ name: 'averageSessionDuration' } // 平均セッション時間
],
orderBys: [{ metric: { metricName: 'screenPageViews' }, desc: true }],
limit: 20
});
response.rows.forEach(row => {
console.log(`${row.dimensionValues[0].value}: ${row.metricValues[0].value}PV`);
});主要な指標（Metrics）
screenPageViews：ページビュー数sessions：セッション数activeUsers：アクティブユーザー数newUsers：新規ユーザー数bounceRate：直帰率averageSessionDuration：平均セッション時間（秒）conversions：コンバージョン数totalRevenue：合計収益
主要なディメンション（Dimensions）
pagePath：ページのURLpageTitle：ページタイトルsessionSource：流入元（organic・direct等）country：国deviceCategory：デバイス（desktop・mobile・tablet）date：日付（YYYYMMDD形式）
自動週次レポートの作成
GA4 Data APIとメール配信APIを組み合わせることで、毎週月曜日に先週のアクセス解析レポートを自動でメール送付するシステムを構築できます。SendGrid・nodemailerでHTML形式のレポートメールを作成し、スケジューラー（cron・Cloud Scheduler）で定期実行します。
まとめ
GA4 Data APIはWebサイトのアクセス解析データを自動化・カスタマイズするための強力なツールです。定期レポートの自動生成・カスタムダッシュボードへのデータ統合・SEO分析の自動化など多くの用途に活用できます。サービスアカウント認証を設定すれば、人の介入なしに24時間365日データを取得し続けられます。