> ## 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を使用して、ロック画面とDynamic Islandにリアルタイム更新を直接配信する方法を学びます。スポーツスコア、配達などのイベントのシームレスな追跡を可能にします。

Live Activitiesを使用すると、iOSおよびiPadOSアプリがロック画面とDynamic Islandにリアルタイム更新を配信でき、ユーザーはアプリを開く必要なく情報を得ることができます。iOS 16.1で導入され、iOS 17に拡張されたLive Activitiesは、配達追跡、ゲームスコア、交通機関の更新などの時間に敏感な情報に最適です。

<Note>
  Live ActivitiesはiOS機能ですが、[Android Live Notifications](./android-live-notifications)で同様の機能を実現できます。
</Note>

<Frame caption="Live Activitiesの例">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/67688a22bb44b87b57a4bd27f114eea45298dfa4d1d48f1b64b2d449ea93c206-channel-setup-live-activities.jpg?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=dde03fd57c37604ed28894c0d49d1480" width="1280" height="720" data-path="images/docs/67688a22bb44b87b57a4bd27f114eea45298dfa4d1d48f1b64b2d449ea93c206-channel-setup-live-activities.jpg" />
</Frame>

***

## Live Activitiesを使用する理由は？

Live Activitiesは、リアルタイム、トランザクション、または時間制限のある更新に最適です。

* 最大8時間表示可能
* プロビジョナル — 最初のLive Activityを表示するのに権限は不要
* ロック画面やDynamic Islandなどのプレミアムデバイス画面で非常に魅力的で目立つ

<Note>
  [ブログでユースケースの詳細を確認 →](https://onesignal.com/blog/new-live-activities-support-to-help-you-drive-loyalty-faster)
</Note>

***

## OneSignalを使用する理由は？

OneSignalは次のことを処理することでLive Activitiesを簡素化します：

* 一時的なプッシュトークン管理
* 単一のAPI呼び出しで数百万のデバイスにスケーリング
* リアルタイム分析とパフォーマンスインサイト
* プッシュ、メール、SMS、アプリ内メッセージとのクロスチャネルオーケストレーション

<Note>
  Live Activitiesは、10,000人を超えるオプトインサブスクライバーを持つ無料プランを除くすべてのプランで利用できます。[価格を見る](https://onesignal.com/pricing)か、`support@onesignal.com`にお問い合わせください。
</Note>

***

## Live Activitiesの開始

### 要件

* iOS 16.1+またはiPadOS 17+
* OneSignal [Mobile SDK統合](./mobile-sdk-setup)
* [Live Activities開発者ガイド](./live-activities-developer-setup)に従って設定完了
* クリック追跡と確認配信にはiOS SDK バージョン **5.2.15以上** が必要

### Live Activitiesの仕組み

* **表示期間**: 最大8時間アクティブ（[Update Live Activity API](/reference/update-live-activity-api)の`dismissal_date`パラメーターを使用して削除可能）。
* **権限不要**: 最初のアクティビティはプロビジョナル。将来のアクティビティはユーザー設定に依存します。
* **制限**: アプリごとに同時に最大5つのLive Activities。
* **リモート開始**: iOS 17.2+からプッシュ経由でサポート。
* **非プロモーション用途**: ユーザー価値を提供する必要があり、広告用には設計されていません。

### Live Activityの作成と更新

<Steps>
  <Step title="Live Activityを開始する">
    Live Activitiesは2つの方法で開始できます：

    1. [Start Live Activity API](/reference/start-live-activity)（別名「push-to-start」）を使用する。
    2. アプリ内でトリガーする（[Live Activities開発者セットアップ](./live-activities-developer-setup)）。
  </Step>

  <Step title="Live Activityを更新する">
    [Update Live Activity API](/reference/update-live-activity-api)を使用し、`activity_id`を渡して関連するすべてのデバイスを更新します。
  </Step>

  <Step title="Live Activityを終了する">
    Live Activitiesは次の方法で終了できます：

    <Tabs>
      <Tab title="OneSignal SDK (`exitLiveActivity`)">
        * 指定された`activityId`の更新送信を停止するリクエストをOneSignalのサーバーに送信します。
        * 画面からLive Activityを削除**しません**。4時間後またはユーザーアクションによって自動的に削除されます。
      </Tab>

      <Tab title="Update Live Activity API">
        `event: end`フィールドを使用して今後の更新を停止し、`dismissal_date`を含めて画面からLive Activityを削除します：

        * Live Activityは、4時間後またはユーザーアクションによって画面から自動的に削除されます。
        * 次の4時間以内に**将来の**`dismissal_date`時刻を設定して、より早く削除します。
        * **過去の**`dismissal_date`時刻を設定して、ユーザーの画面から即座に削除します。プログラムでLive Activityを削除するには、ユーザーが「許可」をクリックしている必要があります。
      </Tab>

      <Tab title="ユーザーアクション">
        * ユーザーがスワイプして削除するなど、Live Activityを手動で閉じる。
        * ユーザーがiOS設定でLive Activity権限を取り消す。
      </Tab>
    </Tabs>

    <Note>
      SDKメソッドは、Live Activityを視覚的に閉じ*ません*。

      * 開発者は、`dismissal_date`を持つAPIまたはネイティブiOSメソッド（例：`activity.end(dismissalPolicy: .immediate)`）を使用する必要があります。
      * プログラムでLive Activityを削除するには、ユーザーが「許可」をクリックしている必要があります。
    </Note>
  </Step>
</Steps>

***

## 分析とレポート

OneSignalは、Live Activitiesのパフォーマンスを測定し最適化するための包括的な分析を提供します。配信率、クリック数、失敗、サブスクリプションの変更などの主要な指標を追跡します。

**利用可能な主要指標：**

* **送信済み**: OneSignalからApple Push Notification service（APNs）に送信されたLive Activities
* **確認済み配信**: デバイスへの配信が確認されたLive Activities（iOS SDK 5.2.15+が必要）
* **失敗**: 配信に失敗したLive Activities
* **登録解除**: ユーザーがLive Activitiesを却下または無効化したときに登録解除としてマークされたサブスクリプション
* **クリック済み**: すべてのLive Activitiesのクリック総数

<Note>
  メッセージレポート、オーディエンス活動、データエクスポート、パフォーマンス分析の詳細情報については、[Live Activities分析ガイド](./live-activities-analytics)を参照してください。
</Note>

***

## ベストプラクティスとガイドライン

### 機能性

* トランザクションまたはコンテキスト更新（例：ETA、スコア、タイマー）にLive Activitiesを使用します。
  * ユーザーがアプリに絶えず入ってステータスや変更を確認する代わりに、電話を一目見るだけで更新を取得できます。
  * 明確な開始と終了があるイベントまたはタスク。広告を表示したり、純粋にプロモーション目的で使用したりするためにLive Activityを使用しないでください。どのような価値を提供していますか？
* デバイスバッテリーを保護するために、過度な更新を避けます。
* Live Activityが8時間以下のイベントまたはタスク用であり、ユーザーにとって有用である限りのみ表示されることを確認します。

### UI/UX

* すべてのLive Activityプレゼンテーションをサポート：Compact、Minimal、Expanded、ロック画面。
* ブランディング、スペーシング、ダーク/ライトテーマを正しく使用します。
* 明確さとタップターゲットを優先します。Dynamic Islandに注意を引こうとしないでください。
* Live Activityに機密情報を表示しないでください。

<Note>
  Live Activitiesのベストプラクティスの詳細については、Appleの[Live Activities Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/live-activities)を参照してください。
</Note>

### ターゲティングと大規模送信

Live Activityが期待どおりに表示されることを確認します。通常、ユーザーがアクション（例：イベントをフォローする）を実行するか、更新を確認するためにアプリを開いたとき（例：配達時間の更新）です。

* スポーツゲーム、コンサート、その他のライブイベントなどのイベント用にユーザーのセグメントをターゲットにします。
* 個人的またはトランザクションイベント用に個々のユーザーをターゲットにします。

<Note>
  ユーザーのターゲティング方法の詳細は、[OneSignal APIでメッセージを送信するドキュメント](reference/create-message)をご覧ください。
</Note>

Live Activitiesを更新する際、更新の緊急度を決定するためにAppleが使用する「優先度」を設定するオプションがあります。Appleには内部しきい値があり、高優先度フラグを頻繁に使用するリクエストをスロットルします。この内部しきい値により、Appleはスロットリングを防ぐために通常優先度と高優先度を混在させることを推奨しています。優先度の設定方法の詳細は、[Update Live Activity APIリファレンス](/reference/update-live-activity-api)をご覧ください。

ユースケースでより頻繁な高優先度更新が必要な場合は、[AppleのDeveloper Docs](https://developer.apple.com/documentation/activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications#Determine-the-update-frequency)で指示されているように、Info.plistにBoolean型でYESに設定された`NSSupportsLiveActivitiesFrequentUpdates`キーを追加できます。Live Activityがプッシュ予算を超えると、ユーザーにダイアログが表示され、ユーザーがLive Activityの継続を許可すると、シームレスなユーザーエクスペリエンスのために予算が自動的に増加します。

***

## FAQ

### プランでLive Activitiesにアクセスできますか？

Live Activitiesは、10,000人を超えるオプトインサブスクライバーを持つ無料プランを除くすべてのプランで利用できます。無料プランで10,000人を超えるオプトインサブスクライバーがいる場合は、アップグレードしてLive Activitiesを使用できます。[価格を見る](https://onesignal.com/pricing)か、`support@onesignal.com`にお問い合わせください。

### 高優先度更新の予算は何ですか？

Appleは高優先度（`priority: 10`）更新に固定制限を提供していませんが、動的なシステムレベルの予算を適用しています。短期間に高優先度更新を送信しすぎると、更新が遅延またはドロップされるスロットリングが発生する可能性があります。

スロットリングのリスクを軽減するには：

* 優先度レベルを混在させる：Appleは、バランスを取るために`priority: 5`（標準）と`priority: 10`（高）の両方を使用することを推奨しています。
* `priority: 10`は、時間に敏感または重要な更新のみに予約します（例：注文ステータスの変更、ゲームスコア）。

ユースケースで頻繁な更新が必要な場合：

* アプリの`Info.plist`ファイルに`NSSupportsLiveActivitiesFrequentUpdates`キーをBoolean `YES`として追加します。
* この予算を超えると、iOSはユーザーに追加の更新を許可するように促す場合があります。ユーザーが同意すると、Appleはシームレスなエクスペリエンスを維持するために、許可された更新制限を自動的に拡張します。

詳細については、[AppleのDeveloper Docs](https://developer.apple.com/documentation/activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications#Determine-the-update-frequency)を参照してください。

### OneSignalダッシュボードでLive Activitiesはどこで確認できますか？

Live ActivitiesはLive Activities API経由でのみ送信できます。ただし、ダッシュボードの送信済みメッセージで、Live Activitiesでフィルタリングした後、過去に送信されたLive Activities（最大30日間）を表示できます。ここで、どのLive Activitiesが送信されたか、どの更新情報が送信されたか、および更新を受信したオーディエンスのサイズを確認できます。

### Live Activitiesはどのデバイスで動作しますか？

Appleは、[iOS 16+](https://support.apple.com/guide/iphone/supported-models-iphe3fa5df43/16.0/ios/16.0)および[iPadOS 17+](https://support.apple.com/guide/ipad/ipad-models-compatible-with-ipados-17-ipad213a25b2/ipados)で動作するすべてのデバイスの更新された互換性ガイドを提供しています。

***

<Check>
  Live Activitiesについて知っておく必要があるすべてが揃いました。

  [Live Activities開発者ドキュメント](./live-activities-developer-setup)に従ってLive Activitiesの設定を開始してください。
</Check>

***