> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics モジュール

> `base44.analytics` を介してカスタムイベントとユーザーアクティビティをトラッキングします。

<Warning>
  このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは [デベロッパードキュメント](/developers) を参照してください。
</Warning>

# Analytics モジュール

`base44.analytics` を介してカスタムイベントとユーザーアクティビティをトラッキングします。

## 目次

* [メソッド](#methods)
* [例](#examples)
* [自動トラッキング](#automatic-tracking)
* [ベストプラクティス](#best-practices)

## メソッド

| メソッド            | シグネチャ  | 説明              |
| --------------- | ------ | --------------- |
| `track(params)` | `void` | カスタムイベントをトラッキング |

## 例

### カスタムイベントのトラッキング

```javascript theme={null}
// Track a simple event
base44.analytics.track({
  eventName: "button_clicked"
});

// Track event with properties
base44.analytics.track({
  eventName: "purchase_completed",
  properties: {
    product_id: "prod-123",
    amount: 99.99,
    currency: "USD"
  }
});
```

### ユーザーアクションのトラッキング

```javascript theme={null}
// Track page view
base44.analytics.track({
  eventName: "page_view",
  properties: {
    page: "/dashboard",
    referrer: document.referrer
  }
});

// Track feature usage
base44.analytics.track({
  eventName: "feature_used",
  properties: {
    feature: "export_data",
    format: "csv"
  }
});
```

## 自動トラッキング

Analytics モジュールは以下を自動的にトラッキングします:

* **初期化イベント**: アプリがロードされたとき
* **ハートビートイベント**: 定期的なアクティビティシグナル
* **セッション時間**: アプリで費やされた時間

これらの内部イベントは、手動のインストルメンテーションなしにユーザーエンゲージメントを測定するのに役立ちます。

## ベストプラクティス

1. **説明的なイベント名を使用**: `click` の代わりに `order_completed`
2. **関連するプロパティを含める**: イベントを分析するのに役立つコンテキストを追加
3. **一貫性を保つ**: アプリ全体で同じイベント名とプロパティキーを使用
4. **機密データをトラッキングしない**: イベントプロパティに PII を含めない

```javascript theme={null}
// Good: Descriptive with relevant properties
base44.analytics.track({
  eventName: "subscription_started",
  properties: {
    plan: "pro",
    billing_cycle: "annual"
  }
});

// Avoid: Vague event name, no context
base44.analytics.track({
  eventName: "click"
});
```

## 型定義

```typescript theme={null}
/** Properties that can be attached to a tracked event. */
type TrackEventProperties = {
  [key: string]: string | number | boolean | null | undefined;
};

/** Parameters for the track() method. */
interface TrackEventParams {
  /** The name of the event to track. */
  eventName: string;
  /** Optional properties to attach to the event. */
  properties?: TrackEventProperties;
}

/** The analytics module interface. */
interface AnalyticsModule {
  /** Track a custom event with optional properties. */
  track(params: TrackEventParams): void;
}
```

<Note>このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。 </Note>