分析ツール設定ガイド
概要
88API は、ユーザー行動とウェブサイトのパフォーマンスを追跡するのに役立つ、一般的な分析プラットフォームとの統合をサポートしました。
- Google Analytics 4 (GA4)：Googleの分析プラットフォームの最新バージョン
- Umami Analytics：プライバシーを重視したオープンソースの分析ツール
両方の分析ツールを同時に有効にすることができ、互いに干渉しません。
機能の特徴
✅ コード不要の統合 - 環境変数のみで設定
✅ Webインターフェースへのスクリプト自動注入
✅ Dockerおよびスタンドアロンデプロイのサポート
✅ プライバシーを重視した実装方法
✅ フロントエンドコードの変更不要
Google Analytics 4 の設定
1. 測定IDの取得
- Google Analytics にアクセス
- 新しいプロパティを作成するか、既存のプロパティを選択
- 管理 → データストリーム に移動
- ウェブサイトのデータストリームを作成または選択
- 測定ID をコピーします（形式：
G-XXXXXXXXXX）
2. 環境変数の設定
Docker Composeを使用する場合：
docker-compose.yml ファイルを編集し、Google Analyticsの行のコメントを解除します：
environment:
- GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX # 実際の測定IDに置き換えてくださいスタンドアロンデプロイの場合：
.env ファイルに追加するか、環境変数として設定します：
export GOOGLE_ANALYTICS_ID=G-XXXXXXXXXXDocker Runを使用する場合：
docker run -d \
-e GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX \
...其他选项...
calciumion/new-api:latest3. アプリケーションの再起動
# Docker Compose
docker-compose down && docker-compose up -d
# 独立部署
# アプリケーションを直接再起動してくださいUmami Analytics の設定
1. Umami認証情報の取得
オプション A：Umami Cloudを使用
- Umami Cloud で登録
- 新しいウェブサイトを追加
- ウェブサイトID をコピーします（UUID形式）
オプション B：Umamiをセルフホスティング
- 独自の Umami インスタンス をデプロイ
- ダッシュボードでウェブサイトを作成
- ウェブサイトID と スクリプトURL をコピー
2. 環境変数の設定
Docker Composeを使用する場合：
docker-compose.yml ファイルを編集します：
environment:
- UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
# オプション：セルフホスティングインスタンスのみ必要
- UMAMI_SCRIPT_URL=https://your-umami-domain.com/script.jsスタンドアロンデプロイの場合：
.env ファイルに追加します：
export UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export UMAMI_SCRIPT_URL=https://your-umami-domain.com/script.js # オプション注意： Umami Cloudを使用する場合、デフォルトで公式URLが使用されるため、UMAMI_SCRIPT_URLを設定する必要はありません。
3. アプリケーションの再起動
Google Analyticsと同様に、変更を適用するためにアプリケーションを再起動してください。
両方の分析ツールを同時に使用する
Google AnalyticsとUmamiを同時に有効にすることができます：
environment:
- GOOGLE_ANALYTICS_ID=G-ABC123XYZ
- UMAMI_WEBSITE_ID=a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6
- UMAMI_SCRIPT_URL=https://analytics.umami.is/script.js検証
アプリケーションを再起動した後：
- ブラウザでWebインターフェースを開く
- ブラウザの開発者ツール（F12）を開き、ネットワークタブに移動
- ページを更新
- 次の要求を探します：
- Google Analytics：
https://www.googletagmanager.com/gtag/js - Umami：設定したスクリプトURL
- Google Analytics：
ページソースを表示し、<head>セクションに注入されたスクリプトを探すこともできます。
トラブルシューティング
分析ツールが機能しませんか？
- ✅ 環境変数が正しく設定されていることを確認
- ✅ 変数変更後にアプリケーションを再起動
- ✅ ブラウザのコンソールエラーを確認
- ✅ 測定ID/ウェブサイトIDの形式が正しいことを確認
- ✅ 広告ブロッカーが干渉していないか確認
Dockerユーザーの場合：
# 環境変数が設定されているか確認
docker exec new-api env | grep -E "GOOGLE_ANALYTICS|UMAMI"プライバシーに関する考慮事項
- Google Analyticsは、Googleのプライバシーポリシーに従ってユーザーデータを収集します
- Umamiはプライバシーを重視しており、個人データを収集しません
- 分析ツールを使用する場合は、ウェブサイトにプライバシーポリシーを追加することを検討してください
- 両方のツールは、正しく設定されていればGDPR要件に準拠しています
環境変数リファレンス
| 変数 | 必須 | デフォルト値 | 説明 |
|---|---|---|---|
GOOGLE_ANALYTICS_ID | 否 | - | Google Analytics 4 測定ID（形式：G-XXXXXXXXXX） |
UMAMI_WEBSITE_ID | 否 | - | Umami ウェブサイトID（UUID形式） |
UMAMI_SCRIPT_URL | 否 | https://analytics.umami.is/script.js | Umami スクリプトURL（セルフホスティングのみ必要） |