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

Live Activitiesの例


Live Activitiesを使用する理由は?

Live Activitiesは、リアルタイム、トランザクション、または時間制限のある更新に最適です。
  • 最大8時間表示可能
  • プロビジョナル — 最初のLive Activityを表示するのに権限は不要
  • ロック画面やDynamic Islandなどのプレミアムデバイス画面で非常に魅力的で目立つ

OneSignalを使用する理由は?

OneSignalは次のことを処理することでLive Activitiesを簡素化します:
  • 一時的なプッシュトークン管理
  • 単一のAPI呼び出しで数百万のデバイスにスケーリング
  • リアルタイム分析とパフォーマンスインサイト
  • プッシュ、メール、SMS、アプリ内メッセージとのクロスチャネルオーケストレーション
Live Activitiesは、10,000人を超えるオプトインサブスクライバーを持つ無料プランを除くすべてのプランで利用できます。価格を見るか、[email protected]にお問い合わせください。

Live Activitiesの開始

要件

Live Activitiesの仕組み

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

Live Activityの作成と更新

1

Live Activityを開始する

Live Activitiesは2つの方法で開始できます:
  1. Start Live Activity API(別名「push-to-start」)を使用する。
  2. アプリ内でトリガーする(Live Activities開発者セットアップ)。
2

Live Activityを更新する

Update Live Activity APIを使用し、activity_idを渡して関連するすべてのデバイスを更新します。
3

Live Activityを終了する

Live Activitiesは次の方法で終了できます:
  • OneSignal SDK (`exitLiveActivity`)
  • Update Live Activity API
  • ユーザーアクション
  • 指定されたactivityIdの更新送信を停止するリクエストをOneSignalのサーバーに送信します。
  • 画面からLive Activityを削除しません。4時間後またはユーザーアクションによって自動的に削除されます。
SDKメソッドは、Live Activityを視覚的に閉じません
  • 開発者は、dismissal_dateを持つAPIまたはネイティブiOSメソッド(例:activity.end(dismissalPolicy: .immediate))を使用する必要があります。
  • プログラムでLive Activityを削除するには、ユーザーが「許可」をクリックしている必要があります。

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

機能性

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

UI/UX

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

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

Live Activityが期待どおりに表示されることを確認します。通常、ユーザーがアクション(例:イベントをフォローする)を実行するか、更新を確認するためにアプリを開いたとき(例:配達時間の更新)です。
  • スポーツゲーム、コンサート、その他のライブイベントなどのイベント用にユーザーのセグメントをターゲットにします。
  • 個人的またはトランザクションイベント用に個々のユーザーをターゲットにします。
ユーザーのターゲティング方法の詳細は、OneSignal APIでメッセージを送信するドキュメントをご覧ください。
Live Activitiesを更新する際、更新の緊急度を決定するためにAppleが使用する「優先度」を設定するオプションがあります。Appleには内部しきい値があり、高優先度フラグを頻繁に使用するリクエストをスロットルします。この内部しきい値により、Appleはスロットリングを防ぐために通常優先度と高優先度を混在させることを推奨しています。優先度の設定方法の詳細は、Update Live Activity APIリファレンスをご覧ください。 ユースケースでより頻繁な高優先度更新が必要な場合は、AppleのDeveloper Docsで指示されているように、Info.plistにBoolean型でYESに設定されたNSSupportsLiveActivitiesFrequentUpdatesキーを追加できます。Live Activityがプッシュ予算を超えると、ユーザーにダイアログが表示され、ユーザーがLive Activityの継続を許可すると、シームレスなユーザーエクスペリエンスのために予算が自動的に増加します。

FAQ

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

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

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

Appleは高優先度(priority: 10)更新に固定制限を提供していませんが、動的なシステムレベルの予算を適用しています。短期間に高優先度更新を送信しすぎると、更新が遅延またはドロップされるスロットリングが発生する可能性があります。 スロットリングのリスクを軽減するには:
  • 優先度レベルを混在させる:Appleは、バランスを取るためにpriority: 5(標準)とpriority: 10(高)の両方を使用することを推奨しています。
  • priority: 10は、時間に敏感または重要な更新のみに予約します(例:注文ステータスの変更、ゲームスコア)。
ユースケースで頻繁な更新が必要な場合:
  • アプリのInfo.plistファイルにNSSupportsLiveActivitiesFrequentUpdatesキーをBoolean YESとして追加します。
  • この予算を超えると、iOSはユーザーに追加の更新を許可するように促す場合があります。ユーザーが同意すると、Appleはシームレスなエクスペリエンスを維持するために、許可された更新制限を自動的に拡張します。
詳細については、AppleのDeveloper Docsを参照してください。

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

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

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

Appleは、iOS 16+およびiPadOS 17+で動作するすべてのデバイスの更新された互換性ガイドを提供しています。
Live Activitiesについて知っておく必要があるすべてが揃いました。Live Activities開発者ドキュメントに従ってLive Activitiesの設定を開始してください。