概要
MoEngageのライブ活動をブロードキャストする機能は、iPhoneのロック画面と ダイナミックアイランド でリアルタイムのインタラクティブな更新を提供し、スコアや注文状況などのタイムリーな情報でアプリを開かずにユーザーエンゲージメントを向上させます。この機能は、マーケティング担当者がダイナミックなキャンペーンを作成し、リテンションを高め、視覚的にわかりやすい更新を通じてアプリのオープン率を向上させるのに役立ちます。
このガイドでは、MoEngage Live Activitiesを使用して、マーケティング施策のための豊かでリアルタイムの体験を作成、管理、分析する方法について説明します。
.
.
MoEngage ライブ活動は次のデバイスでサポートされています：
- iOS
- iPad OS
- Watch OS
| library_add_check |
前提条件
|
ユースケース
MoEngage ライブ活動は、さまざまな革新的なリアルタイムマーケティングおよびエンゲージメントシナリオを可能にします。
- スポーツとライブイベント : ライブマッチのスコアを提供したり、コンサート中の逐次更新を行ったり、マラソン参加者のリアルタイムの進捗を表示したりできます。
- 旅行とホスピタリティ : ユーザーにライブフライト追跡情報、即時ゲート変更アラート、またはタイムリーな搭乗アナウンスで情報を提供しましょう。
- ニュースとメディア : 発生した際の速報ニュースの見出しをストリーミングしたり、重要な進行中のイベントからのライブ更新を提供します。
- ゲーム : ライブゲーム統計、現在のトーナメント進行状況、またはゲーム内イベントのタイマーを表示することで、ゲーム体験を向上させます。
ライブアクティビティの仕組み
ライブ活動は、スポーツの試合などの進行中のイベントからの動的な更新を表示するリアルタイム機能です。システムはイベントベースの通知を提供し、ユーザーがロック画面や通知センターから直接試合の進行状況を追跡できるようにします。
ユーザーインタラクションとUI
- オプトイン : ユーザーがアプリ内でアクションを実行したとき（例えば、 フォロー をタップする）にライブアクティビティが開始されることがあります。ただし、ほとんどの放送ライブアクティビティは、サーバー呼び出しを通じてリモートで開始されます。
- 表示 : アクティビティはロック画面および ダイナミックアイランド に表示されます。ダイナミックアイランドを長押しすると、ビューが拡大します。
- UI : インターフェースはカスタマイズ可能で、テキスト、画像、進捗インジケーターがリアルタイムで更新されます。
権限
ライブ活動にはプッシュ通知とは別の権限があります。この権限は、ユーザーがアプリをインストールする際にデフォルトでオンになります。
iOSは、特にアクションボタンを持つライブアクティビティが初めて表示されるときに、ライブアクティビティが関連性を保っているかどうかを定期的にチェックします。そのような場合、ユーザーはそれらをオフにするオプションを見ることができます。
エンドユーザーは、この設定を管理するために次の手順を実行する必要があります：
- 設定 をデバイスで開きます。
- 下にスクロールして [App Name] を選択してください。
- タップして ライブアクティビティ を選択します。
- 必要に応じて設定をオンまたはオフにしてください。
この設定を調整しても、他の通知設定には影響しません。
例
シナリオ:
- 設定されたライブアクティビティ : 試合の期間中にリアルタイムのスコアとステータスの更新が表示されます。
- 評価 : システムは試合の進行状況とユーザーのインタラクションに基づいてライブアップデートを送信します。ユーザーがライブアクティビティを閉じると、そのユーザーにはそれ以降のアップデートは表示されません。
| 時間 | 試合状況 | ユーザーインタラクションシナリオ | マーケターのアクション | キャンペーンパフォーマンスステータス | ライブアクティビティユーザーのビュー |
|---|---|---|---|---|---|
| 7:00 午後 | 試合が始まりました | ユーザーAとユーザーBは最初から視聴を開始します | マーケターは、試合開始時にアクティブユーザーのためにMoEngage ライブ活動開始 APIをトリガーします。 | ユーザーAとユーザーBのためにライブアクティビティが開始されました | ライブアクティビティが開始されました |
| 7:30 午後 | ゴールが決まった | 該当なし | マーケターは、更新されたスコアを使用して MoEngage ライブアクティビティの更新 API 経由で目標の更新をトリガーします。 | ユーザーAとユーザーBのライブアクティビティが続いています | 目標の更新がすべてのユーザーに表示されました |
| 7:45 午後 | 進行中の試合 | ユーザーCが視聴を開始します | アプリはセッションが開始されると、ユーザーCのためにMoEngage ライブ活動開始 APIをトリガーします。 | ユーザーCのライブアクティビティが開始されました | ユーザーCのライブアクティビティが開始されました |
| 8:00 午後 | ハーフタイムブレイク | ユーザーBはライブアクティビティを.却下するします | MoEngageはアクティブユーザー向けにライブアクティビティを継続しています。 | ユーザーAとユーザーCのライブアクティビティは継続中です | ユーザーAとユーザーCのために表示されたハーフタイムアップデート |
| 8:45 午後 | 試合終了 | 残りのライブアクティビティが終了します | マーケターは、MoEngage ライブアクティビティの終了 APIを介してMoEngage ライブアクティビティの終了イベントをトリガーします。 | ユーザーAとユーザーCのライブアクティビティが終了しました | 最終試合のスコアが表示されました |
MoEngageライブアクティビティの使用手順
このセクションでは、iOSブロードキャストユースケースのためにMoEngage ライブ活動を設定し、活用する方法について詳しく説明します。マーケティング担当者は、実装中に開発チームと効果的に協力し、成功するリアルタイムエンゲージメント戦略を計画するために、これらのステップを理解する必要があります。
ステップ 1: ライブアクティビティ登録と PTS トークン管理 (iOS アプリ開発者タスク)
アプリケーション開発チームは、最初にライブアクティビティを設定する必要があります。マーケターは、チームとの効果的なコラボレーションを促進するために、これらの技術的仕様を包括的に理解する必要があります。
-
ライブアクティビティトークントラッキングを有効にする
:
アプリ開発者は、 プッシュトゥスタート（PTS）トークンのトラッキングを有効にする 必要があります。これらのトークンは、APIリクエストを通じてライブアクティビティを開始するために基本的です。 -
トークン登録方法を選択
:
開発者は、PTSトークンの登録と管理のために2つのオプションがあります:- MoEngage SDKがPTSトークンの登録と更新を自動的に処理することを許可します。
- 自己管理のPTSトークン登録および管理プロセスを実装し、生成されたPTSトークンをMoEngage SDKに渡します。
-
ウィジェット属性タイプの定義
:
アプリが提供する各異なるライブアクティビティウィジェット（例：football-match-scores、flight-status-tracker、flash-sale-countdown）に対して、開発者は一意の属性タイプを割り当てる必要があります。これをAPIリクエストで使用して、意図したウィジェットを持つライブアクティビティを開始できます。
| 情報 |
情報
|
ステップ 2: API を介してライブアクティビティを送信する (開発者タスク)
アプリ側の設定が正常に実装されたことで、バックエンド開発チームは、MoEngage ライブアクティビティ APIを活用してユーザーにリアルタイムの更新を送信することができるようになりました。
-
キャンペーンを作成する
:
キャンペーンAPI を使用してキャンペーンを作成し、オーディエンス、コンバージョン目標などを定義します。ライブアクティビティがAPNSで正常に作成されると、レスポンスにチャネルIDが返されます。このチャネルIDを使用して、このオーディエンスに含まれないデバイスのローカルでライブアクティビティを開始できます。 -
ライブアクティビティを開始する：
あなたの開発者は、指定されたオーディエンスセグメント内のすべての対象iOSデバイスのために、MoEngageにAPIリクエストを送信してライブアクティビティを開始できます。このリクエストでは、ターゲット属性タイプ（ウィジェット識別子）、静的コンテンツ、初期の動的コンテンツのセットを指定する必要があります。詳細については、 こちら を参照してください。 -
進行中のライブアクティビティを更新する:
To update an active Live Activity, your developers can send an API request with the event parameter set to update and the corresponding broadcast live activity ID. This request must contain the new dynamic content. The update is delivered to all devices where the Live Activity is enabled, including those that may have started it after the initial broadcast. For more information, refer -
ライブアクティビティを終了する:
ライブアクティビティを停止するには、開発者がイベントパラメータを使用してAPIリクエストを送信できます。 終了 と共に broadcast_live_activity_id 。ライブアクティビティは、指定された終了日を迎えると自動的に終了します。詳細については、参照してください。 ここ
ステップ3：アプリからライブアクティビティを管理する（アプリ開発者とユーザーのインタラクション）
API駆動の管理に加えて、アプリはユーザーにデバイス上のライブアクティビティを直接制御する機能を提供できます。
-
アプリから開始:
開発者は、ユーザーがライブアクティビティをシームレスに開始できるように、アプリケーション内の機能を実装できます。
アプリケーションは、正確にアクティビティを開始し、正しいチャンネルID（ステップ2の応答から取得）、コンテンツ、および識別子を提供する必要があります。
アプリケーション内でライブアクティビティが正常に開始されると、a デバイスでライブアクティビティが開始されました イベントがMoEngageプラットフォームに記録されます。 -
アプリから退会する:
ユーザーは、アプリから直接進行中または古くなったライブアクティビティを解消できます。この解雇は、即時または後の時間にスケジュールするように設定できます。 -
デバイスのエラーハンドリング:
デバイスでライブアクティビティの開始を試みた際に失敗した場合、MoEngage SDKは問題を診断するのに役立つローカライズされたエラーメッセージを生成できます。
ステップ 4: MoEngage UI におけるライブアクティビティパフォーマンスの分析
マーケターとして、MoEngage UIでMoEngage ライブ活動キャンペーンのパフォーマンスを効果的に追跡し、分析することができます。
-
キャンペーン分析にアクセスする:
MoEngage UI内で、正常に開始されたライブ活動をブロードキャストするはキャンペーンとして一覧表示されます。 -
キャンペーンのステータスを表示:
Live Activity campaigns are displayed with the following statuses:- : キャンペーンは、作成時から定義された終了時間または解任まで現在実行中であることを示します。
-
: ライブアクティビティが終了したことを示します。これは、終了時間に達した場合、API/appを介して明示的に終了された場合、またはタイムアウトした場合です。
情報 情報
MoEngage UIからアクティブなライブアクティビティキャンペーンを手動で停止または一時停止することはできません。すべての管理アクション（更新やアクティビティの終了など）は、APIを介してプログラム的に、またはアプリ自体から実行されます。
-
キャンペーンの詳細を確認する:
The campaign details view provides insights consistent with other MoEngage engagement campaigns. You can access the following information:- : ライブアクティビティの基本情報と設定。
- : 申請リクエストとその後の更新のログ。
- : APIリクエストに基づいて、ライブアクティビティの開始または終了が予定されている詳細。
- : キャンペーンのために定義した任意のコンバージョン目標に対するパフォーマンス。
- : Live Activityの一意の識別子であり、APIリクエストからの他の恒久的な詳細を含みます。
-
主要業績指標を監視する
The analytics section of the dashboard presents vital performance statistics for your Live Activity campaigns, including:- : ライブアクティビティを開始するために行われたリクエストの総数。
- : APNSによって配信のために正常に受け入れられたリクエストの数。
- : 成功したライブアクティビティの開始回数。
- : APNSエラーまたはその他の内部問題により失敗したリクエストの数。
- : アプリを開いた結果としてのライブアクティビティに対するユーザーのインタラクションを示す、合計およびユニーククリック。
- : ライブアクティビティを受け取ったユーザーに帰属する、標準プッシュキャンペーンと同様に追跡される合計およびユニークコンバージョン。
-
配達とエラーの分析
You can gain deeper insights into campaign performance using widgets such as:- : 配信フローを視覚化し、標準的なプッシュ通知ファunnelに似ています。
- : イニシエーション失敗の理由を詳述しており、プッシュエラーの内訳と比較可能です。
- : キャンペーンからのクリックイベントの内訳を、ウィジェットIDとクリックIDでグループ化して提供します。
-
アーカイブキャンペーン
ライブアクティビティキャンペーンが完了した後、アクティブなキャンペーンリストを整理するためにアーカイブできます。
FAQs
エンドユーザーは、MoEngageを通じて送信されたライブアクティビティを表示するために、デバイスにiOS 18以上のバージョンをインストールしている必要があります。
いいえ、これらのアクションはMoEngage UIでは利用できません。ライブアクティビティの開始、更新、および終了は、バックエンドシステムによって行われるAPIコールまたはユーザーまたはアプリのロジックから直接行われるモバイルアプリケーションを介してプログラム的に管理されます。MoEngageのUIは、主にあなたのライブアクティビティキャンペーンの分析とパフォーマンスを表示するためのものです。
MoEngageは、ライブアクティビティウィジェット自体を構築するためのアウトオブボックスのテンプレートやUIサポートを提供していません。ウィジェットUIの設計と実装は、アプリ開発者が担当する必要があります。
現在のバージョンでは、ライブアクティビティに対してA/Bテストはサポートされていません。これも、ロケール、グローバルコントロールグループ、キャンペーンコントロールグループ、頻度制限（FC）、おやすみモード（DND）、およびSherpa AIベースの最適化などの他の高度な機能に適用されます。
あなたのアプリ開発者は、MoEngage SDKにPTSトークンの登録と管理を自動的に行わせるか、自分たちでこのプロセスを処理し、その後トークンをSDKに渡すかのいずれかを選択できます。PTSトークンは、その後、デバイス属性としてMoEngageによって追跡されます。
MoEngageは、次のようなライブアクティビティのためのいくつかの重要なイベントを追跡します: ライブアクティビティが送信されました （アクティビティがAPNSに正常に送信されたときにトリガーされます）、 デバイスでライブアクティビティが開始されました （アプリがライブアクティビティを開始したときにトリガーされます）、および 通知がクリックされました iOS （ライブアクティビティとのユーザーインタラクションがアプリを開く結果となる場合）。
PTSトークンを使用して開始されたライブアクティビティに対して、 通知を受信しました または ライブアクティビティを受信しました イベントは、信頼性のある生成ができません。これは、特定のiOSシステムの制限によるもので、以下が含まれます：ライブアクティビティ拡張からのネットワークアクセスが許可されていないこと、ライブアクティビティ拡張に対して共有コンテナの書き込みアクセスが提供されていないこと、PTSの開始時にiOSシステムからメインアプリへの直接コールバックがないこと（コールバックはAppleのアクティビティキットフレームワークにのみ行われます）。
有効期限は、システムがあなたのアクティビティのコンテンツを古くなったとマークする時刻です。到達すると、UIはグレーアウトしたテキストや「更新が必要です」といったメッセージのような古い状態に変更されることがあります。アクティビティは引き続き表示され、アクティブですが、情報がもはや最新ではない可能性があることを示します。
解雇日は、オペレーティングシステムがロック画面と ダイナミックアイランド からライブアクティビティを自動的に削除するために設定する時間です。ライブアクティビティは、次の条件でユーザーの画面から削除されます:
- 彼らはそれをスワイプしてライブアクティビティを削除します。
- 解雇日に達すると、システムはデフォルトでライブアクティビティが終了してから4時間後、またはライブアクティビティが開始してから12時間後にそれを解消します。
有効期限は、古いコンテンツを示すためにUIの変更を引き起こしますが、解雇日はアクティビティを完全に削除します。有効期限はアクティビティを表示可能なままにし、異なる外観にしますが、解雇日はそれを終了させ、画面から削除します。
ライブアクティビティは合計12時間実行されます。アクティブな状態での更新は最大8時間、更新なしでの終了後は最大4時間です。その後、システムが自動的にそれを削除します。
次のステップ
- SDK統合ガイドおよびライブアクティビティサポートに関する更新については、 MoEngage SDK ドキュメント を参照してください。
- APIガイドについては、 ライブアクティビティの放送APIドキュメント を参照してください。