App Store Connect 新機能2026：100以上の新メトリクスをAntigravityで活用する方法

// .env.local（Antigravityが自動生成を支援）
APP_STORE_CONNECT_KEY_ID=YOUR_KEY_ID
APP_STORE_CONNECT_ISSUER_ID=YOUR_ISSUER_ID
APP_STORE_CONNECT_PRIVATE_KEY_PATH=./AuthKey_XXXXXXXX.p8
 
// lib/appStoreConnect.ts
import jwt from 'jsonwebtoken';
import fs from 'fs';
 
export function generateASCToken(): string {
  const privateKey = fs.readFileSync(
    process.env.APP_STORE_CONNECT_PRIVATE_KEY_PATH!
  );
 
  // JWTトークンを生成（有効期限20分）
  const token = jwt.sign(
    {},
    privateKey,
    {
      algorithm: 'ES256',
      expiresIn: '20m',
      audience: 'appstoreconnect-v1',
      issuer: process.env.APP_STORE_CONNECT_ISSUER_ID,
      keyid: process.env.APP_STORE_CONNECT_KEY_ID,
    }
  );
 
  return token;
}

// scripts/fetchAppMetrics.ts
import fetch from 'node-fetch';
import { generateASCToken } from '../lib/appStoreConnect';
 
const APP_ID = 'YOUR_APP_ID'; // App Store ConnectのアプリID
 
async function fetchEngagementMetrics(
  startDate: string,
  endDate: string
) {
  const token = generateASCToken();
 
  // 新しいエンゲージメントメトリクスエンドポイント
  const response = await fetch(
    `https://api.appstoreconnect.apple.com/v1/analyticsReportRequests`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        data: {
          type: 'analyticsReportRequests',
          attributes: {
            accessType: 'ONGOING',
          },
          relationships: {
            app: {
              data: { type: 'apps', id: APP_ID },
            },
          },
        },
      }),
    }
  );
 
  const data = await response.json();
  console.log('メトリクスリクエスト作成:', data);
  return data;
}
 
// セッション分析データを取得
async function fetchSessionMetrics() {
  const token = generateASCToken();
 
  const response = await fetch(
    `https://api.appstoreconnect.apple.com/v1/apps/${APP_ID}/analyticsDetailData`,
    {
      headers: {
        'Authorization': `Bearer ${token}`,
      },
    }
  );
 
  // 期待する出力例:
  // {
  //   avgSessionDuration: 4.2,  // 分
  //   sessionsPerActiveDevice: 3.1,
  //   activeDevices: 12450,
  //   crashRate: 0.12  // %
  // }
 
  return await response.json();
}
 
fetchSessionMetrics().catch(console.error);

// components/MetricsDashboard.tsx
'use client';
 
import { useEffect, useState } from 'react';
 
interface AppMetrics {
  downloads: number;
  activeUsers: number;
  crashRate: number;
  avgSessionDuration: number;
  revenue: number;
  subscriptionChurnRate: number;
}
 
export function MetricsDashboard() {
  const [metrics, setMetrics] = useState<AppMetrics | null>(null);
  const [loading, setLoading] = useState(true);
 
  useEffect(() => {
    async function loadMetrics() {
      try {
        // App Store Connect APIからデータを取得
        const res = await fetch('/api/app-metrics');
        const data = await res.json();
        setMetrics(data);
      } catch (error) {
        console.error('メトリクス取得エラー:', error);
      } finally {
        setLoading(false);
      }
    }
    loadMetrics();
  }, []);
 
  if (loading) return <div>データを読み込み中...</div>;
  if (!metrics) return <div>データがありません</div>;
 
  return (
    <div className="grid grid-cols-3 gap-4 p-6">
      <MetricCard
        title="ダウンロード数"
        value={metrics.downloads.toLocaleString()}
        trend="+12%"
        positive
      />
      <MetricCard
        title="アクティブユーザー"
        value={metrics.activeUsers.toLocaleString()}
        trend="+8%"
        positive
      />
      <MetricCard
        title="クラッシュ率"
        value={`${metrics.crashRate}%`}
        trend="-0.05%"
        positive
      />
      <MetricCard
        title="平均セッション時間"
        value={`${metrics.avgSessionDuration}分`}
        trend="+0.3分"
        positive
      />
      <MetricCard
        title="月間収益"
        value={`¥${metrics.revenue.toLocaleString()}`}
        trend="+15%"
        positive
      />
      <MetricCard
        title="チャーン率"
        value={`${metrics.subscriptionChurnRate}%`}
        trend="-0.8%"
        positive
      />
    </div>
  );
}
 
interface MetricCardProps {
  title: string;
  value: string;
  trend: string;
  positive: boolean;
}
 
function MetricCard({ title, value, trend, positive }: MetricCardProps) {
  return (
    <div className="bg-white rounded-xl p-4 shadow-sm border">
      <p className="text-sm text-gray-500">{title}</p>
      <p className="text-2xl font-bold mt-1">{value}</p>
      <p className={`text-sm mt-1 ${positive ? 'text-green-600' : 'text-red-600'}`}>
        {trend} 前週比
      </p>
    </div>
  );
}

// scripts/checkReviewStatus.ts
async function checkAppReviewStatus(appId: string): Promise<void> {
  const token = generateASCToken();
 
  const response = await fetch(
    `https://api.appstoreconnect.apple.com/v1/apps/${appId}/appStoreVersions`,
    {
      headers: {
        'Authorization': `Bearer ${token}`,
      },
    }
  );
 
  const data = await response.json();
  const latestVersion = data.data[0];
  const reviewState = latestVersion?.attributes?.appStoreState;
 
  // 期待する出力:
  // WAITING_FOR_REVIEW / IN_REVIEW / PENDING_DEVELOPER_RELEASE
  // READY_FOR_SALE / REJECTED
  console.log(`現在の審査ステータス: ${reviewState}`);
 
  // 審査完了時にSlack通知を送る例
  if (reviewState === 'READY_FOR_SALE' || reviewState === 'REJECTED') {
    await sendSlackNotification(`App審査結果: ${reviewState}`);
  }
}
 
async function sendSlackNotification(message: string): Promise<void> {
  // Slack Webhook URL（環境変数から取得）
  const webhookUrl = process.env.SLACK_WEBHOOK_URL;
  if (!webhookUrl) return;
 
  await fetch(webhookUrl, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text: message }),
  });
}