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

# Live Activities 分析

> OneSignal を使用して iOS Live Activities のパフォーマンスを分析・測定する方法を学びます。配信率、クリック数、ユーザーエンゲージメントを追跡して、リアルタイム更新戦略を最適化します。

配信率、クリック数、ユーザーエンゲージメントなどの主要メトリクスを追跡することで、Live Activities がどのようにパフォーマンスしているかを理解します。OneSignal は、リアルタイム更新戦略を最適化するための包括的な分析を提供します。

<Note>
  このガイドは [Live Activities](./live-activities) の分析をカバーしています。分析に深く入る前に、Live Activities がセットアップされていることを確認してください。
</Note>

***

## 概要

Live Activities 分析は以下を理解するのに役立ちます：

* 何人のユーザーがあなたの更新を受け取っているか
* ユーザーがあなたの Live Activities と関わっているかどうか
* 配信の失敗がどこで発生しているか
* あなたの購読者ベースが時間の経過とともにどのように変化しているか

***

## 主要メトリクス

Live Activities は以下のメトリクスを提供します。詳細については、[エンゲージメントトレンド](./engagement-analytics) を参照してください。

| メトリクス      | 定義                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------ |
| **送信済み**   | OneSignal から Apple Push Notification service (APNs) に送信された Live Activities。push-to-start と push-to-update 通知を含みます。 |
| **配信確認済み** | デバイスへの配信が確認された Live Activities。iOS SDK 5.2.15+ と OneSignal セットアップ方法が必要です。                                          |
| **失敗**     | エラーにより配信に失敗した Live Activities。                                                                                     |
| **購読解除済み** | ユーザーが Live Activity を却下したり、設定で Live Activities を無効にしたときに購読解除としてマークされた購読。                                           |
| **クリック済み** | すべての Live Activities の総クリック数。同じユーザーによる複数のクリックは個別にカウントされます。                                                         |

<Note>
  **配信確認済み** と **クリック済み** のメトリクスには iOS SDK バージョン **5.2.15 以上** が必要です。これらの追跡機能を利用するために、アプリが更新されていることを確認してください。
</Note>

***

## メッセージレポート

配信率とクリック率を追跡することで、Live Activities の効果を分析するためにメッセージレポートを使用します。

<Frame caption="Live Activity レポート">
  <img src="https://mintcdn.com/onesignal/vW9xDwSIrN3V7agt/images/live-activities/live-activity-report.png?fit=max&auto=format&n=vW9xDwSIrN3V7agt&q=85&s=e9e93614f215a30145dffaf02731fce8" width="1600" height="1171" data-path="images/live-activities/live-activity-report.png" />
</Frame>

### メッセージレポートへのアクセス

1. OneSignal ダッシュボードで**送信済みメッセージ**に移動
2. **Live Activities** でフィルタリングして、Live Activity メッセージのみを表示
3. 任意の Live Activity をクリックして詳細レポートを表示

### 統計と定義

| メトリクス      | 定義                                                                       |
| ---------- | ------------------------------------------------------------------------ |
| **配信済み**   | Live Activity を受信したサブスクリプションの数。                                          |
| **配信確認済み** | アクティビティの受信を確認したサブスクリプションの数。                                              |
| **失敗**     | エラーにより Live Activity を受信しなかったサブスクリプションの数。                                |
| **購読解除済み** | アプリをアンインストール、オプトアウトし、それ以降アプリを開いていないため Live Activity を受信しなかったサブスクリプションの数。 |
| **クリック済み** | すべての Live Activities の総クリック数。同じユーザーによる複数のクリックは個別にカウントされます。               |

***

## オーディエンス活動

オーディエンス活動パネルでは、配信、クリック、失敗、購読解除など、Live Activity に関連するユーザーの最近の活動を確認できます。

### オーディエンス活動の表示

1. Live Activity メッセージレポートを開く
2. **オーディエンス活動**パネルを見つける
3. 表示したい統計タイプを選択：
   * **配信** — Live Activity を受信したユーザー
   * **クリック** — Live Activity をタップしたユーザー
   * **失敗** — エラーにより Live Activity を受信しなかったユーザー
   * **購読解除** — 購読解除または削除されたユーザー

### ユーザー行動の理解

オーディエンス活動データを使用して：

* ユーザーエンゲージメントのパターンを特定
* 特定のユーザーセグメントの配信問題をトラブルシューティング
* Live Activity コンテンツがクリック率に与える影響を追跡
* 時間経過による購読の健全性を監視

***

## 結果のエクスポート

オーディエンス活動パネルの上にある**エクスポート**ボタンをクリックすることで、Live Activity のオーディエンス活動をエクスポートできます。

### エクスポートオプション

* **単一統計** — 現在選択されている活動タイプのみをエクスポート（例：クリックのみ、または失敗のみ）
* **すべての統計** — すべてのオーディエンス活動データを一度にエクスポート

### エクスポートの受信

オーディエンス活動のエクスポートは、ログインしているユーザーのメールアドレスに結果を含むメールを直接送信します。エクスポートには以下が含まれます：

* ユーザー識別子
* 活動のタイムスタンプ
* 活動タイプ
* デバイスとプラットフォーム情報（利用可能な場合）

<Note>
  大規模なエクスポートは処理に数分かかる場合があります。エクスポートの準備ができたときにメール通知を受け取ります。
</Note>

***

## パフォーマンス分析

### 配信率

Live Activities がどれだけ効果的にユーザーに届いているかを理解するために配信率を計算：

```
配信率 = (配信確認済み / 送信済み) × 100
```

健全な配信率は通常 **95% 以上** です。低い率は以下を示している可能性があります：

* 古いプッシュトークン
* Live Activities を無効にしているユーザー
* ネットワーク接続の問題

### クリック率 (CTR)

Live Activities でのエンゲージメントを測定：

```
CTR = (クリック済み / 配信確認済み) × 100
```

### パフォーマンスのベンチマーク

時間の経過とともにメトリクスを比較してトレンドを識別：

* **週次** — 配信率は改善していますか？
* **コンテンツタイプ別** — 特定の Live Activity タイプがより良いパフォーマンスを示していますか？
* **時間帯別** — ユーザーが最もエンゲージするのはいつですか？

***

## 一般的な問題のトラブルシューティング

### 高い失敗率

失敗率が高い場合：

1. **プッシュトークンの有効性を確認** — ユーザーがアプリをアンインストールまたは再インストールするとトークンが期限切れになります
2. **APNs 設定を確認** — プッシュ証明書が最新であることを確認
3. **エラーメッセージを確認** — 特定のエラーコードについて失敗の詳細を確認

### 低い配信確認

配信確認が送信済みより大幅に低い場合：

1. **SDK バージョンを確認** — 配信確認には iOS SDK 5.2.15+ が必要
2. **OneSignal セットアップを確認** — OneSignal セットアップ方法が適切に実装されていることを確認
3. **ネットワーク状況を考慮** — 一部のユーザーは断続的な接続を持っている可能性があります

### クリック率の低下

クリック率が低下している場合：

1. **コンテンツの関連性を確認** — 更新が価値を提供していますか？
2. **タイミングを確認** — 適切な時間に更新を送信していますか？
3. **UI/UX を監査** — Live Activity のデザインがインタラクションを促進していることを確認

***

## 分析のベストプラクティス

### 定期的な監視

* Live Activity のパフォーマンスを週次で確認
* 重要なメトリクス変更のアラートを設定
* 異なる Live Activity タイプ間のパフォーマンスを比較

### データ駆動の最適化

* 異なるコンテンツアプローチの A/B テスト
* 更新頻度の実験
* 最もエンゲージメントを促進するイベントを分析

### 履歴分析

Live Activity データはダッシュボードで最大 **30 日間** 利用可能です。より長期的な分析のために：

* 定期的にデータをエクスポート
* スプレッドシートまたは分析ツールでトレンドを追跡
* パフォーマンスの変化と関連付けるために変更を文書化

***

## よくある質問

### Live Activity データはどのくらい保持されますか？

**送信済みメッセージ**の下で Live Activities でフィルタリングした後、ダッシュボードで過去に送信された Live Activities（最大 30 日）を表示できます。

### なぜ配信確認が送信済みより低いのですか？

配信確認には iOS SDK バージョン 5.2.15 以上と適切な OneSignal セットアップが必要です。アプリに古い SDK バージョンのユーザーがいる場合、彼らは配信確認を報告しません。

### 個々のユーザージャーニーを追跡できますか？

はい、オーディエンス活動パネルで個々のユーザー活動を表示できます。より深い分析のためにこのデータをエクスポートすることもできます。

### クリック率を向上させるにはどうすればよいですか？

ユーザーに明確な価値を提供するタイムリーで関連性のある更新の提供に焦点を当ててください。Live Activity のデザインに明確なタップターゲットと説得力のあるコンテンツがあることを確認してください。

***
